[FIX] fix bep rendering (#566)

Author: Remi-Gau

.gitignore

@@ -5,7 +5,7 @@ output_gh_summary.png
 
 # ignore for now files that are copied from the bids examples and spe
 docs/examples/
-docs/specification/
+docs/extensions/macros_doc.md
 
 # folders
 *.DS_Store

.remarkignore

@@ -1,3 +1,3 @@
 docs/collaboration/bids_github/
 docs/datasets/index.md
-docs/specification/macros_doc.md
+docs/extensions/macros_doc.md

data/beps/beps.yml

@@ -529,7 +529,7 @@
         - Original issue: [#153](https://github.com/bids-standard/bids-specification/issues/153)
     content:
     -   raw
-    blocking: None
+    blocking:
     google_doc_created: 2023-09-12
     pull_request_created:
     pull_request_merged:

docs/collaboration/contributors.md

@@ -12,7 +12,7 @@ update_from_spec:
 	@echo "  ----------------------------------  "
 	rm -fr docs/specification
 	mkdir -p docs/specification/
-	cp specification/macros_doc.md docs/specification/macros_doc.md
+	cp specification/macros_doc.md docs/extensions/macros_doc.md
 
 update_contributors: package.json
 	@echo "  ----------------------------------  "

makefile

@@ -18,6 +18,8 @@ plugins:
   - open-in-new-tab
   - macros:
       module_name: macros/main
+      # toggle to true if you are in CD/CI environment
+      on_error_fail: true
   - redirects:
       redirect_maps:
         # old links from the old wesbite
@@ -163,7 +165,7 @@ nav:
     -   extensions/general-guidelines.md
     -   extensions/specific-guidelines.md
     -   extensions/submission.md
-    # -   macros: specification/macros_doc.md
+    -   Using MkDocs macros: specification/macros_doc.md
 -   Impact:
     -   impact/index.md
 -   Merch: https://www.teepublic.com/user/bids

mkdocs.yml

@@ -9,5 +9,5 @@
 | :--------: | :---- | :-----  | :-----  | :---------- | :------- |
 {% endif %}
 {% for bep in include %}
-| [BEP {{ bep.number }}]({{ bep.link }}) | {% if bep.display %} {{ bep.display }} {% else %} {{ bep.title }} {% endif %} | {% for content in bep.content %} {{ content }} {% endfor %} | {% for person in bep.leads %} {% if person.email %} [{{ person.given-names }} {{ person.family-names }}](mailto:{{ person.email }}) {% else %} {{ person.given-names }} {{ person.family-names }} {% endif %}<br>{% endfor %}  | {% if bep.status %} {% for item in bep.status %} - {{ item }} <br>{% endfor %} {% endif %}  | {% if bep.blocking %}  {% for item in bep.blocking %} - {{ item }} <br>{% endfor %} {% endif %} |
+| [BEP {{ bep.number }}]({{ bep.link }}) | {% if bep.display %} {{ bep.display }} {% else %} {{ bep.title }} {% endif %} | {% for content in bep.content %} {{ content }} {% endfor %} | {% for person in bep.leads %} {% if person.email %} [{{ person["given-names"] }} {{ person["family-names"] }}](mailto:{{ person.email }}) {% else %} {{ person["given-names"] }} {{ person["family-names"] }} {% endif %}<br>{% endfor %}  | {% if bep.status %} {% for item in bep.status %} - {{ item }} <br>{% endfor %} {% endif %}  | {% if bep.blocking %}  {% for item in bep.blocking %} - {{ item }} <br>{% endfor %} {% endif %} |
 {% endfor %}