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

Posté par  . Licence CC By‑SA.
Étiquettes :
-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  . É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  . É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  (site web personnel) . É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  . Évalué à 0.

        Alors là, tu me moinsses si tu veux !

        Pour la licence CC-by-NC-SA, le NC se discute, évidemment, surtout pour les didacticiels. C'est une licence que j'applique à mes différents sites. Je vais réfléchir à la modifier, effectivement.

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

      Posté par  (site web personnel) . É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.

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

        Posté par  . Évalué à -2.

        Merci.

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

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

          et pour compléter : que ça n'empêche pas de continuer, de partager, si tu avais des messages dans le pur style linousquèfère genre "fais un blog" pourquoi pas, mais là tu peux continuer. Mais il est vrai que le mieux serait de faire une dépêche pour tout présenter (surtout que ça peu intéresser sur monde) et tes journaux viendront en partie compléter la dépêche finalement.

  • # Commencer par le commencement

    Posté par  (site web personnel) . É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  . É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  (site web personnel) . É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  . É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 à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.