Skip to content

Latest commit

 

History

History
34 lines (26 loc) · 1.94 KB

README.adoc

File metadata and controls

34 lines (26 loc) · 1.94 KB
Raw

ASAM Project Guide - Generator

badge
Important
 This repository contains the generator and general setup for Antora in context of the Project Guide. It does not contain the content itself! This can be found here instead.

Hosted version available at: ASAM Project Guide (Link)

Building locally

To build the Project Guide locally, check out this repository. Next, check out the content repository to a new subfolder (e.g. "asam-project-guide-content"). In order for the generator to use the local sources, edit the 'site.yml' so that each url attribute under content/sources points to that folder (e.g. ./asam-project-guide-content).
If you also want to include specific branches and/or tags (or exclude them), change the other settings accordingly. For more information on how the 'site.yml' works, see the official Antora documentation.

Important
 IF YOU USE THIS REPO TO BUILD LOCALLY, DO NOT PUSH CHANGES RELATED TO THAT TO REMOTE. Make sure only to commit and push changes that are relevant for remote as well, as otherwise the build pipeline will break.
Tip

If you are using VSCode, there is currently no correctly working support for source control of nested git projects. However, there exists a workaround:

  1. Check out the repositories as described above but do not add them to your workspace. If they are already in your workspace, remove them from there.

  2. Next, add the innermost repository (the content repository) to your workspace first.

  3. Then, continue outwards until you added the uppermost repository (the generator).