WIP: Add blog-style 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/conf.py

@@ -17,6 +17,7 @@ extensions = [
     'sphinx.ext.extlinks',
     'sphinx_copybutton',
     'sphinx_design',
+    'sphinx_tags',
     'myst_parser',
     'notfound.extension',
 ]
@@ -34,6 +35,20 @@ myst_enable_extensions = [
 copybutton_prompt_text = r'>>> |\.\.\. |\$ '
 copybutton_prompt_is_regexp = 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,6 +14,7 @@ Other places you can find me:
 <!-- Hidden ToC tree to populate sidebar -->
 ```{toctree}
 :hidden:
+:maxdepth: 1
 
 open_source
 succulents

pages/open_source.md

@@ -1,6 +1,9 @@
 # {fab}`python` Open Source Projects
 {bdg-secondary}`In Progress`
 
+```{tags} 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,6 +1,9 @@
 # {fas}`camera` Photography
 {bdg-primary}`Draft`
 
+```{tags} 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,6 +1,9 @@
 # {fas}`seedling` Cactus and Succulent Plants
 {bdg-primary}`Draft`
 
+```{tags} 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
 and photograph some plants in a small indoor garden.

requirements.txt

@@ -6,3 +6,6 @@ sphinx-autobuild>=2021.3
 sphinx-copybutton>=0.5
 sphinx-design>=0.2
 sphinx-notfound-page>=0.8
+# TODO: switch to pypi version if/when changes are merged
+#sphinx-tags>=0.2
+git+https://github.com/JWCook/sphinx-tags.git