chore: Sync with template

SilverRainZ · SilverRainZ · commit 16abae185e55 · 2024-01-27T23:34:48.000+08:00
diff --git a/.cruft.json b/.cruft.json
@@ -1,6 +1,6 @@
 {
   "template": "https://github.com/sphinx-notes/cookiecutter",
-  "commit": "93c85ed7fe6dc87e11ffd024b762a3c8c9a83a1b",
+  "commit": "0b7d8aa478b37114cef369a217bd1d463e369d37",
   "checkout": null,
   "context": {
     "cookiecutter": {
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -1,4 +1,4 @@
-# This file is generated from sphinx-notes/template.
+# This file is generated from sphinx-notes/cookiecutter.
 # You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 include LICENSE
diff --git a/Makefile b/Makefile
@@ -1,4 +1,4 @@
-# This file is generated from sphinx-notes/template.
+# This file is generated from sphinx-notes/cookiecutter.
 # You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 LANG = en_US.UTF-8
@@ -46,7 +46,7 @@ upload-test: dist
 	$(PY) -m twine upload --repository testpypi $</*
 
 # Keep up to date with the latest template.
-# See also https://github.com/sphinx-notes/template.
+# See also https://github.com/sphinx-notes/cookiecutter.
 .PHONY: update-template
 update-template:
 	$(PY) -m cruft update
diff --git a/README.rst b/README.rst
@@ -1,4 +1,4 @@
-.. This file is generated from sphinx-notes/template.
+.. This file is generated from sphinx-notes/cookiecutter.
    You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 ===============
@@ -17,7 +17,7 @@ sphinxnotes-any
    :target: https://pypi.python.org/pypi/sphinxnotes-any
    :alt: PyPI Package
 
-.. image:: https://img.shields.io/pypi/dw/sphinxnotes-any
+.. image:: https://img.shields.io/pypi/dm/sphinxnotes-any
    :target: https://pypi.python.org/pypi/sphinxnotes-any
    :alt: PyPI Package Downloads
 
diff --git a/docs/Makefile b/docs/Makefile
@@ -1,4 +1,4 @@
-# This file is generated from sphinx-notes/template.
+# This file is generated from sphinx-notes/cookiecutter.
 # You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 # Minimal makefile for Sphinx documentation
diff --git a/docs/_images/.gitkeep b/docs/_images/.gitkeep
diff --git a/docs/_schemas/confval.py b/docs/_schemas/confval.py
diff --git a/docs/_static/sphinx-notes.png b/docs/_static/sphinx-notes.png
diff --git a/docs/_templates/confval.rst b/docs/_templates/confval.rst
@@ -0,0 +1,11 @@
+
+:Type: :py:class:`{{ type }}`
+:Default: ``{{ default }}``
+{% if choice %}:Choices: {% for c in choice %}``{{ c }}`` {% endfor %}{% endif %}
+{% if versionadded %}:Version added: :version:`{{ versionadded }}`{% endif %}
+{% if versionchanged %}:Version changed:{% for i in range(0, versionchanged|count -1, 2)  %}
+   :version:`{{ versionchanged[i] }}`
+      {{ versionchanged[i+1] }}{% endfor %}{% endif %}
+
+{{ content }}
+
diff --git a/docs/_templates/example.rst b/docs/_templates/example.rst
@@ -0,0 +1,31 @@
+
+{% if style is not defined or style == 'tab' %}
+.. tab-set::
+
+   .. tab-item:: Result
+
+      {% for line in content %}{{ line }}
+      {% endfor %}
+
+   .. tab-item:: reStructuredText
+
+      .. code:: rst
+
+         {% for line in content %}{{ line }}
+         {% endfor %}
+{% elif style == 'grid'  %}
+.. grid:: 2
+
+   .. grid-item-card::  reStructuredText
+
+      .. code:: rst
+
+         {% for line in content %}{{ line }}
+         {% endfor %}
+
+   .. grid-item-card:: Result
+
+      {% for line in content %}{{ line }}
+      {% endfor %}
+{% endif %}
+
diff --git a/docs/_templates/version.rst b/docs/_templates/version.rst
@@ -1,9 +1,6 @@
-.. list-table::
-   :align: left
-
-   * - :ref:`📅 {{ date }} <any-version.date>`
-     - :tag:`{{ title }}`
 
+:Date: :ref:`📅{{ date }} <any-version.date>`
+:Download: :tag:`{{ title }}`
 
 {% for line in content %}
 {{ line }}
diff --git a/docs/changelog.rst b/docs/changelog.rst
@@ -1,4 +1,4 @@
-.. This file is generated from sphinx-notes/template.
+.. This file is generated from sphinx-notes/cookiecutter.
    You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 ==========
diff --git a/docs/conf.py b/docs/conf.py
@@ -1,4 +1,4 @@
-# This file is generated from sphinx-notes/template.
+# This file is generated from sphinx-notes/cookiecutter.
 # You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 # Configuration file for the Sphinx documentation builder.
@@ -70,17 +70,17 @@
 # It is used to indicate the location of document like canonical_url
 html_baseurl = 'https://sphinx.silverrainz.me/any'
 
-html_logo = html_favicon = '_images/sphinx-notes.png'
+html_logo = html_favicon = '_static/sphinx-notes.png'
 
 # -- Extensions -------------------------------------------------------------
 
 # 
 
 extensions.append('sphinx.ext.extlinks')
 extlinks = {
-    'issue': ('https://github.com/sphinx-notes/any/issues/%s', '💬 %s'),
-    'pull': ('https://github.com/sphinx-notes/any/pull/%s', '🚀 %s'),
-    'tag': ('https://github.com/sphinx-notes/any/releases/tag/%s', '🏷️ %s'),
+    'issue': ('https://github.com/sphinx-notes/any/issues/%s', '💬%s'),
+    'pull': ('https://github.com/sphinx-notes/any/pull/%s', '🚀%s'),
+    'tag': ('https://github.com/sphinx-notes/any/releases/tag/%s', '🏷️%s'),
 }
 
 extensions.append('sphinxcontrib.gtagjs')
@@ -105,25 +105,52 @@
 sys.path.insert(0, os.path.abspath('../src/sphinxnotes'))
 extensions.append('any')
 
+# 
 # DOG FOOD CONFIGURATION START
 from any import Schema, Field as F
 sys.path.insert(0, os.path.abspath('.'))
 
+version_schema = Schema('version',
+                        name=F(unique=True, referenceable=True, required=True, form=F.Form.LINES),
+                        attrs={'date': F(referenceable=True)},
+                        content=F(form=F.Form.LINES),
+                        description_template=open('_templates/version.rst', 'r').read(),
+                        reference_template='🏷️{{ title }}',
+                        missing_reference_template='🏷️{{ title }}',
+                        ambiguous_reference_template='🏷️{{ title }}')
+confval_schema = Schema('confval',
+                        name=F(unique=True, referenceable=True, required=True, form=F.Form.LINES),
+                        attrs={
+                            'type': F(),
+                            'default': F(),
+                            'choice': F(form=F.Form.WORDS),
+                            'versionadded': F(),
+                            'versionchanged': F(form=F.Form.LINES),
+                        },
+                        content=F(),
+                        description_template=open('_templates/confval.rst', 'r').read(),
+                        reference_template='⚙️{{ title }}',
+                        missing_reference_template='⚙️{{ title }}',
+                        ambiguous_reference_template='⚙️{{ title }}')
+example_schema = Schema('example',
+                        name=F(referenceable=True),
+                        attrs={'style': F()},
+                        content=F(form=F.Form.LINES),
+                        description_template=open('_templates/example.rst', 'r').read(),
+                        reference_template='📝{{ title }}',
+                        missing_reference_template='📝{{ title }}',
+                        ambiguous_reference_template='📝{{ title }}')
+
 any_schemas = [
-    Schema('version',
-           name=F(unique=True, referenceable=True, required=True, form=F.Form.LINES),
-           attrs={'date': F(referenceable=True)},
-           content=F(form=F.Form.LINES),
-           description_template=open('_templates/version.rst', 'r').read(),
-           reference_template='💽 {{ title }}',
-           missing_reference_template='💽 {{ title }}',
-           ambiguous_reference_template='💽 {{ title }}'),
+    version_schema,
+    confval_schema,
+    example_schema,
 
     __import__("_schemas.cat").cat.cat,
     __import__("_schemas.dog2").dog2.dog,
-    __import__("_schemas.confval").confval.confval,
     __import__("_schemas.tmplvar").tmplvar.tmplvar,
 ]
 
 primary_domain = 'any'
 # DOG FOOD CONFIGURATION END
+# 
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,4 +1,4 @@
-.. This file is generated from sphinx-notes/template.
+.. This file is generated from sphinx-notes/cookiecutter.
    You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 .. include:: ../README.rst
@@ -62,7 +62,7 @@ Contents
 The Sphinx Notes Project
 ========================
 
-This project is a developed by `Shengyu Zhang`__,
+The project is developed by `Shengyu Zhang`__,
 as part of **The Sphinx Notes Project**.
 
 .. toctree::
diff --git a/docs/make.bat b/docs/make.bat
@@ -1,4 +1,4 @@
-REM This file is generated from sphinx-notes/template. DO NOT EDIT.
+REM This file is generated from sphinx-notes/cookiecutter. DO NOT EDIT.
 
 @ECHO OFF
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,4 +1,4 @@
-# This file is generated from sphinx-notes/template.
+# This file is generated from sphinx-notes/cookiecutter.
 # You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 # This file is used to configure your project.

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"template": "https://github.com/sphinx-notes/cookiecutter",`
`3`		`- "commit": "93c85ed7fe6dc87e11ffd024b762a3c8c9a83a1b",`
	`3`	`+ "commit": "0b7d8aa478b37114cef369a217bd1d463e369d37",`
`4`	`4`	`"checkout": null,`
`5`	`5`	`"context": {`
`6`	`6`	`"cookiecutter": {`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This file is generated from sphinx-notes/template.`
	`1`	`+# This file is generated from sphinx-notes/cookiecutter.`
`2`	`2`	`# You need to consider modifying the TEMPLATE or modifying THIS FILE.`
`3`	`3`
`4`	`4`	`include LICENSE`