Installation backend from source with pip, mxdev, cookiecutter

Author: ksuess

docs/_static/custom.css

@@ -155,6 +155,11 @@ div.admonition.admonition-todo>.admonition-title::before {
   display: none;
 }
 
+/* admonition margin */
+.admonition.margin ul,
+.admonition.margin ol {
+  padding-left: 1rem;
+}
 
 .topic {
   padding: 1.5em 1em .5em 1em;

docs/contributing/writing-docs-guide.md

@@ -215,7 +215,6 @@ This is MyST syntax for term ``{term}`React` ``
 This is MyST syntax for term ``{term}`React` ``
 
 
-
 ##### Glossary terms
 
 Add a term to the {ref}`glossary-label`, located at {file}`/glossary.md`.
@@ -235,6 +234,21 @@ Using {term}`React` makes frontends fun again!
 Using {term}`React` makes frontends fun again!
 
 
+#### Toggle paragraph (Exercises / FAQ)
+
+````{admonition} This is a title
+:class: toggle
+
+```{code-block} python
+:linenos:
+:emphasize-lines: 1, 3
+
+a = 2
+print("my 1st line")
+print(f"my {a}nd line")
+```
+````
+
 
 ## Abridged Plone Documentation Styleguide
 

docs/glossary.md

@@ -32,6 +32,12 @@ Barceloneta
 CMS
     Content Management System
 
+cookiecutter
+    A command-line utility that creates projects from cookiecutters (project templates), e.g. creating a Python package project from a Python package project template.
+
+cookiecutter-zope-instance
+    cookiecutter-zope-instance is a cookiecutter template to create a full and complex configuration of a Zope WSGI instance.
+
 CSS
     Cascading Style Sheets (CSS) is a stylesheet language used for describing the (most of the times visual) representation of web pages.
 
@@ -42,6 +48,15 @@ Grunt
 Less
     A dynamic stylesheet language that can be compiled into {term}`CSS` (Cascading Style Sheets).
 
+mxdev
+    mxdev [mɪks dɛv] is a utility that makes it easy to work with Python projects containing lots of packages, of which you only want to develop some.\
+    It builds on top of the idea to have stable version constraints and then develop from a VCS on top of it.\
+    As part of above use-case sometimes versions of the stable constraints need an override with a different (i.e. newer) version.\
+    https://github.com/mxstack/mxdev
+
+mxmake
+    TODO mxmake glossary term description
+
 NPM
     npm is a package manager for the JavaScript programming language.
     It is the default package manager for the JavaScript runtime environment Node.js.

docs/install/index.md

@@ -68,4 +68,5 @@ System requirements depend upon your choice of installation method:
 
 containers/index
 source
+source-step-by-step
 ```