GitRoot

Craft your forge, Build your project, Grow your community freely

Want to merge v0.5-plugins

Please add description of your work here.

When your changes are ready to be reviewed, change the status from ‘status: draft’ to ‘status: review’.

Push 3 commits

Add user for branch v0.5-plugins (d000ea43484f3630ae90ad6358266dcb459e17cd)

 1--- a/.gitroot/users.yml
 2+++ b/.gitroot/users.yml
 3@@ -38,6 +38,7 @@
 4   - name: startBlog
 5   - name: slide
 6   - name: v0.5
 7+  - name: v0.5-plugins
 8   users:
 9   - pseudo: GitRoot
10     avatar: ""
11@@ -224,3 +225,13 @@
12     - ""
13     ssh:
14     - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHk+AMq9/FbuwoJXJ1xoClIOtucWwY3+KX0bcnwXMVNm
15+v0.5-plugins:
16+  branches:
17+  - name: v0.5-plugins
18+  users:
19+  - pseudo: Romain Maneschi
20+    avatar: ""
21+    emails:
22+    - romain@gitroot.dev
23+    ssh:
24+    - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHk+AMq9/FbuwoJXJ1xoClIOtucWwY3+KX0bcnwXMVNm

:bug: update issue

(ff498506d0a198eea8029bc21406580b058b6a2c)

 1--- a/issues/1f97-hop_display_time.md
 2+++ b/issues/1f97-hop_display_time.md
 3@@ -1,6 +1,6 @@
 4 ---
 5 id: "1f97"
 6-priority: 44
 7+priority: 46
 8 assignee: null
 9 status: v0.6.0
10 ---

1--- a/plugins/scope_gitroot.md
2+++ b/plugins/scope_gitroot.md
3@@ -40,4 +40,3 @@
4 
5 - [silo](name/silo.md)
6 - [stigma](name/stigma.md)
7-

:memo: v0.5.0 plugins blog post

(07f51c2cabee365d5b0efa9c510aea433e38fcf1)

 1--- a/app/plugins/apex/doc.md
 2+++ b/app/plugins/apex/doc.md
 3@@ -13,6 +13,7 @@
 4 ```yaml
 5 configuration:
 6   branchesDir: branches #where to render your branches, e.g. accessible by https://domain.tld/repo/branches/
 7+  language: en #the <html lang="en"> property
 8   favicon: logo.png #where is your favicon in your git repository
 9   footer: <code>git clone {{repo.cloneUrl}}</code> #footer for all pages
10   generateGitWorktree: true #generate worktree directory or not
11@@ -74,7 +75,7 @@
12 var1: res
13 ---
14 
15-# Tile
16+# Title

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

 1
 2- +- [app/plugins/stigma/CHANGELOG.md](../app/plugins/stigma/CHANGELOG.md)
 3```diff
 4--- a/app/plugins/stigma/CHANGELOG.md
 5+++ b/app/plugins/stigma/CHANGELOG.md
 6@@ -1,9 +1,9 @@
 7 ---
 8-pluginName: Silo
 9-pluginBaseline: Some silos store grain. Our Silo stores your boards.
10-homepage: /app/plugins/silo/
11-docpage: /app/plugins/silo/doc.html
12-changelog: /app/plugins/silo/CHANGELOG.html
13+pluginName: Stigma
14+pluginBaseline: Some stigmas receive pollen to ensure a seed's authenticity. Our Stigma receives commits to ensure their signature's authenticity.
15+homepage: /app/plugins/stigma/
16+docpage: /app/plugins/stigma/doc.html
17+changelog: /app/plugins/stigma/CHANGELOG.html
18 ---
19 
20 # Changelog

 1--- a/app/plugins/stigma/doc.md
 2+++ b/app/plugins/stigma/doc.md
 3@@ -1,9 +1,9 @@
 4 ---
 5-pluginName: Silo
 6-pluginBaseline: Some silos store grain. Our Silo stores your boards.
 7-homepage: /app/plugins/silo/
 8-docpage: /app/plugins/silo/doc.html
 9-changelog: /app/plugins/silo/CHANGELOG.html
