Ebook du grand débutant qui débute : Version 2

arpinux · 25-07-2016 10:32:14

re

et je suis bien d'accord sur txt2tag/dokuwiki/LaTeX : si on peut séparer la forme du fond c'est génial. et quand j'ai chopé les sources des cahiers de l'admin, j'ai ri... doit y avoir 12 images à tout casser et aucune originalité de mise en forme.
pour le coup, ça peut être du LaTeX, de l'XML, du DW ou ce que tu veux, ça passe

mais si on file ça à un n00b, il s'enfuit (déjà que moi ça me branche pas trop)

j'ai commencé en txt2tags et LaTeX et je vous ai demandé un peu d'aide pour la mise en forme du PDF car j'y connais vraiment rien en LaTeX. bon, ça n'a pas fonctionné non plus

je suis vraiment pas fermé sur le format et si il faut tout refaire de zéro demain, j'en suis, pas de soucis, mais faut que le résultat en vaille le coup.
et pour l'instant, le meilleur rendu pour le PDF vient de la version ODT.

mais sérieusemement, si un pro du LaTeX veut m'aider à reprendre le code en l'adaptant, pas de soucis, je gèle ma version ODT proprement et je me mets au LaTeX sans talc ni stress

Elm · 25-07-2016 11:06:25

Salut

! Je passe par là et je viens regarder le doc en cours de rédaction : chapeau ! Si j'avais eu ça quand j'ai débuté en venant de mac os ça m'aurait grandement aidé pour saisir les bases (et je n'aurais peut-être pas trouvé que le monde GNU/Linux était une vraie jungle inextricable). Pour dire que ce boulot sera fort utile à mon sens. Alors merci et bravo !

bendia · 25-07-2016 11:08:47

C'est toujours l'histoire des bras

J'étais un peu dans la même position que toi, à savoir un peu seul

Donc, j'avais fait au mieux en me disant qu'on verrait la mise en forme arpès, (on n'étant pas forcemment moi du fait que ça n'est pas mon fort

). Comme ça s'était essouflé, les sources étaient effectivement un peu maigre.

LaTeX à un avantage de pouvoir sortir des PDF vraiement chouette, voire, un vrai document relié (c'est mon secret espoir personnel

) avec des effets de mise en page permettant par exemple plusieurs niveau de lecture.

Ceci-dit, on s'en fout pour le moment. Ce que tu as déjà fait a déjà de l'allure, et surtout un contenu

On peut parfaitement continuer dans cette voie pour l'instant, avec une source ODT et un PDF et contribuent ceux qui peuvent de cette manière

Lorsque ça sera terminé, on pourra s'atteler à une version 3 enrichie publiable en version papier et facilement exportable dans le wiki

Parallelement et en prévision, on peut aussi réfléchir à contribuer à dokuwiki comme captnfab l'avait fait pour fluxbb avec fluxgeshi histoire de pondre un outil capable de sortir des PDF plus sympas

arpinux · 25-07-2016 11:12:27

Apper, c'est terminé

, mais n'hésites pas à corriger

et pour odt2dw; c'est ce que j'ai utilisé pour faire la page du wiki et c'est bien sauf qu'il faudrait que je puisse accéder au serveur pour balancer toutes les images en lot, sinon, c'est upload à l'unité et c'est bien galère. et même, le format dw que je peux sortir engendre un tas de doublons avec le wiki existant vu qu'il reprend plusieurs parties de la documentation debian-facile.

les cahiers du débutant ne sont pas un wiki ou même une documentation, c'est un manuel, un guide, un premier pas pour le débutant.
si le wiki fonctionnait pour le débutant, on aurait pas besoin d'un manuel en PDF

je fais la mise à jour de la page du wiki avec les modifs de la nuit et je touche plus. martinux_qc passe en relecture/correction, je vous laisse mater le reste, je fais pause aujourd'hui en rédaction

@bendia : ah mais clair que le format professionnel serait l'idéal, mais il faut une personne qui le connaisse et sache le maîtriser pour nous

Dernière modification par arpinux (25-07-2016 11:13:36)

bendia · 25-07-2016 11:44:53

arpinux a écrit :

@bendia : ah mais clair que le format professionnel serait l'idéal, mais il faut une personne qui le connaisse et sache le maîtriser pour nous

Il faut voir avec Thuban qui a une première expérience

arpinux a écrit :

es cahiers du débutant ne sont pas un wiki ou même une documentation, c'est un manuel, un guide, un premier pas pour le débutant.

