Documentation de l'ISO DF-Buster

Caribou22 · 04-09-2019 21:28:30

Bonsoir

Comme le titre l'indique, je suis en train de plancher sur la doc dédiée à l'ISO DF-buster. Il n'y a pas grand chose à y modifier concrètement à mon avis. Surtout les captures d'écran, et s'assurer que tout le contenu est toujours en phase avec l'ISO qui a évolué, et avec Debian Buster en général.

Pour cela, toute aide est la bienvenue !

Si vous souhaitez contribuer directement, la méthode idéale est la même que celle pour les cahiers du débutant, que j'ai détaillée dans le post dédié : https://debian-facile.org/viewtopic.php?id=24333

Une fois cette doc terminée ainsi que les cahiers, le projet pourra sans doute être considéré comme terminé

Les sources (+doc en pdf et deb) : https://http.debian-facile.org/git/Proj … iso-buster

La doc Debian-Facile Buster en PDF (en développement) : https://http.debian-facile.org/git/Proj … sateur.pdf

La doc DFlinux Stretch en PDF (pour comparer et voir les changements) : https://framagit.org/dflinux/documentat … sateur.pdf

Et un pad pour faire vos retours : https://debian-facile.org/collab/p/doc-df-buster

Dernière modification par Caribou22 (31-12-2019 13:40:10)

Caribou22 · 04-09-2019 21:47:06

Je poste à la suite des observations personnelles pour avoir vos avis :

Pour commencer, la doc de l'ISO s'adresse à des très grands débutants. Seulement, les premières parties (Du début à "première utilisation" en gros.) sont assez techniques et nécessitent des pré-requis pour être comprises, tandis que le reste est très clair pour tout le monde. Des débutants à qui j'ai présenté la doc ont souvent commencé à la lire dans l'ordre et se sont retrouvés largués avant d'arriver aux sections qui leurs parlent vraiment.
Je ne sais pas trop quoi faire pour y remédier. Changer l'ordre ? Raccourcir ? Diviser la doc en deux ? (Une partie "présentation du projet et guide d'installation" adressée aux plus curieux, et une partie "utilisation" adressée aux simples utilisateurs, souvent débutants n'ayant pas forcément installé le système eux-mêmes ?

