Re: La doc de Debian au format Epub

2014-01-04 Thread Charles Plessy
Le Tue, Dec 31, 2013 at 01:05:38PM +, 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 debian-user-french-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: http://lists.debian.org/20140104132753.gf22...@falafel.plessy.net



Re: La doc de Debian au format Epub

2013-12-31 Thread 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 disponibles
> 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=all§ion=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/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
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 debian-user-french-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: 
http://lists.debian.org/CAAqHXE71k-1D1og5yUjOdFYENn+oHFiMKu7AAmf=jkxbarr...@mail.gmail.com



Re: La doc de Debian au format Epub

2013-12-31 Thread BOLLINGH Sebastien
> 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
>
> --
Je ne suis pas développeur, juste un peu de Python et du HTML.
Il me semble que je devrais pouvoir apprendre le nécessaire à participer à ce 
projet ...
Si quelqu'un peut me guider, je veux bien aider.

J'espère venir à la miniDebConf à Paris le 18 ou le 19 janvier prochain ... si 
vous y êtes ...

Bonnes fêtes à tou(te)s

Cba

--
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-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: http://lists.debian.org/23e5-52c2b500-b-77df1300@247352970



Re: La doc de Debian au format Epub

2013-12-31 Thread 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 debian-user-french-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: http://lists.debian.org/20131231120535.gb2...@falafel.plessy.net



Re: La doc de Debian au format Epub

2013-12-30 Thread Adrien
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é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,
>
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.
-




signature.asc
Description: OpenPGP digital signature


Re: La doc de Debian au format Epub

2013-12-30 Thread 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 debian-user-french-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: http://lists.debian.org/20131230200404.ga2...@falafel.plessy.net



Re: La doc de Debian au format Epub

2013-12-30 Thread Adrien
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 faut 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 shell ^^

--
Adrien.
-




signature.asc
Description: OpenPGP digital signature


Re: La doc de Debian au format Epub

2013-12-30 Thread 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 debian-user-french-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: 
http://lists.debian.org/CAAqHXE5+pZye48itMjuAHsiPBXz=uea7s4ne+h3qdapij-l...@mail.gmail.com



La doc de Debian au format Epub

2013-12-30 Thread Adrien
Bonjour à 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 écran ou sur papier en imprimant un PDF, mais pas encore sur
les liseuses.

Ni une ni deux, je lance Calibre (sans trop d'élan, sinon les rênes te
restent entre les mains) et je télécharge 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énérer le fichier EPUB. On peut le
faire à la main si on veut, mais Calibre peut le faire très bien, et
même rajouter des fonctionnalités pour la lecture sur écran e-ink.

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

Résultat (horreur hodésespoahr) :
- Le document est tout chamboulé, les premiers chapitres ont été mis en
  dernier ;
- Plus grave, au début de chaque chapitre j'ai tout le tas d'en-têtes
  de HTML, qui sont inutiles dans mon cas. Ce sont les mêmes en-têtes
  qu'on peut avoir là :
http://www.debian.org/doc/manuals/securing-debian-howto/index.fr.html

Pour bien faire, il faudrait donc générer les epubs à partir des sources
sgml... Je récupère 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 ça qu'il faudrait adapter.

J'ai trouvé maints tutoriels qui expliquent clairement comment générer
un epub à 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'à 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 ?

Ou sinon (mieux ?) peut-être serait-il bon de créer un sgml2epub (et
les autres) afin de générer ensuite automatiquement toutes les
documentations qui nous tombent sous la main ?

Merci par avance pour vos réactions,

-- 
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-requ...@lists.debian.org
En cas de soucis, contactez EN ANGLAIS listmas...@lists.debian.org
Archive: 
http://lists.debian.org/20131230183845.0c0ec...@little-hat.creasixtine.com