Journal Comment jouer sa feignasse avec DITA von…, heu, DITA XML

Posté par (page perso) . Licence CC by-sa.
Tags :
-4
15
mar.
2012

Je continue mon journal qu'il-est-pas-intéressant-DocBook-c'est-mieux sur DITA XML ;-)

Aujourd'hui, la question que vous vous posez tous et toutes : mais comment que je fais pour factoriser au maximum mon contenu source et pour publier différentes versions d'un document, selon son public, en ne faisant varier que certaines portions du contenu susdit, tout en conservant des parties communes et jouer ainsi ma feignasse qui veut pas faire de copier-coller comme tout le monde ?

Le didacticiel publié sur mon site à moi de ressources pour le rédacteur technique prend pour exemple un document qui avertit les électriciens et les plombiers, deux nobles métiers dont on ne chantera jamais assez l'utilité, sur les dangers d'effectuer certaines opérations dans le cadre de leur activité respective.

C'est le respective qui compte. Hors de question, en effet, d'avertir un plombier sur les dangers que court un électricien et vice-versa, ces respectables professionnels étant parfois, bouché pour l'un, et électrique pour l'autre.

  • # En quoi est-ce inintéressant siouplaît ?

    Posté par (page perso) . Évalué à -2.

    Hé, sérieux, les gensses qui me moinssent peuvent-ils me dire en quoi un tuto sous licence CC pour utiliser un schéma XML n'est pas intéressant ? Je ne plaisante pas, ça m'intéresse, sans ironie aucune.

    • [^] # Re: En quoi est-ce inintéressant siouplaît ?

      Posté par . Évalué à 2.

      Les gens qui moinssent c'est sans doute parce que tu postes pas mal de journaux à propos du même sujet en peu de temps.

      "DITA von…"

      Je vois que je suis pas le seul à y penser quand je vois ce nom :)

      • [^] # Re: En quoi est-ce inintéressant siouplaît ?

        Posté par (page perso) . Évalué à 1.

        Ah oui, merci, c'est peut-être ça. Mais ça me paraît difficile d'avoir un retour si je poste les nouveaux tutos en commentaire du journal initial, ou je me trompe ?

        En tout cas, je compte faire une dépêche quand j'aurai fait à peu près tous les tutos auxquels je pense et puis souffler un peu.

        Pour le DITA von… c'est lorsque j'ai commencé à m'intéresser au schéma XML que j'ai appris l'existence de cette charmante personne :-)

    • [^] # Re: En quoi est-ce inintéressant siouplaît ?

      Posté par (page perso) . Évalué à 3.

      un tuto sous licence CC

      plus précisément sous licence CC-by-NC-SA ; n'est-ce pas se tirer une balle dans le pied de promouvoir un logiciel libre avec du non libre ?

      Je ne t'ai pas moinssé pour autant ;-)

    • [^] # Re: En quoi est-ce inintéressant siouplaît ?

      Posté par (page perso) . Évalué à 10.

      Je pense pour deux raisons :

      • ça n'intéresse simplement pas les gens (à part ici, jamais entendu parlé de dita, et faire des docs en xml …)
      • A chaque fois c'est 3 lignes pour dire en gros : allez lire sur mon site/blog. Et ça c'est, en général, assez mal considéré. Non que ce ne soit pas pertinent, en général il n'y a pas de lien obligatoire, une question de forme.
      • (oui un troisième point) faut pas trop se préoccuper de la note, si tu reste entre -5 et 5 j'aurais surtout tendance à dire que c'est neutre, juste que ça ne passionne pas grand monde, donc il suffit qu'un ou deux n'apprécie pas et hop du descend la note.
  • # Commencer par le commencement

    Posté par (page perso) . Évalué à 4.

    Plutôt que de proposer des tutos qui supposent une connaissance préalable de ce langage inconnu d'à peu près tout le monde, ne serait-il pas plus pertinent de commencer par le commencement, en publiant une vraie dépêche :

    • indiquant ce que c'est que de DITA XML en des termes compréhensibles avec de vrais morceaux d'exemples ;
    • donnant des pointeurs pour découvrir DITA XML d'une façon appropriée pour le public que nous sommes (à savoir, découvrir le langage, et surtout pas découvrir un éditeurs graphique utilisant ce langage en cachant les détails) ?

    Parce qu'encore une fois, DITA XML c'est peut-être très cool, j'ai compris que c'était un genre de concurrent à DocBook que je connais bien, mais je n'ai pas réussi à trouver ne serait-ce qu'un exemple de code DITA. Alors bon…

    • [^] # Re: Commencer par le commencement

      Posté par (page perso) . Évalué à 1.

      En fait, parfois, j'aime bien commencer par la fin, en l'occurrence, de ma connaissance pratique d'un format que j'apprécie. Je croyais que le général était disponible. Grâce à tes remarques, je m'aperçois que non. Ces journaux me permettent de bien peaufiner une future dépêche.

      Donc, pour résumer, DITA XML est un fork de DocBook. DocBook est très bien, mais, comme son nom l'indique, il a pour modèle le livre monolithique. DITA propose un nouveau modèle : celui du document modulaire, comme un jeu de Lego. C'est la différence majeure, tout le reste est secondaire.

      Pour le code, j'ai completé la page Wikipedia. J'y renvoie également vers mon blog, car ce n'est pas le lieu de publier des tutoriels et j'aurais bien aimé en trouver quand j'ai commencé !

      Des sources pour découvrir le langage :

      DITA Version 1.1 Language Specification
      DITA-sourced documentation

  • # DocBook ?

    Posté par (page perso) . Évalué à 7.

    Je continue mon journal qu'il-est-pas-intéressant-DocBook-c'est-mieux sur DITA XML ;-)

    Je ne suis pas sûr que DocBook soit mieux. En revanche DocBook, contrairement à DITA XML, c'est abordable, dans le sens où il existe des cours et des bouquins pour découvrir et débuter. Alors que DITA, ben, rien vu de tel.

    – DITA XML c'est cool, rédigez en DITA !
    – Ah, intéressant, où ça ressemble à quoi au juste ?
    – …
    – Ohé, ça ressemble à quoi, tu aurais un exemple ?
    – Non, désolé.
    – Euh, bon, ben, désolé mais je retourne à DocBook, revenez quand vous aurez un exemple.
    – DITA XML c'est cool, rédigez en DITA !
    – C'est bon, on a compris, DITA XML c'est cool, tu as un exemple maintenant ?
    – Non, toujours pas.
    – Suuuper, et un cours pour apprendre au moins ?
    – Euh, non plus.
    – Bon, ben, je reste à DocBook, revenez quand vous aurez quelque chose, j'ai mieux à faire, moi.

    • [^] # Re: DocBook ?

      Posté par (page perso) . Évalué à -1.

      Il y a également toute une littérature.

      (Voir mon commentaire précédent pour des liens.)

      • [^] # Re: DocBook ?

        Posté par . Évalué à 3.

        Voici un exemple de ce qui est attendu : ditaa. C'est une page web très claire, avec un exemple de document en entrée et de la sortie correspondante. Ce n'est quand même pas insurmontable de faire la même chose pour le format proposé dans le journal.

Suivre le flux des commentaires

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