#asciidoc

[youronlyoneofcl]

Poll: Which Markup Language Do You Use and Why?

Curious about which markup language is preferred by others for editing documents and taking down notes?

Q:どのマークアップ言語を使用していますか、その理由は何ですか？

文書を編集したりメモを取るために他の人が好むマークアップ言語が気になりますか？

여론조사: 어떤 마크업 언어를 사용하고 그 이유는 무엇인가?

문서를 편집하고 메모하는 데 다른 사람들이 선호하는 마크업 언어가 무엇인지 궁금한가요?

[noknow-ks]

Dear bloggers 📝

Expressiveness:    HTML> AsciiDoc> Markdown

Readability:    AsciiDoc ≒ Markdown> HTML

hmm ... 🧐

[illuminarch]

11 ferramentas de código aberto para escritores

A comunidade de código aberto produz uma grande quantidade de software para diferentes usos. Produção de filmes, carros inteligentes, internet das coisas. Estes são alguns exemplos. Veja a seguir onze ferramentas de código aberto para ajudar  escritores a serem mais criativos.

Por que ferramentas de código aberto para escritores?

Antes de começarmos, gostaria de explicar brevemente por que o…

View On WordPress

[iteman]

[Asciidoctor](http://asciidoctor.org/)を使うと、技術文書や手順書などのドキュメントを簡単にHTMLで公開できますが、ドキュメントが多くなると自分の調べたいキーワードが、どのドキュメントに載っている...

[emasters]

Antora generates static documentation sites from AsciiDoc

A static site generator for making documentation sites from one or more versioned content repositories.

A documentation pipeline that enables docs, product, and engineering teams to create, manage, remix, and publish documentation sites composed in AsciiDoc and sourced from multiple versioned content repositories.

See details at https://antora.org/ and get the code at https://gitlab.com/antora/an…

View On WordPress

[albanmontaigu]

Documenter vos projets autrement avec git et asciidoc

New Post has been published on http://vivihome.net/2016/12/28/documenter-vos-projets-autrement-avec-git-et-asciidoc/

Documenter vos projets autrement avec git et asciidoc

Un collègue m’a fourni une vidéo intéressante sur une manidère différente de gérer une documentation projet : https://youtu.be/1rKgVF5CEEY

Il est vrai que cela fait un moment qu’on tourne autour du pot. Les wikis c’est bien mais le bon logiciel est toujours délicat à trouver. Sans détailler la réflexion ici (peut être une autre fois) il y a toujours une contrainte qui fait que ce n’est jamais parfait…

Je suis donc en train de me pencher sur une mouvance qui me semble intéressante : gérer sa documention as a code. En simplifiant cela veut dire que votre documentation est gérée dans un dépot git, avec un outil de collaboration sympa comme gitlab et  des fichiers sous forme plain text avec une syntaxe simple et lisible comme markdown ou asciidoc (j’ai tendance a préférer le second actuellement).

Cela vous permet d’avoir une documentation ou chacun peut collaborer simplement (coucou pull request). De plus, il se trouve que github et gitlab intègrent les syntaxes asciidoc et markdown en natif, vous pouvez donc déjà naviger dans votre documentation directement sur leur site web.

Le fin du fin sera de générer un site statique joli (avec un moteur de recherche) et si possible une version pdf. C’est la que l’excellent gitbook entre en action.

Enfin, pour mettre la cerise sur le gateau, vous pouvez rebuilder votre site documentaire de manière automatisée avec un job gitlab ci bien senti.

Au passage, pour le job gitlab je me suis construit une image docker gitbook qui m’aide bien.

Cette manière de faire semble s’étendre car même chez owasp an a choisi de construire le nouveau developer guide de cette manière sur github.

Que du bon donc pour l’instant ! A creuser à l’usage.

[alefsym-blog]

Blogging with GitHub Gist

#Byℵ

To view this article on Tumblr, go to its Tumblr permalink page and enable JavaScript. You can also view it (with or without JavaScript) at its Gist permalink page.

[nancym]

Blogging with GitHub Gist

The post below is stored on GitHub and embedded here on Tumblr thanks to Javascript…

  (Note: The floating blue bullets in the embedded text above don't happen in other themes so maybe it's time for me to use something other than the Effector theme.)