Passos realitzats
1. Creació de la pàgina web estàtica
S'ha creat una carpeta web/ amb un fitxer index.html i una carpeta css/.
Fitxers principals:
web/index.html
web/css/style.css
La pàgina principal inclou un enllaç cap a la documentació:
<a href="docs/">Veure documentació MkDocs</a>
2. Creació de la documentació amb MkDocs
S'ha creat el fitxer mkdocs.yml a l'arrel del projecte.
Configuració principal:
site_name: Documentació GitLab Pages
theme:
name: readthedocs
La documentació es troba dins de la carpeta:
docs/
3. Configuració del desplegament
S'ha creat el fitxer .gitlab-ci.yml.
Aquest fitxer fa tres accions principals:
- Instal·la MkDocs.
- Copia la web estàtica a
public/. - Genera la documentació MkDocs dins de
public/docs.
4. Resultat final
El desplegament genera aquesta estructura:
public/
├── index.html
├── css/
└── docs/
Això permet accedir a:
URL_GITLAB_PAGES/
URL_GITLAB_PAGES/docs/