README.md 6.66 KB
Newer Older
Robin Caramaschi's avatar
Robin Caramaschi committed
1
![logo](https://demo-pretty-noemie.frama.site/public/img/logo-final.svg)
Robin Caramaschi's avatar
Robin Caramaschi committed
2

Robin Caramaschi's avatar
Robin Caramaschi committed
3
# NoemieCms
spf's avatar
spf committed
4
![gif de démonstration de NoemieCms](https://framablog.org/wp-content/uploads/2018/02/pages-framasite-theme-light.gif)
Robin Caramaschi's avatar
Robin Caramaschi committed
5

Programmateur01's avatar
Programmateur01 committed
6
CMS offrant à ses utilisateurs une solution ergonomique, simple et élégante pour construire en un rien de temps des sites vitrines responsives au design moderne.
Robin Caramaschi's avatar
Robin Caramaschi committed
7

Robin Caramaschi's avatar
Robin Caramaschi committed
8

spf's avatar
spf committed
9
La construction de votre site consistera à agencer à votre convenance des modules variés, d'éditer leurs contenus, et de personnaliser votre site en choisissant les polices de caractère, la mise en forme du texte, ainsi que les couleurs d'affichage
Robin Caramaschi's avatar
Robin Caramaschi committed
10

Robin Caramaschi's avatar
Robin Caramaschi committed
11

Robin Caramaschi's avatar
Robin Caramaschi committed
12
13
----------

Robin Caramaschi's avatar
Robin Caramaschi committed
14
15
## Essayez la DEMO !

Robin Caramaschi's avatar
Robin Caramaschi committed
16
17

## **[ https://demo-pretty-noemie.frama.site](https://demo-pretty-noemie.frama.site/login)**
spf's avatar
spf committed
18
Connectez-vous avec :
Robin Caramaschi's avatar
Robin Caramaschi committed
19

Robin Caramaschi's avatar
Robin Caramaschi committed
20
21
    login : pretty
    mdp : 12345678
Robin Caramaschi's avatar
Robin Caramaschi committed
22

spf's avatar
spf committed
23
(Lorsque plusieurs personnes sont connectées en même temps au même site avec le même compte, NoemieCms peut estimer qu'il y a usurpation et renvoie des erreurs (`CSRF`)
Robin Caramaschi's avatar
Robin Caramaschi committed
24
25
26
27
28
29
30
31

## Grâce à ses modules variés, il conviendra parfaitement à de nombreuses utilisations :

 - Réalisation d'un CV en ligne
 - Portfolio d'artiste ou de créateur
 - Vitrine de votre association
 - Présentation de votre travail d'artisan
 - Page d'accueil d'un festival
Robin Caramaschi's avatar
Robin Caramaschi committed
32
 - Et tout ce que votre créativité en fera
Programmateur01's avatar
Programmateur01 committed
33

34
35
36

## Utilisé par Framasoft pour construire les Pages Framasite

37
Vous pouvez faire votre page Framasite, gratuitement et librement, là-bas :
Programmateur01's avatar
Programmateur01 committed
38

39
40
[https://frama.site/](https://frama.site/)

Robin Caramaschi's avatar
Robin Caramaschi committed
41
42
43

----------

44
## Soutenir
spf's avatar
spf committed
45
Pour soutenir le créateur de ce projet libre, vous pouvez faire un don sur Patreon :
46

47
[https://www.patreon.com/robinbanquo](https://www.patreon.com/robinbanquo)
Robin Caramaschi's avatar
Robin Caramaschi committed
48

Robin Caramaschi's avatar
Robin Caramaschi committed
49

Programmateur01's avatar
Programmateur01 committed
50
----------
Robin Caramaschi's avatar
Robin Caramaschi committed
51
52
53

## Derniers ajouts

Robin Caramaschi's avatar
Robin Caramaschi committed
54
 - formulaire d'initialisation pour l'installation sous la forme d'un standalone sur un serveur perso
spf's avatar
spf committed
55
 - menu qui réapparaît lorsqu'on scroll vers le haut
Robin Caramaschi's avatar
Robin Caramaschi committed
56
 - petits bugs corrigés
Robin Caramaschi's avatar
Robin Caramaschi committed
57
58
 - resizer d'images
 - module agenda (iframe google agenda/framagenda)
spf's avatar
spf committed
59
 - retravail de la page d'accueil
Robin Caramaschi's avatar
Robin Caramaschi committed
60
61
62
 - bouton "haut de page"
 - liens des boutons qui s'ouvrent dans un nouvel onglet
 - petits débugs en tout genre
Robin Caramaschi's avatar
Robin Caramaschi committed
63
64
 - Module réseaux sociaux
 - Menu en version mobile
Robin Caramaschi's avatar
Robin Caramaschi committed
65
66
 - Module lecteur audio (soundcloud) pour les personnes souhaitant faire le site de leur groupe de musique
 - Module avec lecteur Vidéo et vidéo d'arrière plan
spf's avatar
spf committed
67
 - Module Code avec coloration syntaxique, pour réaliser des tutos
68
69
 - Redesign des fenêtres
 - Redesign de la fenêtre de choix de modules (grâce à la contribution d'un designer)
Robin Caramaschi's avatar
Robin Caramaschi committed
70
71


Programmateur01's avatar
Programmateur01 committed
72
## Lancer PrettyNoemie en local
Robin Caramaschi's avatar
Robin Caramaschi committed
73

Adrien's avatar
Adrien committed
74
75
**Pré-requis :**
- PHP (7 recommandé)
spf's avatar
spf committed
76
- `Composer` (sur votre système ou en installé dans votre dossier, [pour installer Composer, c'est ici](https://getcomposer.org/))
Adrien's avatar
Adrien committed
77

spf's avatar
spf committed
78
Téléchargez les fichiers en zip ou clonez le repository avec :
Robin Caramaschi's avatar
Robin Caramaschi committed
79

Robin Caramaschi's avatar
Robin Caramaschi committed
80
    git clone https://framagit.org/framasoft/PrettyNoemieCMS
Robin Caramaschi's avatar
Robin Caramaschi committed
81

spf's avatar
spf committed
82
Puis à l'intérieur du dossier, lancez la commande d'installation avec `Composer` :
Robin Caramaschi's avatar
Robin Caramaschi committed
83

Robin Caramaschi's avatar
Robin Caramaschi committed
84
    composer install
Robin Caramaschi's avatar
Robin Caramaschi committed
85

Programmateur01's avatar
Programmateur01 committed
86
Si la commande n'est pas reconnue, essayez : `php composer.phar installer`
Adrien's avatar
Adrien committed
87

spf's avatar
spf committed
88
**Développement seulement** : dans le fichier `app/config/config.ini` le paramètre `isMediaPathModified` doit être à ``""`` en développement (et à **true** en production).
Programmateur01's avatar
Programmateur01 committed
89
Vérifiez que vous avez bien :
Robin Caramaschi's avatar
Robin Caramaschi committed
90

Robin Caramaschi's avatar
Robin Caramaschi committed
91
92
93
94
    [globals]
    /autres options/
    /autres options/
    /autres options/
Robin Caramaschi's avatar
Robin Caramaschi committed
95
    isMediaPathModified =
Programmateur01's avatar
Programmateur01 committed
96

spf's avatar
spf committed
97
98
99
100
101
Lancez enfin le serveur local intégré à php (php7 voire un poil moins) avec :

    php -S localhost:8000


Valentine's avatar
Valentine committed
102
103
104
105
106
107
108
109
110
## Installer PrettyNoemie sur un serveur Nginx

Je pars du principe que vous utilisez Debian et la verison 7 de PHP-fpm

**Pré-requis :**
- PHP-fpm (7 recommandé)
- Nginx
- Composer (sur votre système ou en installé dans votre dossier, [pour installer Composer, c'est ici](https://getcomposer.org/))

Valentine's avatar
Valentine committed
111
**Déployer PrettyNoemie**
Valentine's avatar
Valentine committed
112
113
114

	cd /var/www/

spf's avatar
spf committed
115
Téléchargez les fichiers en zip ou clonez le repository avec :
Valentine's avatar
Valentine committed
116

117
118
    git clone https://framagit.org/framasoft/PrettyNoemieCMS VOTRESITE
    cd VOTRESITE
Valentine's avatar
Valentine committed
119

120
Puis à l'intérieur du dossier, lancez la commande d'installation avec Composer (voir [le site officiel](https://getcomposer.org/download/) pour l’installer) :
Valentine's avatar
Valentine committed
121
122
123

    composer install

124
Si la commande n'est pas reconnue, essayez : `php composer.phar install`.
Valentine's avatar
Valentine committed
125

126
Ensuite, il faut créer le dossier des données de votre site. Mettons que votre site sera joignable à l’adresse `pnc.example.org` :
Valentine's avatar
Valentine committed
127

128
129
    cd sites/
    cp -a framasite pnc.example.org
spf's avatar
spf committed
130

131
N’oubliez pas de changer le propriétaire des fichiers pour l’utilisateur du serveur web (`www-data` sur Debian) :
Valentine's avatar
Valentine committed
132

133
    chown -R www-data: /var/www/VOTRESITE
Valentine's avatar
Valentine committed
134

Valentine's avatar
Valentine committed
135
**Configurer Nginx pour PrettyNoemieCMS**
Valentine's avatar
Valentine committed
136
137
138
139

    cd /etc/nginx/sites-available
    nano VOTRESITE

spf's avatar
spf committed
140
Voici une configuration fonctionnelle, remplacer XXX par votre nom de domaine :
Valentine's avatar
Valentine committed
141
142

    server {
143
144
        listen 80 default_server;
        listen [::]:80 default_server;
Valentine's avatar
Valentine committed
145

146
        root /var/www/VOTRESITE;
Valentine's avatar
Valentine committed
147

148
149
        # Add index.php to the list if you are using PHP
        index index.php index.html index.htm;
spf's avatar
spf committed
150

151
        server_name XXX;
spf's avatar
spf committed
152

153
154
155
        location / {
            # First attempt to serve request as file, then
            # as directory, then fall back to displaying a 404.
Valentine's avatar
Valentine committed
156

157
158
            try_files $uri $uri/ /index.php?$query_string;
        }
Valentine's avatar
Valentine committed
159

160
161
162
163
164
165
166
        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            include fastcgi_params;
            fastcgi_pass unix:/run/php/php7.3-fpm.sock;
        }
    }
Valentine's avatar
Valentine committed
167

spf's avatar
spf committed
168
Il faut activer votre site dans Nginx :
Valentine's avatar
Valentine committed
169

170
    ln -s ../sites-available/VOTRESITE /etc/nginx/sites-enabled/VOTRESITE
Valentine's avatar
Valentine committed
171

172
**Recharger Nginx**
Valentine's avatar
Valentine committed
173

174
    nginx -t && nginx -s reload
Robin Caramaschi's avatar
Robin Caramaschi committed
175

Robin Caramaschi's avatar
Robin Caramaschi committed
176
## Contribuer
Robin Caramaschi's avatar
Robin Caramaschi committed
177

spf's avatar
spf committed
178
Les Merges requests sont les bienvenues, et le bug report et les suggestions sont très appréciés
Robin Caramaschi's avatar
Robin Caramaschi committed
179

spf's avatar
spf committed
180
Un chat de discussion publique est ouvert autour du projet pour venir discuter (y a pas forcement grand monde dessus, mais j'ai des notifications quand il y a des messages, donc n'hésitez pas)
Robin Caramaschi's avatar
Robin Caramaschi committed
181

Robin Caramaschi's avatar
Robin Caramaschi committed
182
[https://riot.im/app/#/room/!wPhaCatDceeQqOQqdM:matrix.org](https://riot.im/app/#/room/!wPhaCatDceeQqOQqdM:matrix.org)
Robin Caramaschi's avatar
Robin Caramaschi committed
183

spf's avatar
spf committed
184
Pour les bugs reports et autres discussions plus formelles autour du projet, merci d’ouvrir des [tickets sur Framagit](https://framagit.org/framasoft/PrettyNoemieCMS/issues).
185
186

Pour savoir comment faire, voici un tuto sur l'utilisation de git et Gitlab pour contribuer :
Robin Caramaschi's avatar
Robin Caramaschi committed
187

188
189
190
191
- [Gitbook (Framadoc) : Gitlab](https://docs.framasoft.org/fr/gitlab/)
- [L’aide sur Framagit](https://framagit.org/help)
- [L’aide de Gitlab.com](https://docs.gitlab.com/ee/README.html)
- [Contribuer à des projets open source (openclassrooms, pour Github)](https://openclassrooms.com/courses/gerer-son-code-avec-git-et-github/contribuer-a-des-projets-open-source)
Robin Caramaschi's avatar
Robin Caramaschi committed
192

Robin Caramaschi's avatar
Robin Caramaschi committed
193
194
195
196

----------


Robin Caramaschi's avatar
Robin Caramaschi committed
197
198
## Licence

Programmateur01's avatar
[TYPO]    
Programmateur01 committed
199
GNU AFFERO GENERAL PUBLIC LICENSE    Version 3, 19 November 2007