chore: Update template

Author: SilverRainZ

.cruft.json

@@ -1,6 +1,6 @@
 {
   "template": "https://github.com/sphinx-notes/template",
-  "commit": "cbf447e57f35a62a097cf0f8b740e047a3827e08",
+  "commit": "93c85ed7fe6dc87e11ffd024b762a3c8c9a83a1b",
   "checkout": null,
   "context": {
     "cookiecutter": {
@@ -14,10 +14,6 @@
       "github_repo": "any",
       "pypi_name": "sphinxnotes-any",
       "pypi_owner": "SilverRainZ",
-      "dependencies": [
-        "Sphinx >= 4"
-      ],
-      "additional_docs": [],
       "_template": "https://github.com/sphinx-notes/template"
     }
   },

Makefile

@@ -3,35 +3,56 @@
 
 LANG = en_US.UTF-8
 
-MAKE = make
-PY   = python3
-RM   = rm -rf
+MAKE  = make
+PY    = python3
+RM    = rm -rf
 
+# Build sphinx documentation.
 .PHONY: docs
 docs:
 	$(MAKE) -C docs/
 
+# Run unittest.
 .PHONY: test
 test:
 	$(PY) -m unittest discover -s tests -v
 
+# Build distribution package, for "install" or "upload".
 .PHONY: dist
 dist: pyproject.toml
 	$(RM) dist/ # clean up old dist
 	$(PY) -m build
 
+# Install distribution package to user directory.
+#
+# NOTE: It may breaks your system-level packages, use at your own risk.
 .PHONY: install
 install: dist
+	export PIP_BREAK_SYSTEM_PACKAGES=1 # required by Python 3.11+, see PEP-668
 	$(PY) -m pip install --user --no-deps --force-reinstall dist/*.whl
 
+# Publish wheel to PyPI offical server <https://pypi.org/> when you want to
+# You should have a PyPI account and have PyPI token configured.
+#
+# See also https://packaging.python.org/en/latest/tutorials/packaging-projects/#uploading-the-distribution-archives
 .PHONY: upload
 upload: dist
 	$(PY) -m twine upload --repository pypi $</*
 
-.PHONY: test-upload
-test-upload: dist
+# Same to the aboved "upload" target, but this publishs to PyPI test server
+# <https://test.pypi.org/>.
+.PHONY: upload-test
+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.
 .PHONY: update-template
 update-template:
 	$(PY) -m cruft update
+
+# Update project version.
+.PHONY: bump-version
+bump-version:
+	@echo -n "Please enter the version to bump: "
+	@read version && $(PY) -m cruft update --variables-to-update "{ \"version\" : \"$$version\" }"