Première version de 'unix-initiation'

Posté par  (site web personnel) . Modéré par Mouns.
Étiquettes :
0
21
sept.
2007
Doc
Première version du projet de documentation "unix-initiation". Ce projet consiste en la publication sous une licence libre d'une documentation d'introduction aux systèmes UNIX, réalisée dans le cadre d'un cours en école d'ingénieur.

Pour son cours à l'Esme Sudria, Sylvain Baudry a réalisé une documentation complète sur UNIX à l'intention des élèves. La documentation reprend donc tout les points essentiels à connaître dans un environnement UNIX : mécanisme d'interprétation du shell, redirections, sortie standard, commande de base, exemple de script, utilisation de sed et awk, guide de l'utilisateur vi et emacs, différence de comportements entre les différents shells... Ce texte est une parfaite introduction pour un débutant dans un tel univers.

Le texte du polycopié est rédigé en LaTeX et est désormais publié sous licence GPL, hébergé sur la forge Gna!.

Aller plus loin

  • # Licence et réactualisation

    Posté par  (site web personnel) . Évalué à 6.

    Je viens de parcourir le document qui me paraît très complet.

    Pourquoi l'avoir publié sous licence GPL plutôt qu'une licence orientée documentation comme GFDL ?

    Le fait qu'il date de 2003 ne le rend pas moins intéressant.
    Mais certains points mériteraient d'être réactualisés.
    Par exemple :


    - "KDE", environnement régit par la "Free Software Foundation" livré de base avec Linux, environnement dont la présentation est un savant mélange entre "CDE" et l'"Active Desktop" de Microsoft Corp.

    - "gnome", environnement régit par la "Free Software Foundation" livré de base avec les futures versions de Linux, environnement orienté objet et intégrant roralement les ressources locales et distante sur le bureau.


    (les erreurs d'orthographe sont issues du texte original)
    • [^] # Re: Licence et réactualisation

      Posté par  (site web personnel) . Évalué à 2.

      Merci pour ta remarque... Peux tu éventuellement créer un tâche dans l'outil de Gna! à ce sujet ? ( sinon, je le ferais).

      Pour la licence GPL, c'est plus par facilité qu'autre chose. La FDL demande, je crois, de spécifier des section invariantes, et donc on a lâchement opté pour GPL.

      La dernière mise à jour remonte en effet à 2003 mais l'objectif du projet est justement de nourrir ce document et de le remettre à jour ! ! !
      • [^] # Re: Licence et réactualisation

        Posté par  . Évalué à 2.

        Mais une licence creative commons ne serait-elle pas envisageable?
        • [^] # Re: Licence et réactualisation

          Posté par  (site web personnel) . Évalué à 4.

          licence creative commons, c'est vague : éventuellement la CC--by ou CC-by-sa serait déjà plus clair pour l'avoir en libre.

          La GFDL n'impose pas de sections invariantes, elle ne fait que le permettre (ce qui est lourd car tel que spécifié cela laisse toujours un doute sur la possibilité de les traduire par exemple, et ce qui a valu de longues discussions pour sa compatibilité avec les DFSG [http://www.debian.org/social_contract.fr.html#guidelines]). Le choix de cette licence permettrait de le mettre sans soucis sur wikipedia, notamment http://fr.wikibooks.org/wiki/Accueil cf. [http://fr.wikibooks.org/wiki/Wikilivres:Copyright]

          L'intérêt de la GPL c'est qu'elle définit le source comme étant la "preferred form of the work for making modifications to it" d'après [http://www.gnu.org/licenses/gpl.html] (la forme de cet ouvrage sous laquelle les modifications sont les plus aisées). Pour un PDF, cela permet de demander le format initial (ODT ou LaTeX ici).

          Il est tout à fait possible d'appliquer plusieurs licence à un travail, l'intérêt de travailler upstream étant de pouvoir permettre une diffusion plus large vers d'autres projets qui seraient sous des licences variées. Perso, j'ajoute la licence ArtLibre (proche de la GPL) : http://cookerspot.tuxfamily.org/wikka.php?wakka=WikiLicense
          • [^] # Re: Licence et réactualisation

            Posté par  (site web personnel) . Évalué à 2.

            Je suis d'accord avec toi. Les creative commons, la GFDL... c'est bien compliqué. Je ne comprends pas pourquoi il n'y a pas plus de texte qui sorte sous GPL tout court.

            Malgré le nombre de page de la licence GPL, sa compréhension est claire pour un très grand nombre et elle a montré sa capacité à resisté au temps (et aux tribunaux !).
  • # Hmmmmm

    Posté par  (Mastodon) . Évalué à 6.

    Ce document a l'air très attaché à son école d'origine. Je pense que ça peut représenter un problème pour un éventuel contributeur qui souhaiterait ajouter une partie intéressante pour son contexte ou enlever certaines parties qui lui paraissent inutiles. Par exemple, il y a beaucoup de choses concernant OpenVMS, on sent tout de suite que l'école utilise ce genre de machine (et que ça a sa place), mais pour une initiation plus généraliste, doit-on réellement connaître toutes les variantes de tous les OS du marché ? (D'ailleurs, parler de Windows-NT dans un document intitulé "Initiation à Unix", je trouve ça osé mais encore une fois, c'est certainement une question de contexte)

    Autre remarque, j'ai ouvert le pdf et j'ai commencé à le lire. Déjà, feuilleter 23 pages avant d'arriver au contenu, ça fait sans doute trop. Il vaudrait mieux déplacer toutes les tables des matières et listes à la fin, y compris la longue liste de marques déposées en préface. Ensuite, juste sur la première page, on se demande vraiment si c'est un document d'initiation quand on parle de "process", d'interpréteur de commande (qu'est-ce qu'une commande ? qu'est-ce qu'un intépréteur ?). Ça peut rebuter de vrais débutant de commencer. Ou alors il faut changer le titre. Sur la deuxième page, KDE n'est pas un projet de la FSF (GNOME en revanche l'est bien).

    Je m'arrête là, parce que d'une part, je ne suis pas allé plus loin et d'autre part, on va me répondre "participe" et je n'ai pas le temps de participer. Mais voilà mon premier ressenti quand j'ai ouvert ce document.
    • [^] # Re: Hmmmmm

      Posté par  (site web personnel) . Évalué à 3.

      En effet, tu as bien compris, OpenVMS a une place importante à Sudria. De manière amusante, Sylvain et moi discutions ce matin de retirer ces comparatifs...
      Personnelement, il ne me dérange pas tant que ça, et je pense qu'ils peuvent tjrs servir à celui qui connait unix et qui doit un jour travailler sur VMS :)

      Effectivement, la documentation est une initiation mais à l'adresse d'un publique un peu concerné...

      Merci pour ton premier ressenti.
      • [^] # une petite erreur

        Posté par  (site web personnel) . Évalué à 3.

        Concernant la commande ln, il est faux de dire qu'elle n'existe pas sous Vms, voir la doc
        $ set file/enter

        la doc est à
        http://h71000.www7.hp.com/doc/83FINAL/9996/9996pro_188.html

        extrait
        /ENTER=new-filespec
        The new-filespec parameter is used to create either an alias or a hard link for the file specified in the SET FILE command. For detailed information about using hard links and aliases, see the HP OpenVMS System Manager's Manual.

        ウィズコロナ

        • [^] # Re: une petite erreur

          Posté par  (site web personnel) . Évalué à 1.

          J'ai ajouté ta remarque à la liste des tâches du projet, si tu as le temps de faire toi même la correction et de proposer un patch ça serait parfait ! Merci !
          • [^] # Re: une petite erreur

            Posté par  (site web personnel) . Évalué à 2.

            Volontiers

            Tu as noté que je t'avais envoyé un message avec une autre proposition de modif ?

            ウィズコロナ

            • [^] # Re: une petite erreur

              Posté par  (site web personnel) . Évalué à 1.

              J'ai reçu bcp de propositions de modif et de patch depuis la publication de ce message.... Mais je n'ai pas l'impression d'en avoir reçu une sous le nom de 'palm123' , à tout hasard peux me renvoyer ton message ?
  • # c' est la rentrée

    Posté par  (Mastodon) . Évalué à 4.

    et c' est une bonne date pour publier de bonnes feuilles.

    merci, même d' un non-étudiant, quelques révisions ne font pas de mal :)
  • # LaTeX

    Posté par  (site web personnel) . Évalué à 3.

    Ne parlons pas ici du contenu mais de la forme.
    Je vais faire hurler les défenseurs de LaTeX, mais pour être franc, je n'aime pas beaucoup l'aspect du document obtenu.
    Il y a des marges énormes qui mangent la moité de la largeur de la page. Les jeux de caractères me paraissent vieillots (Je sais, LaTeX gère les ligatures).

    Historiquement LaTeX fut une énorme innovation et un énorme progrès mais je crois que du XML avec la DTD Docbook est bien préférable car on sépare complètement la forme du fond, ce que LaTeX ne fait que partiellement.

    Un document XML Docbook http://fr.wikipedia.org/wiki/DocBook permet de générer du HTML, du PDF... et du LaTeX ! Il offre une souplesse bien plus grande.
    Maintenant que ODF est devenu une norme ISO, son usage pourrait être préconisé pour ce genre de document car sa structure est voisine du XML Docbook.
    • [^] # Re: LaTeX

      Posté par  (site web personnel) . Évalué à 2.

      Super un volontaire pour porter tout le poly en DocBook !!! ;)

      Effectivement, c'est une question de goût... Perso, j'aime LaTex comme DocBook... mais l'objectif ici n'est pas de faire un portage technique mais surtout de nourrir le poly... Mais bon si le projet motive quelqu'un pourquoi pas !
    • [^] # Re: LaTeX

      Posté par  (site web personnel) . Évalué à 7.

      LaTeX gère très bien les largeurs de marges ... il suffit juste que l'auteur le fasse :)
      http://www.ac-poitiers.fr/math/tex/pratique/marges/marges.ht(...)

      De plus pour une doc destinée aux étudiants, les marges larges sont pratique pour noter des trucs, mais bon cela n'est que mon avis ! :)

      Sinon vraie question !
      Existe t'il un éditeur DocBook aussi efficace que Kile et/ou Texmaker ?
    • [^] # Re: LaTeX

      Posté par  . Évalué à 4.

      LaTeX gère très bien la séparation entre forme et fond, seulement faut que l'auteur s'en préoccupe.

      En plus les marges par défaut rendent le texte beaucoup plus lisible. Au début, je ralais sur ces marges, mais quand j'ai tenté de faire le même document avec ooo, il n'y a pas photo.
    • [^] # Re: LaTeX

      Posté par  (site web personnel) . Évalué à 8.

      LaTeX est fait par défaut pour faire des poly si on prends le format book. Or un Poly, il faut le coller, le couper... Donc avoir des marges !

      Ensuite, comme il a été dis, changer les marges est super facile. Pour être mauvaise langue, il est aussi super facile de faire un document XML avec de grande marge !

      Au niveau Police de caractère, je suis désolé mais les polices LaTeX sont bien plus belles. Simplement, on est tous tellement habitués aux autres polices qu'un document LaTex pourrait 'choquer'. Personnellement, je préfère très largemenbt ces polices à celles par défaut de Firefox ou d'OpenOffice.

      Enfin, pour la forme et le fond, c'est du FUD de chez FUD... Il a déjà été répondu plein de fois ici même que c'est faux. S'il n'y avait que 5% des ressources mis sur le HTML et dérivée (XHTML, DocBOOK...) qui était mis sur LaTeX, cela ferait longtemps que les quelques erreurs initiales qui restent auraient été corrigé.

      Le XML dans un éditeur, c'est CHIANT. Un fichier de configuration en XML, c'est CHIANT... Le XML est un langage fait pour la machine et pour les interfaces graphiques, pas pour l'homme. Va écrire des équations méthématiques en XML et écrit les en LaTeX et tu changera ton opinion sur la qualité humaine du LaTeX.

      J'ai vu très peu de thèse écrites en DocBook dans vi alors que je peux t'affirmer qu'il y en a plusieurs milliers qui ont été faites ainsi sous LaTeX.
      • [^] # Re: LaTeX

        Posté par  . Évalué à 3.

        il y a également que ces polices ne sont pas très agréable pour une lecture à l'écran.

        Only wimps use tape backup: real men just upload their important stuff on megaupload, and let the rest of the world ~~mirror~~ link to it

        • [^] # Re: LaTeX

          Posté par  (site web personnel) . Évalué à 2.

          Exact, lire le PDF obtenu à l'écran est assez désagréable car les fontes passent mal et les marges excessives font un très mauvais usage de l'écran.
          C'est pour cela que je pense que DocBook offre de meilleures possibilités que LaTeX qui a été conçu avant tout pour être imprimé.
          • [^] # Re: LaTeX

            Posté par  (site web personnel) . Évalué à 4.

            Encore une fois, c'est une option de compilation. Il est tout à fait possible d'avoir des fontes LaTeX propre avec la sortie PDF. Il suffit de rajouter le usepackage qui va bien au début du fichier LaTeX. Je ne vois pas en quoi DocBook change quoi que ce soit à ce problème puisque dans plein de cas, DocBook est formatté via TeX !

            Ensuite, on dira ce que l'on voudra mais une présentation faite avec beamer, ca a une autre allure.
        • [^] # Re: LaTeX

          Posté par  . Évalué à 5.

          Il suffit de modifier un include dans le fichier principal TeX pour avoir des fontes "plus au gout du jour"

          \usepackage{times}
          \renewcommand{\normalfont}{\sffamily} % Pour avoir de "l'arial"

          La font par défaut est quant à moi la meilleure pour l'impression, et la lisibilité. CM est notamment la seule fonte gérant correctement les ligatures

          Enfin bon c'est un vieux con qui parle ...
          • [^] # Re: LaTeX

            Posté par  (site web personnel) . Évalué à 3.

            Si ça peut te rassurer, je serais plutot ok avec le "vieux con" ;)

            Je vais lancer une discussion interne au projet sur la retaille des marges et eventuellement le changement de la font. Merci pour vos commentaires !
  • # Le guide du ROOTard

    Posté par  . Évalué à 4.

    Cette doc me fait penser a une autre doc du même genre "Le guide du ROOTard" malheureusement elle se fait veille (+ de 10ans !!! une version ici : http://www.cpt.univ-mrs.fr/info/Guide_Rootard.html)
    Mais je ne suis pas le seul a s'inquièté de sa non MAJ : http://linuxfr.org/~spotty/22975.html

    En tous cas bonne continuation pour voter doc :-)

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.