Commit bd262131 authored by  JosephK's avatar JosephK

Structure Gitbook

parents
Pipeline #16310 passed with stages
in 1 minute and 51 seconds
_book
node_modules
\ No newline at end of file
image: hatsoftwares/gitbook:latest
pages:
script:
- gitbook init
- gitbook install
- git config user.name "Nobody"
- git config user.email "nobody@framasoft.org"
- gitbook build
- mv _book/ public/
artifacts:
paths:
- public
only:
- master
# Languages
* [English](en/)
* [Français](fr/)
\ No newline at end of file
[![](https://framagit.org/assets/favicon-075eba76312e8421991a0c1f89a89ee81678bcde72319dd3e8047e2a47cd3a42.ico)](https://framagit.org)
![English:](https://upload.wikimedia.org/wikipedia/commons/thumb/a/ae/Flag_of_the_United_Kingdom.svg/20px-Flag_of_the_United_Kingdom.svg.png) **Framasoft uses GitLab** for the development of its free softwares. Our Github repositories are only mirrors.
If you want to work with us, **fork us on [framagit.org](https://framagit.org)**. (no registration needed, you can sign in with your Github account)
![Français :](https://upload.wikimedia.org/wikipedia/commons/thumb/c/c3/Flag_of_France.svg/20px-Flag_of_France.svg.png) **Framasoft utilise GitLab** pour le développement de ses logiciels libres. Nos dépôts Github ne sont que des miroirs.
Si vous souhaitez travailler avec nous, **forkez-nous sur [framagit.org](https://framagit.org)**. (l'inscription n'est pas nécessaire, vous pouvez vous connecter avec votre compte Github)
* * *
Site de documentation et d'accueil (basée sur Gitbook) des contributeurs aux projets de Framasoft.
[participer.framasoft.org](https://participer.framasoft.org)
* * *
## Contribuer à la documentation
### Rédaction
Les fichiers sont rédigés avec [la syntaxe markdown](https://docs.framasoft.org/fr/mattermost/help/messaging/formatting-text.html)
mais Gitbook accepte aussi la syntaxe HTML.
Par contre, il n'est pas possible de mixer les 2 syntaxes dans un même bloc.
Si vous voulez ajouter des liens internes, il faut faire attention à pointer vers
les pages `.html` correspondantes au `.md` du dossier.
### Méthode de travail
https://framagit.org/spf/Tutos/blob/master/Git/translate.md
(voir si le tuto est adapaté pour la documentation)
1. Forker
2. Créer une branche
3. Faire les changements (commit)
4. Demander à intégrer les changements (merge request)
5. Discuter / rectifier
### Structure
Les documentations anglaise et française sont totalement indépendantes.
La documentation de chaque Framaprojet doit être enregistrée dans un dossier.
Dans ce dossier, créer un dossier `images` contenant les captures d'écran
et un fichier `README.md` qui contiendra la page d'accueil de présentation du projet
Pour ajouter ensuite le Framaprojet dans la colonne de gauche et sur la page d'accueil,
il faut éditer les fichiers `SUMMARY.md` et `README.md` (à la racine dans le dossier `fr`).
Dans `SUMMARY.md`, il n'est pas possible d'afficher une arborescence
de plus de 2 niveaux et les titres ne sont pas pris en compte
(ils ne sont laissés qu'à titre indicatif).
Chaque lien `.md` trouvé dans ce fichier sera pris en compte par Gitbook
pour créer le fichier `.html` correspondant.
Les fichiers qui ne s'y trouvent pas seront placé dans le dossier
comme de simples fichiers statiques (au même titre que les images)
## Créer une copie locale de la documentation
Pour avoir un aperçu du rendu du site il peut être souhaitable d'installer Gitbook localement.
### Installation de Gitbook
Installez NodeJS, NPM et le client Gitbook :
sudo apt-get install nodejs-legacy npm
sudo npm install gitbook-cli -g
### Générer la documentation
Clonez votre fork de la documentation
git clone https://framagit.org/<utilisateur>/framasoft/participer.git
Depuis le dossier `participer` procédez à l'installation des plugins requis
(la liste des plugins et leur configuration se trouve dans le fichiers `book.json`)
cd participer
gitbook init
gitbook install
gitbook serve --no-watch
Si tout s'est bien déroulé (la commande se termine par `Serving book on…`,
la copie du site peut être consultée sur :
http://localhost:4000/
L’option `--no-watch` permet d'éviter que chaque changement dans les
fichiers entraine un redémarrage automatique du serveur nodejs
ce qui peut être lourd à la longue.
Plus il y a de pages, plus le temps de chargement est long.
Il vaut mieux prendre le temps de finir les changements et redémarrer
le serveur manuellement quant on a fini.
Si vous disposez d'un serveur web en local, plutôt que de se servir du serveur
nodejs, vous pouvez aussi créer le site manuellement avec la commande
gitbook build
et copier le dossier `_book` où vous le voulez sur le serveur web.
\ No newline at end of file
# Summary
* [Introduction](README.md)
{
"plugins": [
"edit-link",
"toggle-chapters",
"page-toc"
],
"pluginsConfig": {
"edit-link": {
"base": "https://framagit.org/framasoft/participer/blob/master/",
"label": {
"en": "Edit This Page",
"fr": "Modifier cette page"
}
}
}
}
\ No newline at end of file
# Home
\ No newline at end of file
# Summary
* [Home](README.md)
{% extends template.self %}
{% block body %}
{{ super() }}
<script type="text/javascript">
/*var loc = window.location.href+'';
if (loc.indexOf('http://') > -1 && window.location.host.indexOf('framasoft.') > -1){
window.location.href = loc.replace('framasoft.frama.io/docs','docs.framasoft.org').replace('http://','https://');
}*/
var l$ = {
js: {
j$: 'noConflict',
video : true
},
mute: true,
footer: false
}
var script = document.createElement('script');
script.type = "text/javascript";
script.src="https://framasoft.org/nav/nav.js";
document.getElementsByTagName('head')[0].appendChild(script);
</script>
{% endblock %}
.book {
height: calc(100% - 42px);
}
.summary a,
.book-body .navigation {
text-decoration:none !important;
}
.book-summary ul.summary li.active > a,
.markdown-section a {
color: #0C5B7A;
}
.markdown-section .btn-block {
margin-bottom:30px;
}
.summary .divider {
visibility: hidden;
}
#book-search-input {
margin-bottom:0;
}
.chapter {
background-color:#eee;
border-bottom:1px solid #ddd;
}
.chapter ul {
padding-bottom:10px;
}
.chapter ul li{
background-color:#fff;
border:none
}
.chapter.active {
border-left: 4px solid #C0D481;
}
.chapter.active a {
margin-left:-4px;
}
.summary .chapter > a:before {
font-family: FontAwesome;
font-size: 1.2em;
}
.summary > .chapter:nth-child(1) a:before { content: "\f015"; }
.summary .chapter > a[href$="wisemapping/"]:before { content: "\f0e8"; }
.summary .chapter > a[href$="framadate/"]:before { content: "\f274"; }
.summary .chapter > a[href$="etherpad/"]:before { content: "\f036"; }
.summary .chapter > a[href$="ethercalc/"]:before { content: "\f00a"; }
.summary .chapter > a[href$="svgedit/"]:before { content: "\f1fc"; }
.summary .chapter > a[href$="ttrss/"]:before { content: "\f1ea"; }
.summary .chapter > a[href$="wallabag/"]:before { content: "\f0b1"; }
.summary .chapter > a[href$="diaspora/"]:before { content: "\f069"; }
.summary .chapter > a[href$="peertube/"]:before { content: "\f008"; }
.summary .chapter > a[href$="lstu/"]:before { content: "\f0c1"; }
.summary .chapter > a[href$="gitlab/"]:before { content: "\f1d3"; }
.summary .chapter > a[href$="lutim/"]:before { content: "\f03e"; }
.summary .chapter > a[href$="zerobin/"]:before { content: "\f0ea"; }
.summary .chapter > a[href$="searx/"]:before { content: "\f002"; }
.summary .chapter > a[href$="bicbucstriim/"]:before { content: "\f0f4"; }
.summary .chapter > a[href$="nextcloud/"]:before { content: "\f0ee"; }
.summary .chapter > a[href$="kanboard/"]:before { content: "\f0e4"; }
.summary .chapter > a[href$="lufi/"]:before { content: "\f1d8"; }
.summary .chapter > a[href$="umap/"]:before { content: "\f279"; }
.summary .chapter > a[href$="loomio/"]:before { content: "\f0a1"; }
.summary .chapter > a[href$="mattermost/"]:before { content: "\f0e6"; }
.summary .chapter > a[href$="framagenda/"]:before { content: "\f073"; }
.summary .chapter > a[href$="sympa/"]:before { content: "\f0c0"; }
.summary .chapter > a[href$="framaforms/"]:before { content: "\f0ca"; }
.summary .chapter > a[href$="turtl/"]:before { content: "\f249"; }
.summary .chapter > a[href$="jitsimeet/"]:before { content: "\f03d"; }
.summary .chapter > a[href$="minetest/"]:before { content: "\f1b2"; }
.summary .chapter > a[href$="scrumblr/"]:before { content: "\f247"; }
.summary .chapter > a[href$="shaarli/"]:before { content: "\f005"; }
.summary .chapter > a[href$="framaestro/"]:before { content: "\f0d0"; }
.summary .chapter > a[href$="strut/"]:before { content: "\f200"; }
.page-toc::before {
content:none;
}
.page-toc {
max-width: 42%;
margin-left: 10px;
}
# Accueil
\ No newline at end of file
# Summary
* [Accueil](README.md)
\ No newline at end of file
{% extends template.self %}
{% block body %}
{{ super() }}
<script type="text/javascript">
/*var loc = window.location.href+'';
if (loc.indexOf('http://') > -1 && window.location.host.indexOf('framasoft.') > -1){
window.location.href = loc.replace('framasoft.frama.io/docs','docs.framasoft.org').replace('http://','https://');
}*/
var l$ = {
js: {
j$: 'noConflict',
video : true
},
mute: true,
footer: false
}
var script = document.createElement('script');
script.type = "text/javascript";
script.src="https://framasoft.org/nav/nav.js";
document.getElementsByTagName('head')[0].appendChild(script);
</script>
{% endblock %}
.book {
height: calc(100% - 42px);
}
.summary a,
.book-body .navigation {
text-decoration:none !important;
}
.book-summary ul.summary li.active > a,
.markdown-section a {
color: #0C5B7A;
}
.markdown-section .btn-block {
margin-bottom:30px;
}
.summary .divider {
visibility: hidden;
}
#book-search-input {
margin-bottom:0;
}
.chapter {
background-color:#eee;
border-bottom:1px solid #ddd;
}
.chapter ul {
padding-bottom:10px;
}
.chapter ul li{
background-color:#fff;
border:none
}
.chapter.active {
border-left: 4px solid #C0D481;
}
.chapter.active a {
margin-left:-4px;
}
.summary .chapter > a:before {
font-family: FontAwesome;
font-size: 1.2em;
}
.summary > .chapter:nth-child(1) a:before { content: "\f015"; }
.summary .chapter > a[href$="wisemapping/"]:before { content: "\f0e8"; }
.summary .chapter > a[href$="framadate/"]:before { content: "\f274"; }
.summary .chapter > a[href$="etherpad/"]:before { content: "\f036"; }
.summary .chapter > a[href$="ethercalc/"]:before { content: "\f00a"; }
.summary .chapter > a[href$="svgedit/"]:before { content: "\f1fc"; }
.summary .chapter > a[href$="ttrss/"]:before { content: "\f1ea"; }
.summary .chapter > a[href$="wallabag/"]:before { content: "\f0b1"; }
.summary .chapter > a[href$="diaspora/"]:before { content: "\f069"; }
.summary .chapter > a[href$="peertube/"]:before { content: "\f008"; }
.summary .chapter > a[href$="lstu/"]:before { content: "\f0c1"; }
.summary .chapter > a[href$="gitlab/"]:before { content: "\f1d3"; }
.summary .chapter > a[href$="lutim/"]:before { content: "\f03e"; }
.summary .chapter > a[href$="zerobin/"]:before { content: "\f0ea"; }
.summary .chapter > a[href$="searx/"]:before { content: "\f002"; }
.summary .chapter > a[href$="bicbucstriim/"]:before { content: "\f0f4"; }
.summary .chapter > a[href$="nextcloud/"]:before { content: "\f0ee"; }
.summary .chapter > a[href$="kanboard/"]:before { content: "\f0e4"; }
.summary .chapter > a[href$="lufi/"]:before { content: "\f1d8"; }
.summary .chapter > a[href$="umap/"]:before { content: "\f279"; }
.summary .chapter > a[href$="loomio/"]:before { content: "\f0a1"; }
.summary .chapter > a[href$="mattermost/"]:before { content: "\f0e6"; }
.summary .chapter > a[href$="framagenda/"]:before { content: "\f073"; }
.summary .chapter > a[href$="sympa/"]:before { content: "\f0c0"; }
.summary .chapter > a[href$="framaforms/"]:before { content: "\f0ca"; }
.summary .chapter > a[href$="turtl/"]:before { content: "\f249"; }
.summary .chapter > a[href$="jitsimeet/"]:before { content: "\f03d"; }
.summary .chapter > a[href$="minetest/"]:before { content: "\f1b2"; }
.summary .chapter > a[href$="scrumblr/"]:before { content: "\f247"; }
.summary .chapter > a[href$="shaarli/"]:before { content: "\f005"; }
.summary .chapter > a[href$="framaestro/"]:before { content: "\f0d0"; }
.summary .chapter > a[href$="strut/"]:before { content: "\f200"; }
.page-toc::before {
content:none;
}
.page-toc {
max-width: 42%;
margin-left: 10px;
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment