====== Trucs sur Hugo ======


[[http://gohugo.io | Hugo]] est un générateur de site statiques

Son manuel est : http://gohugo.io/getting-started/usage/

l'installation .. le mieux est encore : https://github.com/gohugoio/hugo/releases
===== Petit manuel en français et en construction =====
Principales commandes de Hugo :
  * **hugo new site votresite.com**
Elle permet de créer un nouveau site. Il vaut mieux être dans le répertoire de Hugo pour créer le site.

  * **hugo server --theme=votretheme**
Pour essayer sur http://localhost:1313 votre site avec le thème choisi . 
Les changements se feront en directe, ce qui permet de suivre vos modifications.
Il y a tout plein de thèmes sur http://themes.gohugo.io/).

  *  **hugo new /articles/votre-article.md**
Permet de créer un article appelé article.md dans le répertoire articles. 
Le nom n’a pas d’importance,
Il vaut mieux bien séparer les contenus photos,vidéos,texte,...Hugo donne la possibilité de créer des designs particuliers selon le type d’articles.
Les articles sont en général a mettre dans le répertoire /content. Et donc on peut les répartir dans /content/truc1 /content/machin2 etc. http://gohugo.io/content-management/organization/

Ils seront à faire en format Markdown ( .md)

==== Méthode ====
  * ouvrir un terminal dans le répertoire ou est installé le site,cf ci-dessus,  ex:/home/toto/hugosites/ 
  * d'un coté il faut lancer hugo par la commande : **hugo server**
    * et afficher la page avec le navigateur http://localhost:1313
  * de l'autre faire :  **remarkable content/la_page_a_modifier**
    * on ajuste la vue pour n'avoir que le code à gauche.
  * faire enregistrer après chaque modification pour voir le résultat

De cette façon , on peut à la fois modifier le code markdown et la voir complètement intégrées dans le site.

===== Outils à gogo =====
==== Une idée serait de permettre l'édition ====
 
  * sur la machine de l'auteur , et de permettre 
    * la maj des articles puis la refonte par hugo en local et le transfert sur le serveur (classique)
    * la maj en local , le tranfert , hugo étant sur le serveur , moins de truc a installer et gestion des themes par le serveur, .. plus pratique peut etre pour un novice sur un partageoir
  * directement sur le serveur par le navigateur

Éditeurs:
  * en local [[ https://remarkableapp.github.io | Remarkable ]]
  * [[http://pad.haroopress.com/user.html | haroopress ]]
  * plutot sur le serveur [[https://www.gitbook.com/ | gitbook ]]
  * http://www.qownnotes.org/installation

==== Gestionnaire de fichiers: ====

  * https://github.com/hacdias/filemanager , afin de déposer les fichiers , tester et mettre a jour un site
  * nexcloud possède un éditeur interne de fichier md, resterait à faire le script de maj hugo

les versions sont par la : https://github.com/filebrowser/filebrowser/releases

et la méthode :
  This is the fastest way to beginners to start using File Browser. Although, there are other ways to install it.
    Download File Browser and put it on your PATH.
    cd to the directory you want to browse in.
    Run filebrowser.
  Done! It will tell you the address in which File Browser is running. You only need to open it and use the      following credentials (you should change them!):
    Username: admin
    Password: admin
==== Conversions ====
Faire une archive d'un site static Hugo consultable par la suite
  - mettre dans le config .toml l'adresse du site en localhost (option)
  - faire le site avec hugo et lancer hugo server
  - recuperer le site en 'local' par 
    - wget -r http://localhost:1313
  - faire une archive
    - tar cvfz jolie_site_hugo.tgz localhost:1313

===== outils =====

<code>
#!/bin/bash
ddp#hugo-server
if ps -C hugo  ;then
	echo "deja en cours"
	echo "regardez http://localhost:1313"
	sleep 5
else
	cd /home/utilisateur/Documents/HUGO
	hugo server
fi


</code>

<code>
#hugo-publier 
#!/bin/bash
cd /home/utilisateur/Documents/HUGO
hugo
sleep 5
echo "repertoire public ok"
if zenity --question --text "publication sur 89.projetneu_f.cc ?"; then
        PASS=`zenity --password`
        echo ok
        cd public
        lftp projetneuf.cc --user "site-auloin" --password $PASS -e 'set net:timeout 10; mirror -R . /'

fi
</code>