Iscriviti al feed

Free software is becoming increasingly popular with non-technical users and, as a result, good documentation is becoming more important. The greatest barrier to achieving good, free documentation has not been a lack of interested contributors, but the difficulty of the tools required to create and manage regularly updated and complex documents.

Thankfully things have just got a lot easier: Publican has arrived. Red Hat‘s documentation team has been using this tool, which automates the process of creating all the files needed to begin a new document, as well as exports the finished content into many of the most common formats including HTML and PDF. Now they’ve opened it up to the world and it is being hosted by the Fedora Project, whose own documentation team is set to adopt it.

Jared Smith, a member of the Fedora Documentation Project, spent some time talking about his first experiences with Publican:

I probably spent at least a good twenty or thirty hours (or more) setting up the infrastructure for the last DocBook project I started …mostly setting up files (and the various links between them), tweaking the Makefiles, etc. It was not exactly my definition of the word ‘fun’.

So on a whim last night, I figured I’d start checking out Publican and see how long it would take. In less than 15 minutes, I had Publican installed and an existing DocBook document ported over to it (the new revision of the Software Management Guide, as part of the Fedora Documentation Project). You can see the HTML output of my endeavor here, complete with Fedora branding and everything.

You can find out how to get started with Publican on Fedora Hosted site; and once you have done that, why not drop by the Fedora Documentation team and find out how you can help?


Sull'autore

UI_Icon-Red_Hat-Close-A-Black-RGB

Ricerca per canale

automation icon

Automazione

Novità sull'automazione IT di tecnologie, team e ambienti

AI icon

Intelligenza artificiale

Aggiornamenti sulle piattaforme che consentono alle aziende di eseguire carichi di lavoro IA ovunque

open hybrid cloud icon

Hybrid cloud open source

Scopri come affrontare il futuro in modo più agile grazie al cloud ibrido

security icon

Sicurezza

Le ultime novità sulle nostre soluzioni per ridurre i rischi nelle tecnologie e negli ambienti

edge icon

Edge computing

Aggiornamenti sulle piattaforme che semplificano l'operatività edge

Infrastructure icon

Infrastruttura

Le ultime novità sulla piattaforma Linux aziendale leader a livello mondiale

application development icon

Applicazioni

Approfondimenti sulle nostre soluzioni alle sfide applicative più difficili

Original series icon

Serie originali

Raccontiamo le interessanti storie di leader e creatori di tecnologie pensate per le aziende