Setting up a local Fedora authoring environment
This guide describes step by step the setup of a local Fedora authoring environment. Workstations with Linux and macOS are directly supported. A graphical user interface is helpful, but not an requirement.
The Fedora publishing system uses plain text files with AsciiDoc formatting for all content. Therefore, you need a text editor to work on it.
Fedora uses git repositories for file storage and version control. Therefore, git must be installed on the workstation. Editing is then done in the git working directory.
In the course of work, one would like to check the formatting and appearance. This requires a minimal display system. Every Fedora docs repository provides this, but it requires a Docker or Podman container.
Basically, you can use any plain text editor you are used to, among others
Very helpful is AsciiDoc syntax highlighting and also already a rough preview of the formatted text. Here the
Atom program editor and the special AsciiDoc editor
AsciiDocFX stand out. Both provide an optional split screen containing a rough preview.
AsciiDocFX provides additionally a editing menue as it is known by text processing software.
Both are FOSS projects and make the software freely available. The Atom project provides the editor for Linux, macOS and Windows. The AsciiDocFX project provides a Java binary as Linux, macOS or Windows installation file that furthermore works on any operating system with a Jave runtime environment.
The git version control system is available for virtually all operating systems. On a Fedora workstation it is installed via dnf. We use the command line only tool here.
[…]$ sudo dnf install git
For other operating systems, use the appropriate installation files.
The preview system requires a container. The container is set up automatically, but a container runtime environment must be available and active.
On a Fedora system, simply install Podman from the Fedora repository.
[…]$ sudo dnf install podman
On macOS or Windows, install Docker CE of the Docker project.
Want to help? Learn how to contribute to Fedora Docs ›