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?
Sobre el autor
Navegar por canal
Automatización
Las últimas novedades en la automatización de la TI para los equipos, la tecnología y los entornos
Inteligencia artificial
Descubra las actualizaciones en las plataformas que permiten a los clientes ejecutar cargas de trabajo de inteligecia artificial en cualquier lugar
Nube híbrida abierta
Vea como construimos un futuro flexible con la nube híbrida
Seguridad
Vea las últimas novedades sobre cómo reducimos los riesgos en entornos y tecnologías
Edge computing
Conozca las actualizaciones en las plataformas que simplifican las operaciones en el edge
Infraestructura
Vea las últimas novedades sobre la plataforma Linux empresarial líder en el mundo
Aplicaciones
Conozca nuestras soluciones para abordar los desafíos más complejos de las aplicaciones
Programas originales
Vea historias divertidas de creadores y líderes en tecnología empresarial