(Pas envie non plus de défigurer le super travail d'arpinux)

Caribou22 · 17-12-2019 23:13:42

https://http.debian-facile.org/git/Cari … iso-buster

Ça avance bien !!!

La doc de développement en PDF : https://http.debian-facile.org/git/Cari … sateur.pdf

Je suis à l'écoute de vos remarques

Dernière modification par Caribou22 (17-12-2019 23:15:02)

otyugh · 17-12-2019 23:36:39

Wooh, et le gitea de DF en plus.

Omedeto !

EDIT : j'ai relu tes 4 derniers commit. Je vois pas trop d'erreur.

docs/dfl08-office.md
Optionnel : si vous souhautez scanner un document à plusieurs pages, vous pouvez placer la page suivante dans votre scanner et cliquer à nouveau sur "numériser". Simple-scan affichera la nouvelle page à la suite.

Dernière modification par otyugh (17-12-2019 23:49:21)

jce76350 · 18-12-2019 14:10:27

La doc de développement en PDF

Bien allégée cette doc , super
note les liens Où trouver des fonds d’écran ?
- Stock DFLinux = pointe sur lescahiersdudebutant.fr
- Wallbase.cc = Error 521

Dernière modification par jce76350 (19-12-2019 11:21:35)

fiche · 18-12-2019 22:29:14

Message supprimé car devenu sans intérêt.

Dernière modification par fiche (19-12-2019 18:11:54)

fiche · 19-12-2019 12:14:59

J'ai tout lu.
Je vous livre mes propositions de corrections et interrogations dans le fichier texte suivant (constats effectués partir du live DF) :
https://send.firefox.com/download/76802 … IV-aTo7LPg

A priori, le lien n'est valable que 1 jour (je découvre Firefox Send...).

Dernière modification par fiche (19-12-2019 12:19:03)

melissa6969 · 19-12-2019 12:35:30

@fiche
le lien que t'as donné n'est plus valide.
tu peux te créer un compte gratuitement sur firefox, et tu pourra choisir d'autres paramètres sur firefox send, le nombre de téléchargement ou le nombre de jours que tu souhaites laisser disponible le fichier.

Pour contribuer, on est obligé d'utiliser les clés ssh et de suivre tout le tuto du 1er message écrit par caribou22.??
on peut pas direct modifier dans framagit comme on fait dans github quoi.??
ça serait + simple et + rapide et + accessible à ceux qui maitrisent pas trop le sujet.

j'ai rien dis j'ai pas lu le bon topic.!!!

Dernière modification par melissa6969 (19-12-2019 12:41:44)

Caribou22 · 19-12-2019 12:51:28

Ne vous embêtez plus à partager des fichiers texte. J'ai crée un pad

https://debian-facile.org/collab/p/doc-df-buster

Pour contribuer, c'est sur le gitea de Debian-Facile. Il faut simplement avoir un compte dessus. Et je vais simplifier l'histoire des clés SSH dans l'autre discussion car il suffit aussi d'avoir un compte framagit

(A terme, toutes les sources seront migrées de Framagit au gitea de Debian-Facile)

Edit, tuto simplifié : https://debian-facile.org/viewtopic.php … 24#p299824

Dernière modification par Caribou22 (19-12-2019 12:58:12)

fiche · 19-12-2019 18:10:59

Je viens de compléter le "pad".
J'espère que ce sera utile pour la mise à jour.

Pour melissa6969 : je vais créer un compte Firefox pour mes futurs envois de documents (heureusement qu'il existe des gestionnaires de mot de passe !) car si au 1er téléchargement sur Firefox Send le fichier est supprimé, ce n'est pas très pratique.

Caribou22 · 19-12-2019 22:24:44

Wow !

Oui ce sera utile, merci à toi !

IL y a certaines sections que je n'ai pas commencées. Par exemple celle qui affirme que l'on ne peut pas installer depuis le live. (Désormais possible via calamares

)

fiche · 21-12-2019 09:34:11

J'ai apporté des réponses aux interrogations de Caribou22 sur le pad relatif à la documentation.

Debian Alain · 21-12-2019 09:59:38

caribou ? tu peux m'inscrire pour le git "les cahiers du débutant buster" ? . merci . envoie moi une confirmation une fois fait .

Caribou22 · 21-12-2019 11:42:23

@fiche : Merci ! Je vais voir ça

@Alain : C'est fait

Debian Alain · 21-12-2019 12:09:16

caribou , j'ai modifié mon mot de passe sur gitlab , du coup , çà fonctionne plus .

tu peux actualiser mon inscription ?

Caribou22 · 21-12-2019 12:16:01

C'est fait. Normalement ça fonctionne même si tu changes ton mot de passe. A quel moment ça bloque ?

Debian Alain · 21-12-2019 12:38:52

git clone git@framagit.org:dflinux/lescahiersdudebutant---buster.git

Clonage dans 'lescahiersdudebutant---buster'...

ssh: connect to host framagit.org port 22: Network is unreachable

fatal: Impossible de lire le dépôt distant.

Veuillez vérifier que vous avez les droits d'accès

et que le dépôt existe.

Caribou22 · 21-12-2019 13:04:58

Une erreur de clés SSH sûrement. Je crois que l'on va arrêter d'utiliser les clés SSH tant qu'il n'y aura pas de vrai tuto compréhensible par tout le monde

Fais plutôt comme ceci :

git clone https://framagit.org/dflinux/lescahiersdudebutant---buster.git

Et lorsque tu feras un git push, ton identifiant et ton mot de passe framagit te seront demandés, tout simplement

Debian Alain · 21-12-2019 13:24:27

j'ai téléchargé les git de DFL et des cahiers .

j'aimerai , au moins un petit peu , travailler sur les cahiers .

tu fais comment ?

Caribou22 · 21-12-2019 13:48:53

Dans le dossier docs, tu as tous les chapitres sous forme de fichiers .md (en markdown). Et les images sont dans le dossier img.

Et pour générer les fichiers PDF, deb et epub, tu exécutes le script ./mklcdd (commande dans le terminal)

Que souhaites-tu faire ? Je t'expliquerai en particulier ce que tu as besoin

Dernière modification par Caribou22 (21-12-2019 13:49:49)

Debian Alain · 21-12-2019 13:59:41

déjà pour commencer , j'aimerai assez visualiser le travail en cours , en couleur (pas en N&B) .

j'ai trouvé , dans "docs" le fichier "les_cahiers_du_debutant.pdf"

j'ai zyeuté un peu :

reste beaucoup de photos de debian 9 à remplacer par leur équivalent debian 10 .

Dernière modification par Debian Alain (21-12-2019 14:40:50)

Caribou22 · 21-12-2019 14:09:24

Tu as le PDF couleur dans le même dossier normalement

https://framagit.org/dflinux/lescahiers … butant.pdf

Debian Alain · 21-12-2019 15:51:15

oui , j'ai trouvé .

comment je visualise mes modifs ?

Caribou22 · 21-12-2019 15:58:16

Tu reconstruit le pdf chez toi avec le script ./mklcdd. Et s'il n'y a pas d'erreur dans tes modifs, il générera le PDF à jour

Debian Alain · 21-12-2019 16:17:41

déjà , à l'origine , sans rien modifier , ./mklcdd fonctionne mal .
il ne crée que une archive tar.gz avec les c. dd au format html .
les fichiers pdf par défaut sont effacés .

./mklcdd

export en PDF depuis les sources MD

--smart/-S has been removed.  Use +smart or -smart extension instead.

For example: pandoc -f markdown+smart -t markdown-smart.

--normalize has been removed.  Normalization is now automatic.

--latex-engine has been removed.  Use --pdf-engine instead.

Try pandoc --help for more information.

ERROR: "les_cahiers_du_debutant.pdf" & "les_cahiers_du_debutant_print.pdf" non générés > vérifiez le pandoc.log

export en ePub depuis les sources MD

--smart/-S has been removed.  Use +smart or -smart extension instead.

For example: pandoc -f markdown+smart -t markdown-smart.

--normalize has been removed.  Normalization is now automatic.

--epub-stylesheet has been removed. Use --css instead.

Try pandoc --help for more information.

ERROR: les_cahiers_du_debutant.epub non généré > vérifiez le pandoc.log

export en HTML depuis les sources MD

--smart/-S has been removed.  Use +smart or -smart extension instead.

For example: pandoc -f markdown+smart -t markdown-smart.

--normalize has been removed.  Normalization is now automatic.

Try pandoc --help for more information.

ERROR: les_cahiers_du_debutant.html non généré > vérifiez le pandoc.log

export en .deb avec le PDF

cp: impossible d'évaluer 'les_cahiers_du_debutant.pdf': Aucun fichier ou dossier de ce type

Cannot copy les_cahiers_du_debutant.pdf to /home/alain/DFLinux/lescahiersdudebutant---buster/docs/paquet_debian/src/equivs.p6Ztaz/install/0/les_cahiers_du_debutant.pdf: No such file or directory

rm: impossible de supprimer 'les_cahiers_du_debutant.pdf': Aucun fichier ou dossier de ce type

mv: impossible d'évaluer '*.deb': Aucun fichier ou dossier de ce type

./mklcdd-pdf donne ceci :

./.mklcdd-pdf

rm : supprimer 'pandoc.log' qui est protégé en écriture et est du type « fichier » ? y

export en PDF depuis les sources MD

--smart/-S has been removed.  Use +smart or -smart extension instead.

For example: pandoc -f markdown+smart -t markdown-smart.

--normalize has been removed.  Normalization is now automatic.

--latex-engine has been removed.  Use --pdf-engine instead.

Try pandoc --help for more information.

ERROR: "les_cahiers_du_debutant.pdf" & "les_cahiers_du_debutant_print.pdf" non générés > vérifiez le pandoc.log

pandoc.log donne ceci :

--smart/-S has been removed.  Use +smart or -smart extension instead.

For example: pandoc -f markdown+smart -t markdown-smart.

--normalize has been removed.  Normalization is now automatic.

--latex-engine has been removed.  Use --pdf-engine instead.

Try pandoc --help for more information.

Dernière modification par Debian Alain (21-12-2019 16:20:06)

Debian-facile

#1 04-09-2019 21:28:30

Documentation de l'ISO DF-Buster

#2 04-09-2019 21:47:06

Re : Documentation de l'ISO DF-Buster

#3 17-12-2019 23:13:42

Re : Documentation de l'ISO DF-Buster

#4 17-12-2019 23:36:39

Re : Documentation de l'ISO DF-Buster

#5 18-12-2019 14:10:27

Re : Documentation de l'ISO DF-Buster

#6 18-12-2019 22:29:14

Re : Documentation de l'ISO DF-Buster

#7 19-12-2019 12:14:59

Re : Documentation de l'ISO DF-Buster

#8 19-12-2019 12:35:30

Re : Documentation de l'ISO DF-Buster

#9 19-12-2019 12:51:28

Re : Documentation de l'ISO DF-Buster

#10 19-12-2019 18:10:59

Re : Documentation de l'ISO DF-Buster

#11 19-12-2019 22:24:44

Re : Documentation de l'ISO DF-Buster

#12 21-12-2019 09:34:11

Re : Documentation de l'ISO DF-Buster

#13 21-12-2019 09:59:38

Re : Documentation de l'ISO DF-Buster

#14 21-12-2019 11:42:23

Re : Documentation de l'ISO DF-Buster

#15 21-12-2019 12:09:16

Re : Documentation de l'ISO DF-Buster

#16 21-12-2019 12:16:01

Re : Documentation de l'ISO DF-Buster

#17 21-12-2019 12:38:52

Re : Documentation de l'ISO DF-Buster

#18 21-12-2019 13:04:58

Re : Documentation de l'ISO DF-Buster

#19 21-12-2019 13:24:27

Re : Documentation de l'ISO DF-Buster

#20 21-12-2019 13:48:53

Re : Documentation de l'ISO DF-Buster

#21 21-12-2019 13:59:41

Re : Documentation de l'ISO DF-Buster

#22 21-12-2019 14:09:24

Re : Documentation de l'ISO DF-Buster

#23 21-12-2019 15:51:15

Re : Documentation de l'ISO DF-Buster

#24 21-12-2019 15:58:16

Re : Documentation de l'ISO DF-Buster

#25 21-12-2019 16:17:41

Re : Documentation de l'ISO DF-Buster

Pied de page des forums