Documentation

Configuration

 1configuration:
 2  branchesDir: branches #where to render your branches, e.g. accessible by https://domain.tld/repo/branches/
 3  favicon: logo.png #where is your favicon in your git repository
 4  footer: <code>git clone {{repo.cloneUrl}}</code> #footer for all pages
 5  generateGitWorktree: true #generate worktree directory or not
 6  header: <h1>{{repo.name}}</h1> #header for all pages
 7  menu: # define your menu
 8    - display: 🏠 Home
 9      link: /
10    - display: 📖 Documentation
11      link: /doc/
12    - display: 🔖 Versions
13      link: /CHANGELOG.html
14    - display: 🐞 Issues
15      link: /boards/issues.html
16    - display: 🚀 Code
17      link: /worktree/
18    - display: ☕ Blog
19      link: /blog/
20    - display: 🗨 Contact
21      link: /contact.html
22  meta: # define metadata for all pages
23    description: GitRoot is a small yet powerfull git forge.
24    fediverse:creator: "@forge@gitroot.dev"
25    og:description: GitRoot is a small yet powerfull git forge.
26    og:title: GitRoot
27  style: simple.min.css # style css for all pages, simple.min.css is embeded but you put a path to your personal css in your git repository
28  layout: #define your own layouts
29    - glob: issues/**/*.md #evey markdown in issues directory will use this layout instead of the default one embeded by apex
30      path: layouts/issues.html #if this path don't exist in git, apex will add default one there, so you have an example up-to-date

Layout variables

Forge

• forge.domain what is your domain (e.g. domain.com)
• forge.externalHttpAddr how to access with web (e.g. https://domain.com)
• forge.externalSshAddr how to clone (e.g. ssh://domain.com/)

Repo

• repo.name repo name (e.g. repo1)
• repo.url full web url (e.g. https://domain.com/repo1)
• repo.cloneUrl how to clone you rrepo (e.g. ssh://domain.com/repo1/)

Apex

• repo.favicon your favicon to add in meta of pages in your git repo (e.g. logo.png)
• repo.faviconType the favicon type mime (e.g. image/png)
• repo.css your css to add in meta of pages in your git repo (e.g. css/default.css)

Page

All variables from front-matter of *.md files are accessibles in layout.

If you add:

1---
2var1: res
3---
4
5# Tile

Then a {{var1}} in a lyout will be rendered has res.