Pàgina d'inici¶

Plantilla d'estil per a crear pàgines d'inici (landing) modernes i consistents.

Activació¶

Afegeix landing: true al front matter. Es recomana també amagar la navegació lateral i el TOC.

docs/index.md (front matter)

---
title: Títol del lloc
icon: material/home
hide:
    - navigation
    - toc
landing: true
---

Estructura¶

/// html | div.landing-hero
ETIQUETA SUPERIOR
{ .eyebrow }

# Títol principal

Subtítol descriptiu.
{ .subtitle }

[:octicons-arrow-right-24: Acció principal](primer.md){ .md-button .md-button--primary } [Acció secundària](segon.md){ .md-button }
{ .actions }
///

Paràgraf d'introducció opcional.

/// html | div.grid.cards
-   :material-icon:{ .lg .middle } __Targeta 1__

    ---

    Descripció breu.

    [:octicons-arrow-right-24: Veure-ho](pagina.md)

-   :material-icon:{ .lg .middle } __Targeta 2__

    ---

    Descripció breu.

    [:octicons-arrow-right-24: Veure-ho](altra.md)
///

Components del hero¶

Element	Sintaxi
Etiqueta superior	`Text { .eyebrow }`
Títol	`# Text`
Subtítol	`Text { .subtitle }`
Botons	`[Text](url){ .md-button .md-button--primary }` agrupats amb `{ .actions }`

Exemple¶

docs/index.md

---
title: Inici
icon: material/home
hide:
    - navigation
    - toc
comments: true
landing: true
---

/// html | div.landing-hero
Tema MkDocs
{ .eyebrow }

# MaterialX for MkDocs per [@joapuiib](https://github.com/joapuiib)

Tema personalitzat basat en MaterialX, dissenyat per al material didàctic dels mòduls professionals. Configuracions, extensions i components reutilitzables.
{ .subtitle }

[:octicons-arrow-right-24: Comença](features/index.md){ .md-button .md-button--primary } [:fontawesome-brands-github: GitHub](https://github.com/joapuiib/mkdocs-material-joapuiib){ .md-button }
{ .actions }
///

Aquest lloc web recull les configuracions i extensions realitzades sobre el tema [MaterialX](https://jaywhj.github.io/mkdocs-materialx/) utilitzades per a la creació del [material didàctic dels diferents mòduls professionals](https://joapuiib.github.io/fp/), així com la documentació de les característiques implementades i les proporcionades pel tema original.

/// html | div.grid.cards
-   :material-star-four-points:{ .lg .middle } __Característiques__

    ---

    Components, blocs i estils del tema basats en MaterialX i extensions de PyMdown.

    [:octicons-arrow-right-24: Veure característiques](features/index.md)

-   :material-puzzle:{ .lg .middle } __Extensions__

    ---

    Extensions de Python-Markdown personalitzades: numeració, codi col·lapsable, emoji.

    [:octicons-arrow-right-24: Veure extensions](extensions/index.md)

-   :material-power-plug:{ .lg .middle } __Plugins__

    ---

    Plugins de MkDocs personalitzats: badges, filters, functions, environment, section icons.

    [:octicons-arrow-right-24: Veure plugins](plugins/index.md)
///