10+pluginName: Stigma
11+pluginBaseline: Some stigmas receive pollen to ensure a seed's authenticity. Our Stigma receives commits to ensure their signature's authenticity.
12+homepage: /app/plugins/stigma/
13+docpage: /app/plugins/stigma/doc.html
14+changelog: /app/plugins/stigma/CHANGELOG.html
15 ---
16 
17 # Documentation

 1--- a/plugins/name/apex_code.md
 2+++ b/plugins/name/apex_code.md
 3@@ -2,8 +2,8 @@
 4 name: apex_code
 5 purl: pkg:gitroot/gitroot/apex_code@0.0.5?checksum=sha256:9e1e2ea42d2bbf1c91f74b8c3f3beb3e4b5f242006080c8eed734e82ddbb425f&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 6 homepage: https://gitroot.dev/app/plugins/apex/code/
 7-doc: https://gitroot.dev/app/plugins/apex/doc.html
 8-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
 9+doc: https://gitroot.dev/app/plugins/apex/code/doc.html
10+changelog: https://gitroot.dev/app/plugins/apex/code/CHANGELOG.html
11 ---
12 
13 Apex_code convert code into html.

 1--- a/plugins/name/apex_markdown.md
 2+++ b/plugins/name/apex_markdown.md
 3@@ -1,9 +1,9 @@
 4 ---
 5 name: apex_markdown
 6 purl: pkg:gitroot/gitroot/apex_markdown@0.0.5?checksum=sha256:8477d0f4817a53a0ff27589fc11d88182234aa94a93a6ad23acd9a73e1d82dab&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 7-homepage: https://gitroot.dev/app/plugins/apex/
 8-doc: https://gitroot.dev/app/plugins/apex/doc.html
 9-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
10+homepage: https://gitroot.dev/app/plugins/apex/markdown/
11+doc: https://gitroot.dev/app/plugins/apex/markdown/doc.html
12+changelog: https://gitroot.dev/app/plugins/apex/markdown/CHANGELOG.html
13 ---
14 
15 Apex_markdown convert markdown into html, use [apex_code](./apex_code.md) for code and [apex_mermaid](./apex_mermaid.md) for mermaid charts.

 1--- a/plugins/name/apex_mermaid.md
 2+++ b/plugins/name/apex_mermaid.md
 3@@ -1,9 +1,9 @@
 4 ---
 5 name: apex_mermaid
 6 purl: pkg:gitroot/gitroot/apex_mermaid@0.0.2?checksum=sha256:67ae4633da5e7f6eac83f5842caca0ab91f3769a872c68e83292cf9873e4ede8&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 7-homepage: https://gitroot.dev/app/plugins/apex/
 8-doc: https://gitroot.dev/app/plugins/apex/doc.html
 9-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
10+homepage: https://gitroot.dev/app/plugins/apex_mermaid/
11+doc: https://gitroot.dev/app/plugins/apex_mermaid/doc.html
12+changelog: https://gitroot.dev/app/plugins/apex_mermaid/CHANGELOG.html
13 ---
14 
15 Apex_mermaid convert mermaid script into html (svg).

Report

🔵 gitroot-apex-0.0.5 for 07f51c2cabee365d5b0efa9c510aea433e38fcf1

🔴 gitroot-stigma-0.0.2 for 07f51c2cabee365d5b0efa9c510aea433e38fcf1

Commits are bad signed!

🔵 gitroot-apex-0.0.5 for dc1d646e365066cab9b7f47032d42473328fa297

Push 2 commits

:memo: v0.5.0 plugins blog post

(4858a1dca5ca257a7a7414c0317718316c0f9df9)

