Outils pour utilisateurs

Outils du site


web:hugo

Trucs sur Hugo

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
  • 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:

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

  1. mettre dans le config .toml l'adresse du site en localhost (option)
  2. faire le site avec hugo et lancer hugo server
  3. recuperer le site en 'local' par
  4. faire une archive
    1. tar cvfz jolie_site_hugo.tgz localhost:1313
web/hugo.txt · Dernière modification: 2018/07/06 14:49 par gepeto