Merge branch 'tags'

.gitignore

@@ -13,4 +13,5 @@ __pycache__/
 _build/
 dist/
 downloads/
+pages/tags/
 test-reports/

Makefile

@@ -1,11 +1,12 @@
 .PHONY: all clean docs linkcheck livedocs publish size
 SOURCE_DIR = pages
 BUILD_DIR  = _build/html
+TAGS_DIR   = pages/tags
 
 all: clean docs linkcheck size publish
 
 clean:
-	rm -rf $(BUILD_DIR)
+	rm -rf $(BUILD_DIR) $(TAGS_DIR)
 
 docs:
 	sphinx-build $(SOURCE_DIR) $(BUILD_DIR)
@@ -19,6 +20,7 @@ livedocs: clean
 		--watch templates \
 		--watch pages/conf.py \
 		--ignore '*.tmp' \
+		--ignore '**/tags/*' \
 		--port 8181
 
 publish:

pages/about_site.md

@@ -1,5 +1,6 @@
 # {fas}`code` About this site
-{bdg-primary}`Draft`
+```{tags} status:draft, docs
+```
 
 This is a markdown-based static site generated with [Sphinx](https://www.sphinx-doc.org) and
 [MyST](https://myst-parser.readthedocs.io). The theme is modified from

pages/conf.py

@@ -13,10 +13,12 @@ templates_path = ['../templates']
 
 # Sphinx extensions
 extensions = [
+    "sphinx.ext.autosectionlabel",
     'sphinx.ext.autosummary',
     'sphinx.ext.extlinks',
     'sphinx_copybutton',
     'sphinx_design',
+    'sphinx_tags',
     'myst_parser',
     'notfound.extension',
 ]
@@ -34,6 +36,22 @@ myst_enable_extensions = [
 copybutton_prompt_text = r'>>> |\.\.\. |\$ '
 copybutton_prompt_is_regexp = True
 
+# autosectionlabel_prefix_document = True
+
+# Sphinx-tags settings
+tags_create_tags = True
+tags_extension = ['md']
+tags_output_dir = 'tags'
+tags_overview_title = 'Tags'
+tags_page_title = 'Tags'
+tags_create_badges = True
+tags_badge_colors = {
+    'python': 'primary',
+    'coding': 'secondary',
+    'status:*': 'info',
+    '*': 'dark',
+}
+
 # HTML general settings
 # html_favicon = join('../assets', 'favicon.ico')
 html_css_files = [

pages/index.md

@@ -14,10 +14,11 @@ Other places you can find me:
 <!-- Hidden ToC tree to populate sidebar -->
 ```{toctree}
 :hidden:
+:maxdepth: 1
 
 open_source
 succulents
 photography
 about_site
 asdf
-```
+```

pages/open_source.md

@@ -1,5 +1,6 @@
 # {fab}`python` Open Source Projects
-{bdg-secondary}`In Progress`
+```{tags} status:in-progress, coding, python
+```
 
 I develop and maintain a few open source projects, mainly python libraries. Here are a few of the
 most interesting ones:

pages/photography.md

@@ -1,5 +1,6 @@
 # {fas}`camera` Photography
-{bdg-primary}`Draft`
+```{tags} status:draft, photography
+```
 
 I dabble in [nature photography](https://flickr.com/photos/jcook83), mostly macro photography of
 insects, spiders, and other tiny curiosities.

pages/succulents.md

@@ -1,5 +1,6 @@
 # {fas}`seedling` Cactus and Succulent Plants
-{bdg-primary}`Draft`
+```{tags} status:draft, photography, plants
+```
 
 One of my interests is gardening, particularly cactus and succulents plants.
 I participate in the [Cactus and Succulent Society](https://cactusandsucculentsociety.org), and grow

requirements.txt

@@ -6,3 +6,4 @@ sphinx-autobuild>=2021.3
 sphinx-copybutton>=0.5
 sphinx-design>=0.2
 sphinx-notfound-page>=0.8
+sphinx-tags>=0.2