Certes. Il faut cependant veiller à ce que ça soit maintenable facilement. Le problème existe avec la version actuelle en PDF qui n'est jamais mise à jour parce-que c'est galère et que ça nécessite l'intervention d'un admin-sys (et il n'y en a pas 40 ).

Donc, encore une fois, poursuivons comme cela, puisque ça fonctionne pour l'instant, et on verra plus tard pour une version 3 et les outils de maintenance qui vont bien

arpinux · 25-07-2016 12:03:53

oui oui, et pour la v3 facilement maintenable, j'ai trouvé :
- 1 finir le fichier odt qui sera la première source de rédaction et de moteur de rendu pour le PDF : ça fixe le premier contenu et la mise en forme
- 2 convertir le odt en dw avec odt2dw qui fonctionne très bien sauf pour les images qu'il colle à la même adresse
- 3 remplacer toutes les occurences {{wiki:imagexxx}} par {{adresse_accessible:imagexxx}} ce qui affichera les images dans le wiki. donc à voir : soit vous me filez un accès à un espace @DF pour que j'upload toutes les images, soit je passe par mon serveur en provisoire (je vais faire ça pour commencer afin que vous puissiez vous rendre compte du résultat)

ainsi, la version définitive sera sur le wiki, avec les images, mais sans la mise en forme jolie du PDF
il faudra alors une personne qui sera chargée de la surveillance des modifications du wiki afin de les reporter sur l'odt et générer le PDF, mais les contributions pourront se faire sur le wiki très facilement ET aussi en ODT car le maintainer des cahiers du débutant aura accès aux deux

je fais les tests ce soir pour les images et les options d'export

et encore un fois, là on se prend bien le choux, mais quand il sera achevé, la maintenance, c'est vraiment pas grand chose à faire. les infos changent pas tant que ça

... si tout n'avait pas été précipité, je serais arrivé avec un manuel achevé comme celui d'handylinux et il n'y aurait eu aucun soucis

Dernière modification par arpinux (25-07-2016 12:06:47)

Zanfib · 25-07-2016 12:44:51

Juste un petit commentaire pour ne pas rester muet malgré que je vienne d'arriver

Tout d'abord c'est une super bonne idée ce document, très bien fait, clair etc etc, que du bonheur pour un débutant !

Ensuite pour réfléchir au long terme c'est vrai que c'est pas évident du tout, le format ODT est vraiment bien en effet ! Ensuite passer du texte en wiki, au latex puis au pdf c'est toujours un peu chaud à gérer, c'est pas automatique du tout ... je connais un peu de Latex mais ça commence à faire un bail, je peux peut-être donner un coup de main si besoin.

J'avais déjà lu un article (je ne sais plus où désolé, pas moyen de le retrouver, peut-être sur Linux-FR) qui parlait de l"édition collaborative pour produire les Framabooks, ils doivent avoir des outils pour gérer ce type de workflow, et ça doit être en logiciel libre en plus

A voir comment tout ça peut s'imbriquer mais c'est un sacré projet les gars ! Bravo pour vous être déjà bien mouillé dedans !

smolski · 25-07-2016 12:56:15

arpinux, pour les images tu as l'outil Jyraphe dans les outils DF du menu.

bendia · 25-07-2016 12:56:56

@arpinux : ne te presse pas trop non plus. Il y a peut-être moyen d'automatiser avec les hooks git si on rapatrie ça sur notre serveur

arpinux · 25-07-2016 13:12:04

re

@smolski : Jirafe ne permet pas l'envoi en lot et change les noms donc ça me ferait encore plus de taf

.. bon .. libreoffice aussi change les noms

pfff ... pourquoi la solution parfaite n'existe jamais et qu'il faut toujours coller les mains dans cambouis ??

@bendia : non mais je vais tester avec les images dans un seul dossier sur mon serveur pour voir et comme ça, pour la mise à jour des images, ce sera dans un seul dossier pareil chez vous, donc facile

@Zanfib : merci et oui, quand le moemnt du LaTeX sera venu, on fera appel aux spécialistes

Dernière modification par arpinux (25-07-2016 13:18:55)

bendia · 25-07-2016 13:14:32

Et pandoc ?

arpinux · 25-07-2016 13:25:00

pandoc ne prend ni le ODT, ni le DW en format d'entrée ... on en revient au format pro (txt2tags, LaTeX) pour la base ...

je vous avoue que c'est un des trucs qui me gave le plus dans le libre : la complexité des outils "pro"... comme si les dev tenaient absolument à rester les seuls à savoir comment on s'en sert

je sais que ce n'est pas le cas ... mais avouez que la simplicité d'édition et de rendu avec libreoffice, il n'y a pas un seul truc pro qui fasse aussi simple pour un rendu pareil

oops .. j'ai été vilain, je n'ai testé que la version en ligne pour la conversion des ODT

mea culpa ... je télécharge et je teste

Dernière modification par arpinux (25-07-2016 13:27:52)

arpinux · 25-07-2016 13:36:12

 14:36 arp > pandoc -f debian-facile.odt -t dokuwiki -

pandoc: Unknown writer: dokuwiki

?
faut installer dokuwiki aussi sur debian ?

arpinux · 25-07-2016 13:39:54

... bon pandoc, même avec un pdf, je galère... j'ai du rater un truc

 14:44 arp > pandoc -o debian-facile2.pdf debian-facile.odt

pandoc: Cannot decode byte '\x92': Data.Text.Encoding.Fusion.streamUtf8: Invalid UTF-8 stream

Dernière modification par arpinux (25-07-2016 13:43:22)

bendia · 25-07-2016 13:41:18

arpinux a écrit :

mais avouez que la simplicité d'édition et de rendu avec libreoffice, il n'y a pas un seul truc pro qui fasse aussi simple pour un rendu pareil

C'est une vision personnelle à mon avis J'ai un mal fou à faire ce que je veux avec les traitements de texte WYSWYG. Il y a toujours une marge qui me fait ch... quelque part, dès que je touche à un truc, ça pête tout 3 pages après sans que je m'en aperçoive de suite. J'ai pourtant eu des cours à l'école dessus.

Sans maîtriser plus latex que ça (je ne l'ai utilisé que pour la première version de ce document et je n'ai eu qu'un mois pour tout faire, prise en main comprise), je n'ai pas eu ce problème. Comme je l'ai dit plus haut, ça dépend vraiment de comment chacun bosse et de ses compétences

J'ai parlé de pandoc, mais je n'ai pas essayer en fait. C'est juste une piste

deuchdeb · 25-07-2016 13:43:31

arpinux a écrit :

si tout n'avait pas été précipité

Mais si il faut prendre le temps on prendra le temps.

J'avais un copain suisse qui m'disait: " Y a pas le feu au lac "

arpinux · 25-07-2016 13:48:46

oui, tu as raison, c'est affaire de ressenti perso pendant le travail.
comme j'ai dit, j'adore dokuwiki et je me régale avec txt2tags que j'ai testé aussi pour le manuel, le rendu documentation est nickel... mais côté "eye-candy" ... c'est pas top quand même. on se retrouve toujours face à "de la doc".
j'arrive pas à autant de nuances et de détails avec dw, mais aussi car il a moins de fonctions prévues de base.

après, si on travaille bien, les cahiers du débutant sera un truc à mette à jour à chaque version majeure de Debian, pas plus

donc on aura bien le temps e trouver LA méthode de conversion/édition adaptée aux débutant et aux g33ks, pour l'édition, la contribution et aussi le rendu final... que de belles choses pour cet hiver

bendia · 25-07-2016 13:56:52

arpinux a écrit :

... bon pandoc, même avec un pdf, je galère... j'ai du rater un truc

Je crois qu'il faudrait backporter une version plus récente, ou attendre Stretch

En fait, faut pas se presser. Il faut faire avec les moyens du bords (les bras dispos). Commençons pas sortir un truc, ça sera forcement mieux que rien et on verra ensuite pour améliorer. Si pour ma part je suis moins à l'aise avec du ODT, et ben tant pis, j'irais à ma vitesse et pis c'est tout

D'ailleurs, j'ai commencer à rédiger la partie 2 Valeurs Debian. Mais, ça ne sera pas prêt avant la semaine prochaine. Si d'autres ont commencés ou pensent finir avant, dites le. Au pire, on pourra toujours bosser en commun partie par partie sur le wiki ou sur un pad pour la rédaction si le besoin s'en fait sentir, quitte à agréger le tout ensuite

arpinux · 25-07-2016 14:03:49

génial pour les valeurs Debian. j'avais fait une tite liste en reprenant vos remarques et avis, mais je sais pas par quel bout le prendre pour que ça fasse pas trop secte

reste la prise en main (il y en a déjà pas mal sur handy) et la config que je vais faire tranquille avec la VM branché à côté

Thuban · 25-07-2016 14:26:40

Coucou

Je veux bien aider pour LaTeX si vous voulez.
Ça pourra se faire petit à petit, puisqu'on peut faire des "include" dedans, et ainsi modifier et adapter chapitres par chapitres.

bendia · 25-07-2016 14:29:11

Au pire, on pourra exporter en texte brut depuis LO et refaire la mise en forme après

arpinux · 25-07-2016 14:35:52

o/ Thuban

owi, apprends-moi le LaTeX

et vrai que si le seul support officiel de distribution est le PDF, LaTeX est l'outil prédestiné

en revanche, pour les contributions, ça limite fortement ... faut connaître le latex ...
pour le texte pur, c'est bon, mais pour la mise en forme, va falloir du barbus

bendia · 25-07-2016 14:38:10

arpinux a écrit :

pour le texte pur, c'est bon, mais pour la mise en forme, va falloir du barbus

C'est proche de la rédaction HTML/CSS au final. On est pas tous des crack en CSS

Thuban · 25-07-2016 14:42:46

arpinux a écrit :

o/ Thuban
owi, apprends-moi le LaTeX
et vrai que si le seul support officiel de distribution est le PDF, LaTeX est l'outil prédestiné
en revanche, pour les contributions, ça limite fortement ... faut connaître le latex ...
pour le texte pur, c'est bon, mais pour la mise en forme, va falloir du barbus

Le PDF, c'est vraiment l'idéal aussi à mon avis. On peut l'avoir dans firefox, on peut faire une recherche dedans, on peut cliquer pour faire des redirections, on peut imprimer proprement... Tant qu'on file les sources, c'est top.

en revanche, pour les contributions, ça limite fortement ... faut connaître le latex ...

Oui et non. Je propose une écriture préalable avec txt2tags, tjrs facile à prendre en main (on peut même héberger un éditeur en ligne).
Ensuite, on (les nerds) convertit le txt2tags en LaTeX que l'on intègre au document final. Ça peut se générer avec un script qui prend un par un les fichiers .t2t, génère le code LaTeX et compile le PDF (comme j'ai fait pour le doc sur l'auto-hébergement).
Ça me paraît moins chiant à long terme que le .odt, qui, bien que tout le monde puisse l'éditer, posera de gros soucis de mise en page. Et comme c'est pas du texte brut, c'est dificile à versionner avec git pour revenir en arrière si besoin.

À réfléchir aussi, dokuwiki dispose d'une syntaxe txt2tags via un plugin, si on veut proposer ça comme point de départ...

arpinux · 25-07-2016 14:43:29

c'est juste le positionnement des images et ce genre de trucs. pour le reste, pas de formules ni schéma donc vrai que ça se fait...
je crois que j'ai pas eu le temps d'apprendre le latex aussi vite que libreoffice. du coup, j'ai déjà fait le plus gros du travail en odt...

mais vrai qu'on est pas si pressés... m'ont collé la pression les zotres

bref... calm down ... j'attends les modifs de martinux_qc déjà, bendia est sur le chapter2 donc je pourrais tester le LaTeX pur, déjà en exportant puis en bidouillant .... fin je verrais

merci@tous pour vos messages et avis. c'est mieux avec plusieurs cerveaux

Debian-facile

#276 25-07-2016 10:32:14

Re : Ebook du grand débutant qui débute : Version 2

#277 25-07-2016 11:06:25

Re : Ebook du grand débutant qui débute : Version 2

#278 25-07-2016 11:08:47

Re : Ebook du grand débutant qui débute : Version 2

#279 25-07-2016 11:12:27

Re : Ebook du grand débutant qui débute : Version 2

#280 25-07-2016 11:44:53

Re : Ebook du grand débutant qui débute : Version 2

#281 25-07-2016 12:03:53

Re : Ebook du grand débutant qui débute : Version 2

#282 25-07-2016 12:44:51

Re : Ebook du grand débutant qui débute : Version 2

#283 25-07-2016 12:56:15

Re : Ebook du grand débutant qui débute : Version 2

#284 25-07-2016 12:56:56

Re : Ebook du grand débutant qui débute : Version 2

#285 25-07-2016 13:12:04

Re : Ebook du grand débutant qui débute : Version 2

#286 25-07-2016 13:14:32

Re : Ebook du grand débutant qui débute : Version 2

#287 25-07-2016 13:25:00

Re : Ebook du grand débutant qui débute : Version 2

#288 25-07-2016 13:36:12

Re : Ebook du grand débutant qui débute : Version 2

#289 25-07-2016 13:39:54

Re : Ebook du grand débutant qui débute : Version 2

#290 25-07-2016 13:41:18

Re : Ebook du grand débutant qui débute : Version 2

#291 25-07-2016 13:43:31

Re : Ebook du grand débutant qui débute : Version 2

#292 25-07-2016 13:48:46

Re : Ebook du grand débutant qui débute : Version 2

#293 25-07-2016 13:56:52

Re : Ebook du grand débutant qui débute : Version 2

#294 25-07-2016 14:03:49

Re : Ebook du grand débutant qui débute : Version 2

#295 25-07-2016 14:26:40

Re : Ebook du grand débutant qui débute : Version 2

#296 25-07-2016 14:29:11

Re : Ebook du grand débutant qui débute : Version 2

#297 25-07-2016 14:35:52

Re : Ebook du grand débutant qui débute : Version 2

#298 25-07-2016 14:38:10

Re : Ebook du grand débutant qui débute : Version 2

#299 25-07-2016 14:42:46

Re : Ebook du grand débutant qui débute : Version 2

#300 25-07-2016 14:43:29

Re : Ebook du grand débutant qui débute : Version 2

Pied de page des forums