1--- a/.gitroot/allowed_signers
2+++ b/.gitroot/allowed_signers
3@@ -9,3 +9,4 @@
4 gitroot@zonorti.net ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDjFn0pkzW5CXR3S7CogABylodecuXIUwbEYSrnMeVYs zon@zon-linuxstigma@gitroot.dev ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOCaZRYBeoGj9VZmo+ijmGwSLVpZrshKXhjCimcw/Fyn
5 gitroot-stigma@gitroot.dev ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMp6Av4C3269w6iBbVSjwU0DNjFWWYze3dH5PNeznEq7
6 gitroot-silo@gitroot.dev ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHJktF9qtOHAUYZBXUQzh/9tWOiTuogZaYh1zvDkUlLK
7+gitroot-grafter@gitroot.dev ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAEDBENhT2wc9P7hWmnkbso/QyV0qmmQOyJa9EZfhuea

 1--- a/.gitroot/users.yml
 2+++ b/.gitroot/users.yml
 3@@ -1,6 +1,7 @@
 4 owner:
 5   branches:
 6   - name: main
 7+  - name: v0.5-plugins
 8   users:
 9   - pseudo: GitRoot
10     avatar: ""
11@@ -80,3 +81,13 @@
12     - gitroot-apex_mermaid@gitroot.dev
13     ssh:
14     - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJeelBC7t1HL45uY0+gRap15lbMBdLd5iTmhtpgPzDNj
15+v0.5-plugins:
16+  branches:
17+  - name: v0.5-plugins
18+  users:
19+  - pseudo: Romain Maneschi
20+    avatar: ""
21+    emails:
22+    - romain@gitroot.dev
23+    ssh:
24+    - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHk+AMq9/FbuwoJXJ1xoClIOtucWwY3+KX0bcnwXMVNm
25\ No newline at end of file

 1--- a/app/plugins/apex/doc.md
 2+++ b/app/plugins/apex/doc.md
 3@@ -13,6 +13,7 @@
 4 ```yaml
 5 configuration:
 6   branchesDir: branches #where to render your branches, e.g. accessible by https://domain.tld/repo/branches/
 7+  language: en #the <html lang="en"> property
 8   favicon: logo.png #where is your favicon in your git repository
 9   footer: <code>git clone {{repo.cloneUrl}}</code> #footer for all pages
10   generateGitWorktree: true #generate worktree directory or not
11@@ -74,7 +75,7 @@
12 var1: res
13 ---
14 
15-# Tile
16+# Title

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

 1
 2- +- [app/plugins/stigma/CHANGELOG.md](../app/plugins/stigma/CHANGELOG.md)
 3```diff
 4--- a/app/plugins/stigma/CHANGELOG.md
 5+++ b/app/plugins/stigma/CHANGELOG.md
 6@@ -1,9 +1,9 @@
 7 ---
 8-pluginName: Silo
 9-pluginBaseline: Some silos store grain. Our Silo stores your boards.
10-homepage: /app/plugins/silo/
11-docpage: /app/plugins/silo/doc.html
12-changelog: /app/plugins/silo/CHANGELOG.html
13+pluginName: Stigma
14+pluginBaseline: Some stigmas receive pollen to ensure a seed's authenticity. Our Stigma receives commits to ensure their signature's authenticity.
15+homepage: /app/plugins/stigma/
16+docpage: /app/plugins/stigma/doc.html
17+changelog: /app/plugins/stigma/CHANGELOG.html
18 ---
19 
20 # Changelog

 1--- a/app/plugins/stigma/doc.md
 2+++ b/app/plugins/stigma/doc.md
 3@@ -1,9 +1,9 @@
 4 ---
 5-pluginName: Silo
 6-pluginBaseline: Some silos store grain. Our Silo stores your boards.
 7-homepage: /app/plugins/silo/
 8-docpage: /app/plugins/silo/doc.html
 9-changelog: /app/plugins/silo/CHANGELOG.html
10+pluginName: Stigma
11+pluginBaseline: Some stigmas receive pollen to ensure a seed's authenticity. Our Stigma receives commits to ensure their signature's authenticity.
12+homepage: /app/plugins/stigma/
13+docpage: /app/plugins/stigma/doc.html
14+changelog: /app/plugins/stigma/CHANGELOG.html
15 ---
16 
17 # Documentation

 1--- a/plugins/name/apex_code.md
 2+++ b/plugins/name/apex_code.md
 3@@ -2,8 +2,8 @@
 4 name: apex_code
 5 purl: pkg:gitroot/gitroot/apex_code@0.0.5?checksum=sha256:9e1e2ea42d2bbf1c91f74b8c3f3beb3e4b5f242006080c8eed734e82ddbb425f&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 6 homepage: https://gitroot.dev/app/plugins/apex/code/
 7-doc: https://gitroot.dev/app/plugins/apex/doc.html
 8-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
 9+doc: https://gitroot.dev/app/plugins/apex/code/doc.html
