Δημιουργία νέου περιεχομένου τεκμηρίωσης
This section describes how to add a completely new piece of documentation that covers a new area in its entirety. This spans several pages and is usually associated with the creation of a new, dedicated repository. A local working environment is best suited for this. But it is also possible to use the web IDE of various GIT forges.
Before you start following this procedure, review all the requirements listed in Prerequisites.
Documentation repository configuration
| Αν και μπορείτε να δημιουργήσετε ένα νέο αποθετήριο ή να χρησιμοποιήσετε ένα υπάρχον, προτείνουμε να ξεκινήσετε από το παρεχόμενο πρότυπο αποθετηρίου αν δεν είστε εξοικειωμένοι με το Antora. |
Create your new repository for the new documentation set, or ask someone to create one for you. You can host this repository anywhere but we recommend using GitLab where you can use Fedora groups to control write access to the repository. Depending on the topic, it might be preferable to host it under the Fedora Docs namespace.
Στο GitLab, μπορείτε να χρησιμοποιήσετε την επιλογή New project > Create from template > Group και να επιλέξετε Documentation Template από τη λίστα.
Εάν δεν χρησιμοποιείτε το GitLab, κλωνοποιήστε χειροκίνητα το πρότυπο αποθετηρίου και αντιγράψτε το περιεχόμενο στο νέο σας αποθετήριο.
📄 antora.yml
📄 site.yml
📂 modules
📂 ROOT
📄 nav.adoc
📂 pages
📄 index.adoc
📄 another-page.adoc
In the new repository, edit the antora.yml configuration file in the repository root. The file contains comments that point out which parts you need to change. At a minimum, always change the name and title.
Το name είναι αυτό που θα καθορίσει την τελική διεύθυνση URL της τεκμηρίωσής σας. Για παράδειγμα: docs.fedoraproject.org/el/<name>/
|
Additionally, edit the site.yml configuration file. Note that this file is only used when building a local preview of your content set - on the website it is overridden by the site-wide site.yml configuration. The only directives you need to edit in this file are the title and start_page.
At this point, the initial configuration is complete. You can push these changes to the newly created repository (or make a pull request if you do not have the required rights) and start working on writing the actual documentation.
Writing documentation
Μερικοί χρήσιμοι σύνδεσμοι τεκμηρίωσης:
If your documentation is made of several pages, you can list them in the nav.adoc. This file will then be used to build the navigation menu on the left side of docs.fp-o.
While you’re writing, you can use the local preview to check the resulting document.
Publish a new documentation module
Once the repository is set up, and initial content added, it is ready to be published.
Documentation modules published on docs.fp-o are all listed in the main Antora playbook.
To add a new documentation module, you will need to add its repository to the content.sources list:
content:
sources:
- url: https://gitlab.com/path/to/new/repository.git
branches: main (1)
start_path: docs (2)
| 1 | The default branch is set to master. If your repository is using any other name (main for instance), you need to specify it here. <.> This setting is optional. If the documentation files are stored in a subdirectory on your repository (/docs/ for instance), you must set its relative path here, without leading or trailing slashes. If it is located at the root level, as documented on this page, you can omit this parameter. |
You can either create a Merge Request with these changes, or if you do not feel comfortable editing this file, create a ticket on the Fedora Docs Website repository, and the Documentation Team will handle that part for you.
|
If you do not get any update to your Merge Request or ticket after 5 days, get in touch with the Docs Team. |
Want to help? Learn how to contribute to Fedora Docs ›