Move assets under root dir

.gitignore

@@ -1,95 +1,16 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
 *$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-pip-wheel-metadata/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
+*.py[cod]
 .cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.mypy_cache/
-.pytest_cache/
-test-reports/
-
-# Translations
-*.mo
-*.pot
-
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-# pyenv
-.python-version
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Editors
-.~*
 .idea/
+.mypy_cache/
+.nox/
+.pytest_cache/
+.venv
 .vim/
 .vscode/
-
-# Sphinx
-docs/_build/
-docs/modules/
+.~*
+__pycache__/
+_build/
+dist/
+downloads/
+test-reports/

Makefile

@@ -1,12 +1,12 @@
 .PHONY: clean docs livedocs
 
 clean:
-	rm -rf docs/_build
+	rm -rf _build
 
 docs:
-	sphinx-build docs docs/_build/html
+	sphinx-build pages _build/html
 
 livedocs:
-	sphinx-autobuild docs docs/_build/html -a \
+	sphinx-autobuild pages _build/html -a \
 		--ignore '*.tmp' \
 		--port 8181

README.md

@@ -1,5 +1,5 @@
-# Test
-Placeholder Sphinx doc outline
+# jwcook's tilde.team page
+Markdown-based static site generated with Sphinx and MyST
 
 Prerequisites:
 * python 3.8+

pages/conf.py

@@ -8,8 +8,8 @@ needs_sphinx = '4.0'
 master_doc = 'index'
 source_suffix = ['.md', '.rst']
 version = release = '0.0.1'
-html_static_path = ['_static']
-exclude_patterns = ['_build']
+html_static_path = ['../assets']
+exclude_patterns = ['_build', 'README.md']
 templates_path = ['_templates']
 
 # Sphinx extensions
@@ -31,22 +31,20 @@ myst_enable_extensions = [
 ]
 
 # HTML general settings
-# html_favicon = join('_static', 'favicon.ico')
+# html_favicon = join('../assets', 'favicon.ico')
 html_css_files = [
     'fonts.css',
     'style.css',
     'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.1.1/css/all.min.css',
 ]
 html_title = 'jwcook\'s home page'
-# html_logo = '_static/logo.png'
+# html_logo = '../assets/logo.png'
 html_show_copyright = False
 html_show_sphinx = False
 
-# notfound_default_version = 'stable'
+# HTML theme settings
 pygments_style = 'gruvbox-light'
 pygments_dark_style = 'gruvbox-dark'
-
-# HTML theme settings
 html_theme = 'furo'
 html_theme_options = {
     # 'light_logo': 'logo-light.webp',
@@ -55,11 +53,11 @@ html_theme_options = {
     'light_css_variables': {
         'font-stack': 'JetBrainsMono',
         'color-brand-primary': '#b57614',
-        'color-brand-content': '#79740e',
+        'color-brand-content': '#076678',
     },
     'dark_css_variables': {
         'font-stack': 'JetBrainsMono',
         'color-brand-primary': '#fabd2f',
-        'color-brand-content': '#b8bb26',
+        'color-brand-content': '#83a598',
     },
 }