10+changelog: https://gitroot.dev/app/plugins/apex/code/CHANGELOG.html
11 ---
12 
13 Apex_code convert code into html.

 1--- a/plugins/name/apex_markdown.md
 2+++ b/plugins/name/apex_markdown.md
 3@@ -1,9 +1,9 @@
 4 ---
 5 name: apex_markdown
 6 purl: pkg:gitroot/gitroot/apex_markdown@0.0.5?checksum=sha256:8477d0f4817a53a0ff27589fc11d88182234aa94a93a6ad23acd9a73e1d82dab&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 7-homepage: https://gitroot.dev/app/plugins/apex/
 8-doc: https://gitroot.dev/app/plugins/apex/doc.html
 9-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
10+homepage: https://gitroot.dev/app/plugins/apex/markdown/
11+doc: https://gitroot.dev/app/plugins/apex/markdown/doc.html
12+changelog: https://gitroot.dev/app/plugins/apex/markdown/CHANGELOG.html
13 ---
14 
15 Apex_markdown convert markdown into html, use [apex_code](./apex_code.md) for code and [apex_mermaid](./apex_mermaid.md) for mermaid charts.

 1--- a/plugins/name/apex_mermaid.md
 2+++ b/plugins/name/apex_mermaid.md
 3@@ -1,9 +1,9 @@
 4 ---
 5 name: apex_mermaid
 6 purl: pkg:gitroot/gitroot/apex_mermaid@0.0.2?checksum=sha256:67ae4633da5e7f6eac83f5842caca0ab91f3769a872c68e83292cf9873e4ede8&registry=https:%2F%2Fgitroot.dev%2Freleases%2F0.5.0
 7-homepage: https://gitroot.dev/app/plugins/apex/
 8-doc: https://gitroot.dev/app/plugins/apex/doc.html
 9-changelog: https://gitroot.dev/app/plugins/apex/CHANGELOG.html
10+homepage: https://gitroot.dev/app/plugins/apex_mermaid/
11+doc: https://gitroot.dev/app/plugins/apex_mermaid/doc.html
12+changelog: https://gitroot.dev/app/plugins/apex_mermaid/CHANGELOG.html
13 ---
14 
15 Apex_mermaid convert mermaid script into html (svg).

:ok_hand: thanks for review

(35fac0d50f1b2c751710337a262ac66ca9f3b52c)

 1--- a/blog/version-0.5.0-plugins.md
 2+++ b/blog/version-0.5.0-plugins.md
 3@@ -13,19 +13,19 @@
 4 
 5 In the [release 0.5.0 blog post](./version-0.5.0.md) I have only talked about the GitRoot core code. But GitRoot is a forge where plugins take a lot of space. In the future I want to decouple GitRoot and its plugins. I hope to stabilize the plugin-sdk, release them, so that you will be able to create your own plugins.
 6 
 7-But today, GitRoot and [officials plugins](../plugins/scope_gitroot.md) are linked by the version. So let me present what they can do in this new version.
 8+But today, GitRoot and [officials plugins](../plugins/scope_gitroot.md) are linked by the version. So let me explain what they can do in this new version.
 9 
