This repository hosts the site builder for https://docs.centos.org/. It pulls content from other repositories defined in the site.yml Antora playbook, builds them together using a structure defined in this repository, and applies a UI bundle to them, creating the whole site. Submit PRs and issues to this repository for publishing fixes. The other repositories are:
- CentOS_Docs_Web_UI for the site's user interface (e.g. CSS styling) sources
- CentOS_Installation_Guide - the content repository for the Installation Guide
- CentOS_Docs_Web - the repository that holds the built site. Do not use that repository for anything but publishing updates.
To add a new content repository, you must:
- Add the repository to the
site.ymlfile. Use the repositories already defined for guidance. - Add a link to the front page of the new repository into
pages/homepage/modules/ROOT/pages/index.adoc. Note that you will need to do this in raw HTML, the page uses a passthrough block. Again, use the other links already on the page for guidance. - Build this repository and publish - see below.
This repo includes scripts to build and preview the contents of this repository. Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions.
To build and preview the site, run:
$ ./build.sh && ./preview.sh
The result will be available at http://localhost:8080.
$ sudo dnf install docker
$ sudo systemctl start docker && sudo systemctl enable docker
- Build the site using the
build.shscript. - Open the CentOS_Docs_Web and switch to branch
prod. - Copy the
public/folder of this repository into theen-USfolder of thedocs-webrepository. - Ask someone to pull from the repository and republish. (In the future this will happen automatically, this is only a temporary workaround.)