Logo GNT
Actualités Tests & Guides Bons Plans
Twitter iPhone pliant OnePlus 11 PS5 Disney+ Orange Livebox Windows 11
Entraide Linux Autres OS Linux Debian La doc de Debian au format Epub

La doc de Debian au format Epub

7 réponses
Avatar
Adrien
Bonjour =C3=A0 tous,

L'autre fois, je voulais potasser les documentations de Debian, et
notamment "Securing Debian Manual". On peut le lire en ligne au format
HTML, sur =C3=A9cran ou sur papier en imprimant un PDF, mais pas encore sur
les liseuses.

Ni une ni deux, je lance Calibre (sans trop d'=C3=A9lan, sinon les r=C3=AAn=
es te
restent entre les mains) et je t=C3=A9l=C3=A9charge les paquets debian-doc,
harden-doc et leurs sources respectives (paquet debian-edu-doc-fr et
apt-get source harden-doc).

Pour un noob, le moyen le plus facile de transformer un document en un
autre est de passer par HTML et g=C3=A9n=C3=A9rer le fichier EPUB. On peut =
le
faire =C3=A0 la main si on veut, mais Calibre peut le faire tr=C3=A8s bien,=
et
m=C3=AAme rajouter des fonctionnalit=C3=A9s pour la lecture sur =C3=A9cran =
e-ink.

Maintenant, je prends the Securing Debian manual : apr=C3=A8s installation
de harden-doc, tout se trouve
dans /usr/share/doc/harden-doc/html/securing-debian-howto.
Par Calibre, j'assemble le tout.

R=C3=A9sultat (horreur hod=C3=A9sespoahr) :
- Le document est tout chamboul=C3=A9, les premiers chapitres ont =C3=A9t=
=C3=A9 mis en
dernier ;
- Plus grave, au d=C3=A9but de chaque chapitre j'ai tout le tas d'en-t=C3=
=AAtes
de HTML, qui sont inutiles dans mon cas. Ce sont les m=C3=AAmes en-t=C3=
=AAtes
qu'on peut avoir l=C3=A0 :
http://www.debian.org/doc/manuals/securing-debian-howto/index.fr.html

Pour bien faire, il faudrait donc g=C3=A9n=C3=A9rer les epubs =C3=A0 partir=
des sources
sgml... Je r=C3=A9cup=C3=A8re les sources par :
$ apt-get source harden-doc

puis une fois dans ~/harden-doc-3.15.1 je trouve deux Makefile... Je
suppose que c'est =C3=A7a qu'il faudrait adapter.

J'ai trouv=C3=A9 maints tutoriels qui expliquent clairement comment g=C3=A9=
n=C3=A9rer
un epub =C3=A0 partir de "rien" :
- http://www.ebouquin.fr/2010/02/04/comment-creer-un-fichier-epub/ qui
lie notamment vers
- http://www.jedisaber.com/eBooks/Tutorial.shtml

Reste plus qu'=C3=A0 modifier (probablement) les Makefiles pour g=C3=A9n=C3=
=A9rer les
epubs en question. Je n'ai pas le temps de m'y plonger maintenant, mais
si quelqu'un a l'envie, =C3=A7a pourrait profiter =C3=A0 la communaut=C3=A9=
, non ?

Ou sinon (mieux ?) peut-=C3=AAtre serait-il bon de cr=C3=A9er un sgml2epub =
(et
les autres) afin de g=C3=A9n=C3=A9rer ensuite automatiquement toutes les
documentations qui nous tombent sous la main ?

Merci par avance pour vos r=C3=A9actions,

--=20
Adrien

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers debian-user-french-REQUEST@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmaster@lists.debian.org
Archive: http://lists.debian.org/20131230183845.0c0ec75c@little-hat.creasixtine.com
Signaler un problème avec ce contenu

7 réponses

Supprimer
Cette action est irreversible, confirmez la suppression du commentaire ?
Signaler le commentaire

Veuillez sélectionner un problème

Nudité
Violence
Harcèlement
Fraude
Vente illégale
Discours haineux
Terrorisme
Autre
Avatar
Stéphane GARGOLY
Bonjour à tous les utilisateurs et développeurs de Debian :

Le 30/12/2013, Adrien a écrit :
L'autre fois, je voulais potasser les documentations de Debian, et
notamment "Securing Debian Manual". On peut le lire en ligne au format
HTML, sur écran ou sur papier en imprimant un PDF, mais pas encore sur
les liseuses.



Euh, une liseuse ne permettrait-elle pas de lire des documents PDF ?
Voire des pages HTML ?

Cordialement et à bientôt,

Stéphane.

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/CAAqHXE5+pZye48itMjuAHsiPBXz=ueA7S4Ne+
Avatar
Adrien
This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
------enig2QAUNOXDPIFQOOKLWAIMM
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Le 30/12/2013 19:11, Stéphane GARGOLY a écrit :
Euh, une liseuse ne permettrait-elle pas de lire des documents PDF ?
Voire des pages HTML ?



