Skip to content

Commit

Permalink
Merge 04b83c2 into a6d3f2b
Browse files Browse the repository at this point in the history
  • Loading branch information
artragis committed Feb 25, 2016
2 parents a6d3f2b + 04b83c2 commit ecb75e7
Show file tree
Hide file tree
Showing 129 changed files with 1,395 additions and 1,340 deletions.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Expand Up @@ -48,7 +48,7 @@ Tous les détails sur le workflow se trouvent [sur la page dédiée](http://zds-
| Nouvelle Fonctionnalité ? | [oui|non]
| Tickets (_issues_) concernés | [Liste de tickets séparés par des virgules]
```
* Ajoutez des notes de QA (Quality Assurance). Ces notes doivent permettent à un testeur de comprendre ce que vous avez modifié, ce qu'il faut tester en priorité et les pièges auxquels il doit s'attendre et donc sur lesquels porter une attention particulière. Précisez tout particulièrement s'il est nécessaire d'effectuer une action de gestion préalable, comme `python manage.py migrate`, `python manage.py loaddata fixture/*.yaml` ou `npm run gulp -- build`.
* Ajoutez des notes de QA (Quality Assurance). Ces notes doivent permettent à un testeur de comprendre ce que vous avez modifié, ce qu'il faut tester en priorité et les pièges auxquels il doit s'attendre et donc sur lesquels porter une attention particulière. Précisez tout particulièrement s'il est nécessaire d'effectuer une action de gestion préalable, comme `python manage.py migrate --fake-initial`, `python manage.py loaddata fixture/*.yaml` ou `npm run gulp -- build`.

## Les commits
* Pour les commits, nous suivons le même ordre d'idée des standards Git, à savoir :
Expand Down
4 changes: 2 additions & 2 deletions LICENSE
@@ -1,5 +1,5 @@
Zeste de Savoir
Copyright (c) 2014-2015 Zeste de Savoir
Copyright (c) 2014-2016 Zeste de Savoir

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Expand All @@ -12,4 +12,4 @@
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
along with this program. If not, see <http://www.gnu.org/licenses/>.
2 changes: 1 addition & 1 deletion README.md
Expand Up @@ -48,7 +48,7 @@ Après avoir mis à jour votre dépôt, vous devez exécuter les commandes suiva

```console
pip install --upgrade -r requirements.txt -r requirements-dev.txt
python manage.py migrate
python manage.py migrate --fake-initial
```


Expand Down
8 changes: 2 additions & 6 deletions assets/scss/components/_topic-message.scss
Expand Up @@ -75,15 +75,10 @@
color: #424242;
height: 25px;
line-height: 26px;
width: 28px;
width: 58px;
color: #777;
transition: all $transition-duration ease;

&:first-child {
border-right: 0;
width: 29px;
}

&:hover,
&:focus {
border-bottom-width: 1px;
Expand All @@ -96,6 +91,7 @@
}
&.negative {
color: #c0392b;
font-weight: bold;
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion doc/source/back-end-code/arborescence-back.rst
Expand Up @@ -106,7 +106,7 @@ Cela permettra aux autres développeurs de répercuter les modifications en util

.. sourcecode:: bash

python manage.py migrate
python manage.py migrate --fake-initial


API
Expand Down
8 changes: 7 additions & 1 deletion doc/source/back-end-code/forum.rst
Expand Up @@ -13,8 +13,14 @@ Modèles (``models.py``)
.. automodule:: zds.forum.models
:members:

Les managers (``managers.py``)
==============================

.. automodule:: zds.forum.managers
:members:

Vues (``views.py``)
===================

.. automodule:: zds.forum.views
:members:
:members:
9 changes: 8 additions & 1 deletion doc/source/back-end-code/tutorialv2.rst
Expand Up @@ -22,6 +22,12 @@ Modèles "versionnés" (``models_versioned.py``)
.. automodule:: zds.tutorialv2.models.models_versioned
:members:

Les managers (``managers.py``)
==============================

.. automodule:: zds.tutorialv2.managers
:members:

Vues (``views/``)
=================

Expand Down Expand Up @@ -59,11 +65,12 @@ Les forumulaires (``forms.py``)
Les utilitaires (``utils.py``)
==============================


.. automodule:: zds.tutorialv2.utils
:members:

Les utilitaires de publication (``publication_utils.py``)
=========================================================

.. automodule:: zds.tutorialv2.publication_utils.py
:members:
:members:
10 changes: 10 additions & 0 deletions doc/source/back-end/contents.rst
Expand Up @@ -177,6 +177,16 @@ une contrainte sur la taille maximum d'un nom de fichier sur les différents sys
*slug*, pour des raisons de stockage (voir plus bas). Il ne faut pas
oublier la contrainte d'unicité à l'intérieur d'un conteneur.

.. attention::

Suite à un changement majeur dans la librairie ``python-slugify``, une différence peu apparaitre dans le *slug*
généré à partir de titres contenant des espaces. Dès lors, pour des raisons de rétro-compatibilités, c'est la version
1.1.4 de cette librairie qui est utilisée par ZdS. Par ailleurs, la commande ``python manage.py adjust_slugs`` a été
créée pour réparer les éventuels dommages, en détectant les titres posant potentielement des problèmes et en tentant
de les faire correspondre à nouveau à leur contrepartie dans le système de fichier.

`Plus d'information ici <https://github.com/zestedesavoir/zds-site/issues/3383#issuecomment-187282828>`_.

Cycle de vie des contenus
=========================

Expand Down
2 changes: 1 addition & 1 deletion doc/source/conf.py
Expand Up @@ -64,7 +64,7 @@

# General information about the project.
project = u'Zeste de Savoir'
copyright = u'2015, zestedesavoir'
copyright = u'2016, zestedesavoir'

# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
Expand Down
2 changes: 1 addition & 1 deletion doc/source/front-end/elements-specifiques-au-site.rst
Expand Up @@ -85,7 +85,7 @@ API Javascript pour manipuler les modales

Il est possible de créer des modales en Javascript. Exemple:

.. sourcecore:: javascript
.. sourcecode:: javascript

var m = new Modal({
title: "Titre de la modale",
Expand Down
2 changes: 1 addition & 1 deletion doc/source/index.rst
Expand Up @@ -2,7 +2,7 @@
Documentation de Zeste De Savoir
================================

Zeste de Savoir est un site internet communautaire codé à l'aide du framework Django 1.7 et de Python 2.7
Zeste de Savoir est un site internet communautaire codé à l'aide du framework Django 1.8 et de Python 2.7

`Voir l'instance en ligne <https://zestedesavoir.com>`_

Expand Down
68 changes: 23 additions & 45 deletions doc/source/install/frontend-install.rst
Expand Up @@ -8,14 +8,16 @@ Vous voulez nous aider au développement du frontend ? Installez Node.js et npm
Installation de Node.js et npm
==============================

Zeste de Savoir utilise actuellement la v4 de Node.JS.

Windows
-------

.. Attention::

Cette partie de la documentation n'est probablement pas à jour faute de contributeur utilisant Windows. Il se peut que l'installation fonctionne correctement, partiellement ou pas du tout. Bref, en cas de problème n'hésitez pas à venir demander de l'aide sur le `forum des Devs' de Zeste de Savoir <https://zestedesavoir.com/forums/communaute/dev-zone/>`_ !

Node.js propose un installeur (*.msi*) pour Windows, disponible à `cette adresse <http://nodejs.org/download/>`_. Choisissez *Windows Installer*, avec l'architecture adéquate, et installez Node.js en ouvrant le fichier téléchargé.
Node.js propose un installeur (*.msi*) pour Windows, disponible à `cette adresse <https://nodejs.org/en/download/>`_. Choisissez *Windows Installer*, avec l'architecture adéquate, et installez Node.js en ouvrant le fichier téléchargé.

Vérifiez de posséder la version 2.5.0 de npm (et non la version 1.4.X que peut installer l'installeur), pour connaitre votre version : ``npm -v``. Pour mettre à jour npm, vous avez `trois possibilités <https://github.com/npm/npm/wiki/Troubleshooting#upgrading-on-windows)>`_, l'une d'elle est de faire ``npm install npm`` dans le dossier ``C:\Program Files (x86)\nodejs``.

Expand All @@ -35,86 +37,62 @@ Veillez à respecter `ces conditions <https://github.com/TooTallNate/node-gyp#in
Mac OS X
--------

Node.js propose un installeur (*.pkg*) pour Mac OS X, disponible à `cette adresse <http://nodejs.org/download/>`_. Choisissez *Mac OS X Installer*, et installez Node.js en ouvrant le fichier téléchargé.
Node.js propose un installeur (*.pkg*) pour Mac OS X, disponible à `cette adresse <https://nodejs.org/en/download/>`_. Choisissez *Mac OS X Installer*, et installez Node.js en ouvrant le fichier téléchargé.

Linux
-----

Ubuntu
~~~~~~

L'installation peut se faire simplement via ``apt-get`` :
Pour être sûr d'avoir la dernière version de Node.JS, il faut passer par les dépôts de la Fondation Node.JS. Pour cela, elle met à disposition un script (en fonction de votre *package manager*) qu'il suffit de lancer. S'il n'y a pas d'instructions pour votre distribution sur cette page, il y en a sûrement dans `la documentation officielle (en anglais) <https://nodejs.org/en/download/package-manager/>`_.

.. sourcecode:: bash
Si vous ne voulez pas utiliser cette méthode, `des fichiers binaires ainsi que le code source sont disponibles <https://nodejs.org/en/download/>`_.

sudo apt-get install nodejs npm nodejs-legacy
Debian et ses dérivés (tels que Ubuntu, Linux Mint)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Mais il est possible d'avoir une version un peu plus récente avec :
Comme indiqué `ici <https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions>`_, il faut lancer ces commandes :

.. sourcecode:: bash

sudo add-apt-repository ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get install nodejs

Certaines dépendances utilisent ``node`` au lieu de ``nodejs``, pour y remédier (pas besoin sous Fedora !) :

.. sourcecode:: bash

sudo ln -s /usr/bin/nodejs /usr/bin/node

Debian
~~~~~~

Une version récente de Node.js se trouve dans les dépôts *wheezy-backport*, *jessie* et *sid*. Sur ces versions de Debian, l'installation peut se faire de cette manière :

.. sourcecode:: bash

sudo apt-get install nodejs
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / CentOS / RHEL
~~~~~~~~~~~~~~~~~~~~~~

Il vous faut tout simplement faire :
Comme indiqué `ici <https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora>`_, il faut lancer ces commandes :

.. sourcecode:: bash

sudo dnf install nodejs
curl --silent --location https://rpm.nodesource.com/setup_4.x | bash -
# Puis, en root
yum -y install nodejs

Arch Linux
~~~~~~~~~~

Il faut simplement lancer cette commande :
Comme indiqué `ici <https://nodejs.org/en/download/package-manager/#arch-linux>`_, il faut lancer cette commande :

.. sourcecode:: bash

pacman -S nodejs

FreeBSD / OpenBSD
-----------------
pacman -S nodejs npm

Une installation via ``pkg`` devrait suffire :

.. sourcecode:: bash

pkg install node
Il existe aussi `une documentation relative à Node.JS spécialement pour Arch Linux <https://wiki.archlinux.org/index.php/Node.js>`_.

-----

*Les instructions pour installer Node.js sur les distributions CentOS, RHEL, FreeBSD et OpenBSD sont issues du lien juste en dessous et n'ont pas été testées.*

Les **instructions détaillées** pour toutes les distributions se trouvent dans la `documentation officielle (en anglais) <https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager>`_.
Vérifier que les bonnes versions sont installées
------------------------------------------------

Pour vérifier que Node.js et npm sont installés (et que vous avez les bonnes versions) :

.. sourcecode:: bash

node -v
v0.10.26
v4.2.6
npm -v
2.1.7
2.14.12

**Vous devez avoir une version de Node.js > 0.10.x et de npm > 2.x.x.** Si votre version de npm est 1.x.x, vous devez le mettre à jour (voir juste en dessous).
**Vous devez avoir une version de Node.js v4.x et de npm 2.x.x.** Si votre version de npm est 1.x.x, vous devez le mettre à jour (voir juste en dessous).

Mise à jour de Node.js et npm
-----------------------------
Expand Down
2 changes: 1 addition & 1 deletion doc/source/utils/git-pre-hook.rst
Expand Up @@ -18,7 +18,7 @@ restera propre et lisible au cours du temps !

#!/bin/sh

flake8 --exclude=migrations,urls.py,settings.py --max-line-length=120 zds
flake8 --exclude=migrations,settings.py --max-line-length=120 zds

# Store tests result
RESULT=$?
Expand Down
9 changes: 9 additions & 0 deletions fixtures/topics.yaml
Expand Up @@ -6,6 +6,7 @@
forum: 10
author: 3
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
last_message: 1
- model: forum.Topic
pk: 2
Expand All @@ -15,6 +16,7 @@
forum: 3
author: 3
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
last_message: 2
- model: forum.Topic
pk: 3
Expand All @@ -23,6 +25,7 @@
forum: 2
author: 3
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
last_message: 4
- model: forum.Topic
pk: 4
Expand All @@ -31,6 +34,7 @@
forum: 12
author: 3
pubdate: 2014-01-05T18:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
last_message: 5
- model: forum.Post
pk: 1
Expand All @@ -45,6 +49,7 @@
like: 42
dislike: 0
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
position: 1
- model: forum.Post
pk: 2
Expand All @@ -59,6 +64,7 @@
like: 3
dislike: 12
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
position: 1
- model: forum.Post
pk: 3
Expand All @@ -73,6 +79,7 @@
like: 42
dislike: 0
pubdate: 2013-12-21T13:22:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
position: 2
- model: forum.Post
pk: 4
Expand All @@ -87,6 +94,7 @@
like: 0
dislike: 0
pubdate: 2013-12-21T13:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
position: 1
- model: forum.Post
pk: 5
Expand Down Expand Up @@ -267,4 +275,5 @@
like: 1337
dislike: 0
pubdate: 2014-01-05T18:20:30+00:00
update_index_date: 2013-12-21T13:20:30+00:00
position: 1
2 changes: 1 addition & 1 deletion package.json
@@ -1,7 +1,7 @@
{
"name": "zds-site",
"version": "0.2.0",
"description": "Site internet communautaire codé à l'aide du Framework Django 1.7",
"description": "Site internet communautaire codé à l'aide du Framework Django 1.8",
"directories": {
"doc": "doc"
},
Expand Down
7 changes: 4 additions & 3 deletions requirements-dev.txt
@@ -1,8 +1,9 @@
coverage==4.0.3
PyYAML==3.11
django-debug-toolbar==1.3.0
django-debug-toolbar==1.4
flake8==2.4.0
autopep8==1.1.1
sphinx==1.3.1
sphinx_rtd_theme==0.1.8
sphinx==1.2.3
sphinx_rtd_theme==0.1.6
fake-factory==0.5.0
mock

0 comments on commit ecb75e7

Please sign in to comment.