update conf add intro

docsrc/conf.py

@@ -6,29 +6,31 @@
 repo = "render"
 repo_name = "render"
 
-blog_title = f'{org_name} • {repo_name}'
-html_title = f'{org_name} • {repo_name}'
-project = f'{org_name} • {repo_name}'
-version = ''  # The short X.Y version.
-release = ''  # The full version, including alpha/beta/rc tags.
-
-copyright = f'{year}, {org_name}'
-author = f'{org_name}'
-
-# Base URL for the website, required for generating feeds.
-# e.g. blog_baseurl = "http://example.com/"
-blog_baseurl = f'https://{org}.github.io/{repo}'
-html_base_url = blog_baseurl
-html_baseurl = blog_baseurl
-
-blog_authors = {
-    "phi": ("phi ARCHITECT", None),
-}
-
-html_context = {
-    "display_github": True, # Integrate GitHub
-    "github_user": org, # Username
-    "github_repo": repo, # Repo name
-    "github_version": "main", # Version
-    "conf_py_path": "/docsrc/", # Path in the checkout to the docs root
-}
+setup_globals(org, org_name, repo, repo_name)
+
+#  blog_title = f'{org_name} • {repo_name}'
+#  html_title = f'{org_name} • {repo_name}'
+#  project = f'{org_name} • {repo_name}'
+#  version = ''  # The short X.Y version.
+#  release = ''  # The full version, including alpha/beta/rc tags.
+
+#  copyright = f'{year}, {org_name}'
+#  author = f'{org_name}'
+
+#  # Base URL for the website, required for generating feeds.
+#  # e.g. blog_baseurl = "http://example.com/"
+#  blog_baseurl = f'https://{org}.github.io/{repo}'
+#  html_base_url = blog_baseurl
+#  html_baseurl = blog_baseurl
+
+#  blog_authors = {
+    #  "phi": ("phi ARCHITECT", None),
+#  }
+
+#  html_context = {
+    #  "display_github": True, # Integrate GitHub
+    #  "github_user": org, # Username
+    #  "github_repo": repo, # Repo name
+    #  "github_version": "main", # Version
+    #  "conf_py_path": "/docsrc/", # Path in the checkout to the docs root
+#  }

docsrc/intro.rst

@@ -1,57 +1 @@
-``geometor.model`` is the foundational library for the `GEOMETOR`_ initiative.
-
-.. image:: _static/splash.png
-
-At the core of the module is the ``Model`` class which establishes the field
-and methods of operation for creating the geometric constructions while maintaining integrity. 
-
-The **field** might be easy to consider as a Cartesian grid. But in reality, it
-is an ordered set of information and operations. Points are the information.
-Lines and circles are the operations.
-
-In our system, all geometric elements of the ``Model`` are defined as `Sympy Geometry`_
-objects. This means a ``Point`` can be defined as a pair of any algebraic
-`Sympy Expressions`_ that can be evaluated into a floating point value. 
-
-``Line`` and ``Circle`` are each defined by two points. So each construction
-must begin with at least two given points at the start. As lines and circles
-are added, intersection points are discovered with previous lines and circles
-and added to the model, so they may be used with new lines and circles. 
-
-There are three main operations of the ``Model``:
-
-- set_point
-- construct_line
-- construct_circle
-
-The major responsibilities of the ``Model``:
-
-- **deduplicate**
-
-  when elements are added to the model, we check to see if they already exist. This is particularly important for intersection points that often coincide with exisitng points. 
-- clean values
-- discover intersections
-- save to and load from json
-- maintain a set of related info for each element:
-
-  - ancestral relationships
-  - establish labels for elements
-  - classes for styles
-
-All of the plotting functionality has moved to **GEOMETOR** `render`_. However, there are several report functions in the this module:
-
-- report_summary
-- report_group_by_type
-- report_sequence
-
-.. image:: _static/screenshot.png
-
-.. _`GEOMETOR`: https://geometor.com
-
-
-.. _render: https://github.com/geometor/render
-.. _`Sympy Expressions`: https://docs.sympy.org/latest/tutorials/intro-tutorial/basic_operations.html
-.. _`Sympy Geometry`: https://docs.sympy.org/latest/modules/geometry/index.html
-.. _`Sympy`: https://docs.sympy.org
-.. _GEOMETOR: https://geometor.com
-.. _`Project's Website`: https://geometor.github.io/model
+.. render