Dans l'absolu oui, mais le texte n'est pas formaté pour une lecture
agréable :
- Un PDF contient des pages de format fixe. Dans une liseuse comme les
diverses Kobo (ce que je possède), la manipulation de PDF n'est pas
aisée : sur chaque page il faut zoomer, déplacer la vue...
- Le HTML est très bien pour les liseuses, mais dans les documentations
Debian, au début de chaque chapitre on remet tout un tas de choses
inutiles : liens vers les autres chapitres, en-têtes, ...

En plus, en assemblant le manuel de sécurisation tout est fichu à
l'envers (mais c'est peut-être un bug Debian).

Au-delà de cela, le format Epub permet de gérer un sommaire, qui est
traité dans la liseuse par un menu interne spécifique (et c'est trè s
pratique à l'utilisation).
En fait, ça ne doit pas être compliqué à générer : il nous fa ut grosso
modo un fichier HTML par chapitre, une arborescence spécifique (voir
specs), et deux fichiers XML (un manifeste et un sommaire je crois).

Pour les fichier HTML, je ne sais pas comment le générer sans les
en-têtes inutiles pour la liseuse. Pour l'arborescence et le XML, ça
doit pouvoir se générer très facilement, même avec un script shel l ^^

--
Adrien.
-------------------------------------



------enig2QAUNOXDPIFQOOKLWAIMM
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Icedove - http://www.enigmail.net/

iQEcBAEBAgAGBQJSwcYcAAoJEN2mnsXFeEtwbyAH/1AVV8tyVKsMehWx6woTezKs
k0u3+V06ZWfCWgSQzkPPfg2gfbOezuti4qLcc2P5H052KmFlkgbjIffaMl3F/GfI
qFwjiSATVjCjvoCmF0jitcrL26W0qrVY52VwZrfMzJHeDvIlY9GSrTmLIYaYRmu0
zEBQiAyG2xai9c74cESsBMV7ZH2/qQT03QjM2ZzSD/6QoVV5/bjkAMHh76fh1Y7R
RiXO0v8HeQKdoYsrp9H50MLGxKYeiRMzCtWMJd2PhWyUzWhnXBrKnMwtQIs8buV0
WhFpp2SUyxFSCLulLWkuv/wTXFpyNNzrdC2EKT0q25ECV6IiGy/m3oBKRIRlSN8 =mJ03
-----END PGP SIGNATURE-----

------enig2QAUNOXDPIFQOOKLWAIMM--

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/
Avatar
Charles Plessy
Le Mon, Dec 30, 2013 at 06:38:45PM +0100, Adrien a écrit :

Reste plus qu'à modifier (probablement) les Makefiles pour générer les
epubs en question. Je n'ai pas le temps de m'y plonger maintenant, mais
si quelqu'un a l'envie, ça pourrait profiter à la communauté, non ?



Bonjour Adrien,

oui, c'est une bonne idée et une telle contribution serait très bienvenue.

L'idée d'utiliser Publican (https://fedorahosted.org/publican/) est dans
l'air mais personne n'a le temps...

Pour corser le tout, les documentations au format DebianDoc SGML devraient
mieux être converties à DocBook XML d'abords, car l'heure de la retraite arrive
pour DebianDoc.

Mais ça sera probablement très formateur pour la personne qui le fera, qui
aura l'occason de lire et relire les manuels :)

Amicalement,

--
Charles Plessy
Tsurumi, Kanagawa, Japan

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/
Avatar
Adrien
This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
------enig2QNOLBUXGQSCWRGKCSXGQ
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Le 30/12/2013 21:04, Charles Plessy a écrit :
Le Mon, Dec 30, 2013 at 06:38:45PM +0100, Adrien a écrit :
Reste plus qu'à modifier (probablement) les Makefiles pour génér er les
epubs en question. Je n'ai pas le temps de m'y plonger maintenant, mai s
si quelqu'un a l'envie, ça pourrait profiter à la communauté, no n ?


Bonjour Adrien,

oui, c'est une bonne idée et une telle contribution serait très bie nvenue.

L'idée d'utiliser Publican (https://fedorahosted.org/publican/) est d ans
l'air mais personne n'a le temps...

Pour corser le tout, les documentations au format DebianDoc SGML devrai ent
mieux être converties à DocBook XML d'abords, car l'heure de la ret raite arrive
pour DebianDoc.

Mais ça sera probablement très formateur pour la personne qui le fe ra, qui
aura l'occason de lire et relire les manuels :)

Amicalement,



Bonjour, et merci également de ta réponse.
Je vais voir ça pour Publican. En parle-t-on chez Debian ?
Je vais regarder si je trouve des références, ou sur le gestionnaire de
bugs de Debian.

--
Adrien.
-------------------------------------



------enig2QNOLBUXGQSCWRGKCSXGQ
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Icedove - http://www.enigmail.net/

iQEcBAEBAgAGBQJSwdUpAAoJEN2mnsXFeEtwHVIIAIT9UHxcCc9QZXfRw6+xnTEH
DrDHSPM2O+KbmG+DEEgD/E3mzqL3vpU11NISsHtXGfmegUMhDU0mufZhvhmz3fT0
eaDfYTdyLNJjBsKsuQFSx9YF//Ulg+dSvjxUWPRwXKOMvY28JabcsOPo+OukhnQ4
p/GwwPz1y7vjtuWJTqgqgW83Tp/mM4xOyBKOblUJ1+pOZXgR56wekWjSb9E1qAl5
T3jBM4jbw6t8j7N2BTueLxw8sR35p4RWzVSxBTM618P4ICXMuTbvGlMG7fYFj0i2
ticmIA0rz364qsYinnig4aCHlydtaBymg+wBtCI19obUkVv2yd1T8mzuC9go0sQ =bMF7
-----END PGP SIGNATURE-----

------enig2QNOLBUXGQSCWRGKCSXGQ--

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/
Avatar
Charles Plessy
Le Mon, Dec 30, 2013 at 09:18:49PM +0100, Adrien a écrit :

Je vais voir ça pour Publican. En parle-t-on chez Debian ?



Pas des masses, mais c'est le système utilisé pour les « Cahier de l'admin
Debian » (http://debian-handbook.info/), dont les sources sont disponibles
sous forme de paquet source Debian.

https://alioth.debian.org/anonscm/git/debian-handbook/debian-handbook.git

Il y a donc de quoi s'inspirer :)

Bon réveillon à tous,

--
Charles Plessy
Tsurumi, Kanagawa, Japan

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/
Avatar
Stéphane GARGOLY
Bonjour à tous les utilisateurs et développeurs de Debian :

Le 31/12/2013, Charles Plessy a écrit :
Le Mon, Dec 30, 2013 at 09:18:49PM +0100, Adrien a écrit :
Je vais voir ça pour Publican. En parle-t-on chez Debian ?



Pas des masses, mais c'est le système utilisé pour les « Cahier de l'admin
Debian » (http://debian-handbook.info/), dont les sources sont disponib les
sous forme de paquet source Debian.

https://alioth.debian.org/anonscm/git/debian-handbook/debian-handbook.git



Puisque certains semblent intéresser par les ePubs, je me suis permis
de faire quelques recherches (à partir du site Internet de Debian) et
je vous donne déjà le lien :
http://packages.debian.org/search?keywords=epub&searchon=all&suite=al l&section=all

Vous y trouverez des outils (tournant autour de ce format) sous forme
de paquets dont :
a. [DocBook XML to .epub converter] http://packages.debian.org/wheezy/dbto epub
b. [tools to work with the EPub file format]
http://packages.debian.org/wheezy/epub-utils
c. [XML-to-any converter] http://packages.debian.org/wheezy/xmlto
Je n'ai pas regardé en détail cette liste mais je pense que vous y
trouverez votre bonheur. ;-)

Notons qu'il y a également de la documentation Debian (au format ePub) :
d. [Debian Live Documentation (epub)]
http://packages.debian.org/wheezy/live-manual-epub

Ces paquets sont inclus dans Wheezy (stable) mais ils existent
également pour Squeeze (oldstable), Jessie (testing) et Sid
(unstable).

Bon réveillon à tous,



Les sushis et autres sashimis sont-ils de la partie ?

Si oui, miam miam !! :-D

Cordialement et à bientôt,

Stéphane.

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/CAAqHXE71k-1D1og5yUjOdFYENn+oHFiMKu7AAmf=
Avatar
Charles Plessy
Le Tue, Dec 31, 2013 at 01:05:38PM +0000, Stéphane GARGOLY a écrit :

a. [DocBook XML to .epub converter] http://packages.debian.org/wheezy/dbtoepub
b. [tools to work with the EPub file format] http://packages.debian.org/wheezy/epub-utils
c. [XML-to-any converter] http://packages.debian.org/wheezy/xmlto
d. [Debian Live Documentation (epub)] http://packages.debian.org/wheezy/live-manual-epub

Ces paquets sont inclus dans Wheezy (stable) mais ils existent
également pour Squeeze (oldstable), Jessie (testing) et Sid
(unstable).

> Bon réveillon à tous,

Les sushis et autres sashimis sont-ils de la partie ?



Ils furent délicieux et arrosés de Crémant d'Alsace, merci :)

Juste pour dire que la progression du epub commence bien l'année 2014.

http://henrich-on-debian.blogspot.jp/2014/01/more-epub-format-support-for-debian-docs.html

Amicalement,

--
Charles Plessy
Tsurumi, Kanagawa, Japon

--
Lisez la FAQ de la liste avant de poser une question :
http://wiki.debian.org/fr/FrenchLists

Pour vous DESABONNER, envoyez un message avec comme objet "unsubscribe"
vers
En cas de soucis, contactez EN ANGLAIS
Archive: http://lists.debian.org/