La questione "strumenti per scrivere e mantenere la documentazione" è praticamente chiusa. Alla fine ho optato per #asciidoc che è una favola da usare e fa tutto quello che ci serve (grazie ad #asciidoctor). Il team ha approvato e gradito e io mi sono divertito un mondo a fare prove, creare temi e piccoli script in #bash per facilitarne la conversione. Ho imparato un bel po' di cose e mi sono divertito. Vorrei che fosse sempre così!

Grazie a TUTTI per i suggerimenti! ❤️

#techDocs #docs

The best writing tip I learned as an adult is to write one sentence per line.

It's such a simple but powerful thing that I've memorized the URL of an essay where I first heard about it:

https://sive.rs/1s

Check it out!

(The #AsciiDoctor people also recommend this practice. https://asciidoctor.org/docs/asciidoc-recommended-practices/#one-sentence-per-line)

#writing #LifeHack #ProTip #AsciiDoc

Because reasons, I'm updating my CV.

Switching from LaTeX to #asciidoc and #asciidoctor has been a big win.

Probably the best illustrations of this:

* Went from 43 files (42 of which confused me) to 9 (all of which I understand).

* I just need asciidoctor-pdf; no need to worry about which LaTeX packages I need, and how different OSes name them.

* I actually understand how to change the appearance of the CV now.

The end result doesn't look as fancy, but I think it's easier to read and it's certainly much easier to produce.

Cuando el diablo no sabe qué hacer mata moscas con el rabo:

Una extension #asciidoctor para generar pdf de facturas a partir de un fichero CSV

https://github.com/jagedn/asciidoctor-invoices

Calendar Antora extension

an extension for Antora, now holiday is comming

#asciidoctor #antora

https://puravida-asciidoctor.gitlab.io/asciidoctor-extensions/#_calendar

@lelibreedu J'utilise AsciiDoctor avec bonheur depuis 6 ans, pour mes rapports, cahiers des charges, sites web statics (comme https://grimoire.d12s.fr ). Ce format est une évolution du Markdown avec une meilleure gestion des tableaux, du placement des images... #Asciidoc #AsciiDoctor et puis c'est entre autre le format des commentaires du noyau Linux :-)

@tbroyer I had fun implementing this asciidoctor.js PDF solution. Perfectly valid if you convert all your sources to #asciidoc first (#pandoc, #kramdown) and want an ‘offline’ solution

https://matklad.github.io/2019/05/19/consider-using-asciidoctor-for-your-next-presentation.html

#asciidoctor

#asciidoctor-vscode just received a major upgrade!

https://github.com/asciidoctor/asciidoctor-vscode/releases/tag/v3.0.5

Using the #asciidoc language in a #vscode / #vscodium workflow for #NoteTaking AND #Documenting AND plain #Writing stuff down has never been this much fun!

So, what do people use nowadays to make slideshows from Markdown, Asciidoc, or HTML that can ideally render to PDF in addition to HTML?
(if it doesn't do PDF, don't hesitate to suggest anyway!)

#slides #presentation #html #markdown #asciidoc #asciidoctor

Trivial Pursuit – API MarkDown (2)

Fasst drei Jahre nach dem ersten Beitrag zum eigenen API MarktDown ergibt sich ein zweiter Beitrag zum Thema. Bei der Durchsicht der eigenen Projekte fiel auf, dass in dem Projekt rest-markdown-plugin noch immer FreeMarker als Template-Engine verwendet

https://schegge.de/2023/05/trivial-pursuit-api-markdown-2/

#Bibliotheken #Java #AsciiDoc #Asciidoctor #CongoCC #FreeMarker #FreshMarker #Java #JavaCC21 #MarkDown #OpenApi #Template #TemplateEngine

If you are keen on #InformationManagement you should really try out the #AsciiDoc ‘includes’ and ‘tags’ features and stop #TextDuplication for your documentation in its tracks.
TIP: organizing your CV/resume in reusable ‘file snippets’ is a great first project
https://asciidoctor.org/

Works with any IDE including #VSCode #VSCodium
https://github.com/asciidoctor/asciidoctor-vscode

#asciidoctor-pdf generates exquisite PDF exports from your efforts.
https://docs.asciidoctor.org/pdf-converter/latest/

#LearnAsciiDoc #BetterWriting

Never thought I would enter into a rabbithole with custom #asciidoctor extensions of all things. And now I'm using it for my #hugo websites. Pretty interesting...

I've been trying out #asciidoctor with custom extensions in #ruby for some time. I didn't expect I would like the language. 😀

Yesterday I got a postcard send from #FOSDEM - what a great surprise and Idea!

Thanx @ahus1@fostodon.org 😀 for all your great work in the #asciidoctor community!

Heute Abend online:

Docs Repair Cafe

https://www.meetup.com/continuous-documentation-regulars/events/290277704/

Ever wondered how to fix an annoying itch in your tech setup? This is the first edition of a "Docs Repair Cafe", where users can discuss what troubles them in their current setup. In the process, they'll get ideas and tips on how to fix it from other participants.

#AsciiDoc
#AsciiDoctor
#TechDoc
#TechnicalDocumentation
#TechnischeDokumentation

I _really_ need to convert my site to something better than #ikiwiki, that's the truth. I'm really leaning towards #jekyll with the #asciidoctor plugin, but I conversion is going to take SO much time … really not looking forward to that.

Calendario Cientifico Escolar

A scientific anniversary for each day of the year

- twitter
- telegram
- an #asciidoctor #antora static site

https://calendario-cientifico-escolar.gitlab.io/en/en/index.html

RutasPorMadrid, a blog made with

- #OpenData
- #groovy
- #nodejs
- #asciidoctor
- #hugo
- #OpenStreetMap

(a post with the how-to coming soon)

https://blog.rutas-por-madrid.es/

List continuations are just horrible in #asciidoctor. Extremely fragile IMHO and have to refresh page 138708 times to get it right :(

We need a Typora-like editor for #asciidoctor 😅