Files needed to generate RetroAchievements.org documentation pages
The RetroAchievements Documentation Project is divided into two parts:
The wiki is where the documents are created and edited. Anyone (with a github account) is able to edit the wiki's content. Then, if you have something to share, please edit the wiki!
The RAdocs website has (almost) the same content as the wiki, but with a more pleasant look. The content of this website is generated by its maintainers using the wiki's content as input.
When a change is made in the wiki this change is NOT instantaneously reflected in the docs. The convertion is performed by a maintainer from time to time.
[No need to continue reading if you're not a RAdocs maintainer.]
Windows
You'll need to install Cygwin, and the following packages: git, python3, python3-pip and libyaml-devel.
After installing the dependencies, open a terminal and perform this command:
pip install --upgrade mkdocs mkdocs-material
Clone the repo with this command:
git clone --depth 1 --recursive https://github.com/RetroAchievements/docs
Note: don't forget the --recursive option.
It creates a folder named docs. Just "enter" it using:
cd docs
The generate-docs.sh is the script you'll be using to generate the pages for RAdocs. Run it with --help and see how it works. It's pretty straightforward.
Note: only the wiki pages listed on the wiki's sidebar will be converted into RAdocs pages.