remplir les pages sources

This commit is contained in:
tykayn 2021-01-11 23:16:31 +01:00 committed by Baptiste Lemoine
parent 127957f46b
commit f8b63dae70
13 changed files with 177 additions and 30 deletions

View File

@ -1,9 +1,30 @@
# Générateur d'ebook à partir de markdown
Générateur d'ebook à partir de chapitres écrits en markdown
===
![logo markdown](https://d33wubrfki0l68.cloudfront.net/f1f475a6fda1c2c4be4cac04033db5c3293032b4/513a4/assets/images/markdown-mark-white.svg)
ce dépot présente un dossier de travail pour générer des ebook à partir de documents écrits avec la syntaxe markdown.
éditeur de texte conseillé pour le markdown:
---
Ce dépot présente un dossier de travail pour générer des ebook à partir de documents écrits avec la syntaxe markdown.
éditeur de texte conseillé pour le markdown: Zettlr
https://www.zettlr.com/download/deb
pour essayer d'écrire du markdown à plusieurs dans une page web, essayez d'aller sur ce lien et voyez la magie de la conversion en html s'opérer sous vos yeux au fur et à mesure que vous écrivez.
[essayez dans une démo en ligne](https://demo.hedgedoc.org/wWyNggVKSES4nT3Uh3oorw#)
## mode d'emploi
* installez les dépendances
```
bash install_dependances_ubuntu.sh
```
* remplissez les pages .md de votre livre dans le dossier [source] en suivant la syntaxe Markdown
* générez l'ebook avec le script
```
bash install_dependances_ubuntu.sh
```
par tykayn pour le CIL de Gometz : www.cil-gometz.org
site perso: www.cipherbliss.com

View File

@ -1,44 +1,43 @@
#!/bin/bash
# Ce script sert à publier le WhitePaper.
# La première version crée les documents whitepaper.md et whitepaper.html.
# Ce script sert à publier le mon_ebook.
# La première version crée les documents mon_ebook.md et mon_ebook.html.
# Le doc Markdown complet est volontairement supprimé. Je préfère que les modifications soient faites sur les différentes parties.
# ce script doit être lancé dans le dossier contenant les chapitres.
echo "=============== génération de mon ebook, c'est parti! =============== "
# dépendances : sphinx-build pandoc
hash sphinx-build 2>/dev/null || { echo >&2 "Ce générateur a besoin de la commande sphinx-build pour fonctionner. Mais cette commande n'est pas installée. Fin de l'exécution."; exit 1; }
hash pandoc 2>/dev/null || { echo >&2 "Ce générateur peut utiliser ebook-convert fourni avec Calibre, disponible dans les dépots apt. Mais cette commande n'est pas installée. Fin de l'exécution."; exit 1; }
hash ebook-convert 2>/dev/null || { echo >&2 "Ce générateur a besoin de la commande ebook-convert de Calibre pour fonctionner. Mais cette commande n'est pas installée. Fin de l'exécution."; exit 1; }
#hash sphinx-build 2>/dev/null || { echo >&2 "Ce générateur a besoin de la commande sphinx-build pour fonctionner. Mais cette commande n'est pas installée. Fin de l'exécution."; exit 1; }
hash pandoc 2>/dev/null || { echo >&2 "Ce générateur peut utiliser pandoc fourni avec Calibre, disponible dans les dépots apt. Mais cette commande n'est pas installée. Fin de l'exécution."; exit 1; }
# clean build
rm -rf build/*
## Compilation HTML des différents chapitres
cp source/base_index.rst source/index.rst
for i in chapitres/*.rst ; do
cat $i >> source/index.rst
for i in source/*.md ; do
cat $i >> build/toutes_les_pages.md
done
sphinx-build -b html source build
if [ -e build/index.html ] ; then
echo "===== HTML OK ====="
fi
## Compilation PDF
sphinx-build -M latexpdf source build
# deplacement dans le fichier de build
mv ./build/latex/mon_book.pdf ./build/
#firefox "$PWD/build/whitepaper_en.html"
## add ebook conversion
#ebook-convert build/whitepaper_fr.html build/whitepaper_fr.mobi
#ebook-convert build/whitepaper_en.html build/whitepaper_en.mobi
#ebook-convert build/whitepaper_fr.html build/whitepaper_fr.fb2
#ebook-convert build/whitepaper_en.html build/whitepaper_en.fb2
#ebook-convert build/whitepaper_fr.html build/whitepaper_fr.epub
#ebook-convert build/whitepaper_en.html build/whitepaper_en.epub
#sphinx-build -b html source build
#
#if [ -e build/index.html ] ; then
# echo "===== HTML OK ====="
#fi
#
### Compilation PDF
#sphinx-build -M latexpdf source build
#
#firefox "$PWD/build/mon_ebook.html"
### add ebook conversion
#
#ebook-convert build/mon_ebook_fr.html build/mon_ebook_fr.mobi
#ebook-convert build/mon_ebook_en.html build/mon_ebook_en.mobi
#ebook-convert build/mon_ebook_fr.html build/mon_ebook_fr.fb2
#ebook-convert build/mon_ebook_en.html build/mon_ebook_en.fb2
#ebook-convert build/mon_ebook_fr.html build/mon_ebook_fr.epub
#ebook-convert build/mon_ebook_en.html build/mon_ebook_en.epub
echo " "
echo "===== ok pour la génération d'ebooks"

81
exemple_markdown.md Normal file
View File

@ -0,0 +1,81 @@
---
## Exemples de syntaxe pour mettre en valeur
### Faire des liens avec des crochets et des parenthèses
* Supportons l'Electronic Frontière Fondation **[EFF](https://eff.org)**.
* Ceci est le *[Guide du Markdown](https://www.markdownguide.org)*.
* Visitez la section à propos de [`code`](#code).
```json
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```
### insérer une image
![logo markdown](https://d33wubrfki0l68.cloudfront.net/f1f475a6fda1c2c4be4cac04033db5c3293032b4/513a4/assets/images/markdown-mark-white.svg)
![Feynman Lecture 1](https://cdn.mathpix.com/snip/images/0Y13pkOem1h2kqhOPAB98mtSCL5FQlQPtot1obxd-R8.original.fullsize.png)
## utilisation avancée du markdown
### cases à cocher
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
### faire un tableau
| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
assurez vous de créditer vos images et de respecter leur licence. Licence que l'on espère ouverte.
### note de pied de page
Here's a simple footnote,[^1] and here's a longer one.
[^1]: This is the first footnote.
## citation
> This is my blockquote,
> It's taking up two lines.
> This is my nested blockquote,
>> it's pretty nifty.
## définitions et listes
+ Sub-lists are made by indenting 2 spaces:
- Different characters in in the same sub-list will render the same characters:
* Ac tristique libero volutpat at
+ Facilisis in pretium nisl aliquet
- Nulla volutpat aliquam velit
+ Very easy!
First Term
: This is the definition of the first term.
Second Term
: This is one definition of the second term.
: This is another definition of the second term.
## formules de math
$$
x = \frac { - b \pm \sqrt { b ^ { 2 } - 4 a c } } { 2 a }
$$
Compute \(f(x) = x^2 + 2\) if \(x=2\).
\sum_{n=1}^{\infty} 2^{-n} = 1
\prod_{i=a}^{b} f(i)
## emojis
Gone camping! :tent: Be back soon.
:wink: :cry: :laughing: :yum:

View File

@ -0,0 +1,24 @@
#!/bin/bash
echo " =============================================================================================== "
echo " installation de dépendances pour faire ses propres ebook par tykayn de cipherbliss.com "
echo " =============================================================================================== "
while true; do
read -p " voulez-vous installer les dépendances nécessaire à la compilation d'ebook ? (o pour oui, n pour non) " yn
case $yn in
[Oo]* ) echo " nous allons installer Calibre et Pandoc avec apt; c'est parti!"; sudo apt install -y calibre pandoc; break;;
[Nn]* ) echo "bon ok ._." ; break;;
* ) echo "Veuillez répondre o pour oui, n pour non .";;
esac
done
while true; do
read -p " voulez-vous cent balles et un mars ? (o pour oui, n pour non) " yn
case $yn in
[Oo]* ) echo "bah moi aussi tiens."; break;;
[Nn]* ) echo "bon ok ._." ; exit;;
* ) echo "Veuillez répondre o pour oui, n pour non .";;
esac
done

View File

@ -1,3 +1,6 @@
# Préface
blah blah
## écrivez ici votre préface.
En attendant voici un exemple de contenu que vous pourrez supprimer.
Suivez le guide pour écrire en markdown.
Consultez [les exemples sur cette page.](../exemple_markdown.md)

View File

@ -0,0 +1 @@
# Chapitre

View File

@ -0,0 +1 @@
# Chapitre

1
source/04_chapitre_4.md Normal file
View File

@ -0,0 +1 @@
# Chapitre

View File

@ -0,0 +1 @@
# Postface

View File

@ -0,0 +1 @@
# Sources, bibliographie

View File

@ -0,0 +1,3 @@
# Table des matières
[TOC]

View File

@ -0,0 +1,11 @@
résumé du livre
---
auteur
date
www.cipherbliss.com
[📧 contact](https://www.cipherbliss.com/contact)