Dummy pagina voor het Afsprakenstelsel iWlz

Afsprakenset iWlz op basis van registers

Zie publicatie https://zandbak_rr.gitlab.io/dummy2/

Hier komt een andere inhoud en lokatie voor.

issue fix

[[TOC]]

Opbouw pagina's en repository

basis

Het beheer van de content voor de publicatie is momenteel gebaseerd op het gebruik van onderstaande open source componenten:

• GitLab Pages: official documentation](https://docs.gitlab.com/ce/user/project/pages/).
• HUGO SSG (Static Site Generator) waarbij i.c.m GitLab Pages
• HUGO Book Theme

Hugobook template:

• https://geekdocs.de
• https://github.com/thegeeklab/hugo-geekdoc

Bijwerken content

Ga naar folder content in de repository. En pas de Markdown bestanden aan.

Onderstaande Mindmap geeft de generieke indeling weer.

@startmindmap
+ content
++[#lightblue] _index.md
++ afsprakenstelsel
+++ inleiding
++++[#lightblue] _index.md
++++[#lightblue] sectie1.md
++++[#lightblue] sectie(n).md
+++ organisatiebeleid
++++[#lightblue] _index.md
++++[#lightblue] ....md
@endmindmap

In bovenstaande figuur staan de verschillende onderdelen waaruit de content is opgebouwd / kan worden opgezet:

• direct onder folder content de site-pagina content in een _index.md

• de folder afsprakenstelsel met daarin alle hoofdstukken uit het te publiceren "boek"

• de hoofdstukken als folders onder docs

• in elk 'hoofdstuk' folder

  • de hoofdstuk-pagina content in een _index.md
  • de hoofdstuk-sectie content in 1 of meerdere ...md (s)

PlantUML diagrammen embedden in Markdown:

Zet hiervoor de inhoud van de puml tussen de speciale plantuml-syntax: (bijvoorbeeld uml-diagram)

      ```plantuml
      @startuml
      puml-inhoud
      @enduml
      ```

Gebruik van HUGO Geekdoc Theme

Korte samenvatting (van de tot nu toe) meest gebruikte speciale elementen HUGO Book Theme.

Front Matter

In een SSG zoals HUGO kunnen pagina's lokaal worden geconfigureerd met zogenaamde Front Matter variabelen die aan het begin van de pagina kunnen worden opgegegeven. Hieronder een voorbeeld met de meest voorkomende variabelen.

---
title: "<Titel-weergave in (sub)menu>"
bookCollapseSection: <true/false>
weight: <Nummerieke volgorde in (sub)menu>
---

Variabele	Omschrijving toepassing
title	Titel die in het linker (sub)menu zal worden weergegeven
bookCollapseSection	Waarde true plaatst een > achter de titel in het (sub)menu. Betekenis is dat het (sub)menu nog kan worden uitgeklapt met onderliggende submenu's. De waarde false (of variabele geheel weglaten) betekent dat eventuele submen's direct uitgeklapt worden getoond
weight	In een _index.md (hoofd-pagina) betekent de volgorde van de hoofdstuk-pagina ten opzichte van de andere hoofdstuk-pagina's op hetzelfde niveau. In de overige sectie-pagina's de volgorde binnen het hoofdstuk waaronder deze valt.

Shortcodes

Met Shortcodes kan de standaard Markdown-tekst worden uigebreid met specifieke opmaak binnen het Theme.

Hints

Bekijk voor alle mogelijkehden de documentatie op Geekdocs

De Hint shortcode kan worden gebruikt als informatie/waarschuwings/let op! block.
Er zijn 5 soorten om uit te kiezen: important, warning,dancautionger. note en tip

{{< hint type=[note|tip|important|caution|warning] (icon=gdoc_github) (title=GitHub) >}}
**Markdown content**  
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
{{< /hint >}}

Columns

{{< columns >}} <!-- begin kolommen block -->
# Linker Content
Lorem markdownum insigne...

<---> <!-- scheiding tussen kolommen -->

# Midden Content
Lorem markdownum insigne...

<---> <!-- scheiding tussen kolommen  -->

# Rechter Content
Lorem markdownum insigne...
{{< /columns >}} <!-- einde kolommen block -->

Tabs

Met Tabs kan je content met elkaar gerelateerde of vanuit verschillende contexten of onderdelen organiseren, bijvoorbeeld een onderdeel van een handleiding voor de verschillende ondersteunde platforms (MacOS, Linux en Windows).

{{< tabs "unieke naam content" >}}
{{< tab "MacOS" >}}

# MacOS Content

{{< /tab >}}
{{< tab "Linux" >}}

# Linux Content

{{< /tab >}}
{{< tab "Windows" >}}

# Windows Content

{{< /tab >}}
{{< /tabs >}}

GitLab CI/CD

This project's static Pages are built by GitLab CI/CD, following the steps defined in .gitlab-ci.yml.

Read more at Hugo's documentation.

Troubleshooting

CSS is missing! That means two things:

• Either that you have wrongly set up the CSS URL in your templates.
• Or your static generator has a configuration option that needs to be explicitly set in order to serve static assets under a relative URL.

Hugo fails to build the website

If the version of hugo or hugo_extended is 0.92.2 or later, you may have problems building the website.

Generics were introduced in Go 1.18, and they broke some features in the newer versions of Hugo. For now, if you use hugo or hugo_extended versions 0.92.2 or later, you might encounter problems building the website. To resolve the problem:

1. Edit your .gitlab-ci.yaml file.
2. Identify the line that declares the Hugo version.
3. Change the value to :0.92.2.
4. Save your changes

For more information about this issue:

• This issue is tracked in Gitlab Hugo template fails CI/CD build with "latest" docker version.
• For discussions about fixing the problem in Hugo, and proposals to potentially resolve these issues, read proposal: spec: allow type parameters in methods.