Hello !
Je suis amené dans mon travail à rédiger énormément de documentation technique.
Ce travail de documentation est parfois très répétitif, surtout au sujet de la mise en page qui doit être faite de façon homogène entre les différents documents.
Je me demandais donc s'il vous connaissiez un soft (si possible libre sous Linux), qui permettrait de rédiger les docs dans un format interne à partir duquel le soft serait capable de générer les docs sous différents formats (HTML, PDF, (…)
Darwin Information Typing Architecture (DITA), est une architecture XML destinée à la création de documents structurés et modulaires. Elle diminue les coûts de production et de traduction, réduit les délais de mise sur le marché et améliore la qualité.
Les impatients trouveront sur le site de ressources pour le rédacteur technique comment mettre en place une chaîne de création et de publication DITA XML libre. Cette chaîne repose sur Emacs et le mode nXML (avec des schémas Relax NG modifiés) et DITA Open Toolkit. La suite de la dépêche détaille l'architecture DITA.
DITA XML est un formidable format pour gérer les projets de documentation. Pour les projets multilingues, cependant, il faut créer un fichier .ditamap, qui contient la structure de table des matières des documents, par version. Ceci entraîne un risque d’erreurs et d’incohérences. Heureusement, une méthodologie appropriée remédie à ce problème.
Script d’automatisation élémentaire sous GPL 3 inside ;-)
Mistra est un organisme de formation composé de consultants spécialisés dans des domaines tels que l'ingénierie logicielle ou l'administration système. C'est cette équipe de consultants qui, petit à petit, rédige de nombreux tutoriels sous licence CC BY-SA 3.0.
La publication de ces tutoriels a pour but d'initier les lecteurs à de nouvelles technologies ou bien de discuter de certains points plus spécifiques. Suivez ces tutoriels et donnez votre avis.
NdM : on peut aussi citer Wikibooks catégorie informatique et Wikiversity catégorie informatique comme cours et tutoriels sous une licence libre.
Bonjour,
Je cherche un aide-mémoire Vi (ou Vim), et un aide-mémoire des principales commandes Unix.
Ce doit être impérativement en français (ce n'est pas pour moi....).
En connaîtriez-vous qui soient dispos sur le net, et faciles d'accès pour des débutants?
Merci.
dlfpiennes, dlfpiens, trolls.
Je viens vers vous, en écrivant ce journal, pour présenter mon PDF Libre.
Pour les plus pressé d'entre vous :
Je tiens un blog depuis quelques temps maintenant, où se côtoie deux de mes passions, programmation et monde Libre. J'ai eu l'occasion de m'intéresser plus récemment au langage Python, en y écrivant une vingtaine de billets. J'ai voulu prendre le temps de les rassembler sous un format PDF, d'un (…)
Doxygen est un générateur de documentation à partir du code source de différents langages. Il est disponible pour les langages suivants : C, C++, C#, Fortran, Java, Objective-C, PHP, Python, IDL, VHDL, TCL et D. Les formats de sorties sont : HTML, LaTeX, RTF, PostScript, PDF (avec les hyperliens), HTML compressé et les pages de manuel Unix.
La liste des utilisateurs est grande, on retrouve KDE, Drupal, DotClear, LLVM, OpenTTD…
Doxygen est compatible avec les conventions de JavaDoc et celles de Qt. Il permet aussi de générer des graphes d’utilisation et d’héritage. Il s’utilise de la manière suivante (exemple en C++) :
/*! Classe d'exemple
* @author Xavier Claude
*/
public class Exemple {
protected:
/*! la description d'un attribut */
std::string s;
public:
/*! La description d'une classe
* @param newS la nouvelle valeur de s
* @return true en cas de succès
*/
bool setS(std::string newS);
}Comme cela fait longtemps que les nouvelles versions de Doxygen n’ont pas été évoquées sur LinuxFr.org, un résumé des nouveautés des dernières versions est disponible en deuxième partie. Il y a bien sûr eu, en plus, beaucoup de corrections de bogues et quelques changements de comportement.
Floss Manuals francophone est fière de vous annoncer la naissance d'un nouveau manuel libre en langue française sur le logiciel libre Scribus, dédié à la mise en page professionnelle.
Au terme d'un BookSprint de 5 jours, 8 auteurs ont produit la première documentation francophone, à jour pour la sortie officielle de la future version 1 .4. Venant de France, du Canada, de Suisse et du Niger, ils ont partagé leurs points de vue culturels et professionnels variés (imprimeur, graphiste, éditeur, auteur) pour fournir une vue large et complète de la publication à l'aide du logiciel. La moitié des personnes présentes étant par ailleurs membres de l'équipe de Scribus, les échanges au sein du groupe auront permis d'apporter des idées d'évolutions originales et de positionner la documentation comme une vraie étape de contribution au développement.
Ont participé :
Les facilitatrices sont :
Le booksprint a été rendu possible grâce au financement de l'Organisation Internationale de la Francophonie et s'est déroulé à Strasbourg du 6 au 10 juillet 2011, dans le cadre des Rencontres Mondiales du Logiciel Libre.
Un livre qui n'a pas l'air trop mal vient de sortir sous le titre "The Architecture of Open Source Applications". Il est composé de 25 chapitres et chaque chapitre détaille un logiciel libre, souvent par un de ses contributeurs majeurs. Chaque application est ainsi décortiqué pour nous en montrer les entrailles. Bref, un excellent voyage du côté obscur du code, ce qu'on a rarement l'occasion de voir.
En prime, le livre est lui-même libre (CC-BY), il est disponible sur Lulu (…)
Salut les moules,
Je suis à la recherche de lectures enrichissantes pour cet été. Dans ma pile de choses à lire, j'ai déjà mis ce ptit fascicule sur l'IA et ce bref opuscule coté musique.
Mais je cherche quelque chose à me mettre sous la dent coté infographie, plus précisément :
Je ne cherche pas forcément des livres, cela dit. Par exemple des entrées vers des ressources présentant la (…)
Les auteurs de Shinken, outil de supervision compatible avec Nagios, viennent de publier leur dernières avancées sur ce projet. Cette version est dans la continuité de ce à quoi ils nous ont habitué, avec de nombreuses nouveautés :
À l'occasion de la publication de Debian Squeeze, nous avons mis à jour la Formation Debian GNU/Linux. Cette mise à jour n'avait pas fait l'objet d'une dépêche, mais je profite d'autres modifications majeures pour présenter toutes ces nouveautés en groupe.
La Formation Debian GNU/Linux est un document destiné aux débutants, essentiellement des utilisateurs avancés de Windows, qui souhaitent apprendre l'utilisation avancée et l'administration de Debian. Nous proposons pour cela une démarche d'installation de Debian pas à pas, en détaillant les notions au fur et à mesure qu'elles interviennent : le logiciel libre, Debian, les périphériques et systèmes de fichiers, l'arborescence, la ligne de commande, le système graphique, les services réseau…
Cette mise à jour a nécessité quelques adaptations mineures pour tenir compte des changements de l'installateur Debian et des logiciels, mais elle a surtout été l'occasion de moderniser notre système de publication et de préparer une nouvelle version au format EPUB.
@startuml
Alice -> Bob: synchronous call
Alice ->> Bob: asynchronous call
@enduml