10 ## All plugins are compatible with the 0.5.0
11 
12-All plugins are compatible with the 0.5.0 plugin-sdk. What does that mean? Every time you see a **BREAKING** and `plugin` in the [chagelog](../CHANGELOG.md), it means I had to change the code of the plugin-sdk and recompile plugins with that new code (sometimes I need to change the code of the plugin, sometimes not). So when you see `compatible with gitroot plugin-sdk 0.5.0` in the changelog of a plugin, it means that the plugin is good to run inside this GitRoot version.
13+All plugins are compatible with the 0.5.0 plugin-sdk. What does that mean? Every time you see a **BREAKING** and `plugin` in the [changelog](../CHANGELOG.md), it means I had to change the code of the plugin-sdk and recompile plugins with that new code (sometimes I need to change the code of the plugin, sometimes not). So when you see `compatible with gitroot plugin-sdk 0.5.0` in the changelog of a plugin, it means that the plugin is good to run inside this GitRoot version.
14 
15 I'll present here only the most important features, for details you can read the changelog of each plugin.
16 
17 ## Firefly in zig
18 
19-Firstevel, let me introduce [Firefly](../plugins/name/firefly.md): add URLs to call and Firefly will generate beautiful status pages for them. Yes, it's a status page directly integrated into your forge, so no need to depend on a third-party service. Of course, it's useful only if the app observed is not on the same host as your forge. So it's totally useless for GitRoot. But as an example, you can see the [status page of gitroot on gitroot](https://gitroot.dev/status/).
20+First, let me introduce [Firefly](../plugins/name/firefly.md): add URLs to call and Firefly will generate beautiful status pages for them. Yes, it's a status page directly integrated into your forge, so no need to depend on a third-party service. Of course, it's useful only if the app observed is not on the same host as your forge. So it's totally useless for GitRoot. But as an example, you can see the [status page of gitroot on gitroot](https://gitroot.dev/status/).
21 
22-![Screenshot of the firefly plugin, it's a status plugin, we see gitroot.dev is up and running, also @forge@gitroot.dev (gotosocial of gitroot) is running.](https://gitroot.dev/branches/v0.5/blog/version-0.5.0-plugins-firefly.png)
23+![Screenshot of the firefly plugin, it's a status plugin, we see gitroot.dev is up and running, also @forge@gitroot.dev (gotosocial of gitroot) is running.](https://gitroot.dev/branches/v0.5-plugins/blog/version-0.5.0-plugins-firefly.png)
24 
25 I'm proud because it's my first code in the [zig](https://ziglang.org/) language. Not everything is perfect, of course, but I love the language itself, so I will make other plugins and rework them when needed. If you are Zig lovers too, don't hesitate to help me.
26 
27@@ -50,6 +50,9 @@
28 
29 This means that you select the scope and name of the PURL plugin and render the name into the title. A way to add metadata into the rendered list is to use the new `metadata` property.
30 
31+> [!NOTE]
32+> The silo plugin use the [standard regexp](https://pkg.go.dev/regexp) from go to extract selects.
33+
34 With all of that, dynamic boards can be created. From files to index files with metadata, you can create indexes of indexes. An example is the [scope page](https://gitroot.dev/plugins/scope.html). Silo takes all plugins from the [plugins/name directory](https://gitroot.dev/worktree/plugins/name/index.html), generates a page which is an index of all scopes, and then generates a page for each. Today only the [gitroot scope](../plugins/scope_gitroot.md) exists, but I hope for a lot more in the future.
35 
36 Not related, but a good addition to the Silo plugin is the `custom` data format. It permits to render each element in the format you want (by default, only list and table were possible). I use it to render the [blog posts index](../blog/).
37@@ -128,3 +131,5 @@
38 After that, I want to better render Git in the web. A lot of missing concepts need to be rendered, `commit`, `branch` are the first ones. So I will add an `apex_git` plugin. And if I have time, an `apex_gitroot` plugin to render specific GitRoot files like `users.yml`, `plugins.yml` or `repositories.yml`.
39 
40 I have grouped multiple related issues in the [apex board](../boards/status_apex_git.md). That will be my priority, but of course, as I change my mind a lot, that's not a promise of what will be done.
41+
42+_Special thanks to `Ryuno-Ki` from the [#gitroot:matrix.org](https://matrix.to/#/#gitroot:matrix.org) Matrix room for reviewing and correcting this article. Want to help with future posts? Join us in the room!_

Report

🔵 gitroot-apex-0.0.5 for 35fac0d50f1b2c751710337a262ac66ca9f3b52c

🔵 gitroot-apex-0.0.5 for 89bfc66ad42ece6dbc48cfaf0d685875358eefa8