From 5c201cb52890f5e224f97c4fe5e9b178bf3cdb07 Mon Sep 17 00:00:00 2001 From: Jeremy Kubica <104161096+jeremykubica@users.noreply.github.com> Date: Mon, 13 Mar 2023 09:33:30 -0400 Subject: [PATCH] Reorganize the docs folder --- docs/conf.py | 7 ++++++- docs/source/new_project.rst | 38 +++++++++++++++++++++++++++------- docs/static/custom.css | 4 ++++ docs/{ => static}/favicon.ico | Bin 4 files changed, 40 insertions(+), 9 deletions(-) create mode 100644 docs/static/custom.css rename docs/{ => static}/favicon.ico (100%) diff --git a/docs/conf.py b/docs/conf.py index 6ca92cf5..cd67600b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -20,10 +20,15 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration master_doc = "index" # This assumes that sphinx-build is called from the root directory -html_favicon = 'favicon.ico' +html_favicon = 'static/favicon.ico' html_show_sourcelink = ( False # Remove 'view source code' from top of page (for html, not python) ) + +# Allow a custom CSS. +html_static_path = ['static',] +html_css_files = ["custom.css"] + # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output diff --git a/docs/source/new_project.rst b/docs/source/new_project.rst index 1d991b62..3041138b 100644 --- a/docs/source/new_project.rst +++ b/docs/source/new_project.rst @@ -13,14 +13,36 @@ Choose where you would like to create your new project, and call copier with the Copier will ask you questions for how to set up the project. These questions will be used to fill in aspects of the project's configuration, including both metadata and parameters. Below we provide some high-level overview of the questions: - * *What is the name of your project?* (``project_name``): The name of your project. - * *What is your python module name?* (``module_name``): The name of your (first) module. The main thing this controls is where your source code will live (``src/{{module_name}}``). - * *Your first and last name?* (``author_name``): The name of code's author. This will be used in the project and documentation metadata. - * *Your preferred email address?* (``author_email``): The contact email for the code's author. This will be used in the project and documentation metadata. - * *What license would you like to use?* (``project_license``): The license type you wwant to use for this project. Options are MIT and BSD. For more information on these options see `Github's license page `_. - * *What tooling would you like to use to enforce code style?* (``preferred_linter``): A linter is a tool to automatically format for consistency (see :doc:`Linting <../practices/linting>`). We provide options for `black `_, `pylint `_, or no linter. Choosing a linter will include it as a project dependency and include it in the :doc:`pre-commit <../practices/precommit>` hooks. - * *Do you want to use a tool to maintain a specific ordering for module imports?* (``use_isort``): `isort `_ is a tool for ordering imports in a standard order. Enabling the option will include ``isort`` as part of github's :doc:`pre-commit <../practices/precommit>`. - * *Do you want to create some example module code?* (``create_example_module``): If this option is selected the template will create a model in ``src/{{module_name}}`` and create a corresponding example test file. +.. list-table:: + :header-rows: 1 + + * - **Question** + - **Variable** + - **Notes** + * - *What is the name of your project?* + - ``project_name`` + - The name of your project. + * - *What is your python module name?* + - ``module_name`` + - The name of your (first) module. This controls where your source code will live (``src/{{module_name}}``). + * - *Your first and last name?* + - ``author_name`` + - The name of code's author. This will be used in the project and documentation metadata. + * - *Your preferred email address?* + - ``author_email`` + - The contact email for the code's author. This will be used in the project and documentation metadata. + * - *What license would you like to use?* + - ``project_license`` + - The license type you wwant to use for this project. Options are MIT and BSD. For more information on these options see `Github's license page `_. + * - *What tooling would you like to use to enforce code style?* + - ``preferred_linter`` + - A linter is a tool to automatically format for consistency (see :doc:`Linting <../practices/linting>`). We provide options for `black `_, `pylint `_, or no linter. Choosing a linter will include it as a project dependency and include it in the :doc:`pre-commit <../practices/precommit>` hooks. + * - *Do you want to use a tool to maintain a specific ordering for module imports?* + - ``use_isort`` + - `isort `_ is a tool for ordering imports in a standard order. Enabling the option will include ``isort`` as part of github's :doc:`pre-commit <../practices/precommit>`. + * - *Do you want to create some example module code?* + - ``create_example_module`` + - If this option is selected the template will create a model in ``src/{{module_name}}`` and create a corresponding example test file. While these choices will provide the initial structure for your project, most can be changed later. See Copier's `documentation for changing answers to the question `_ diff --git a/docs/static/custom.css b/docs/static/custom.css new file mode 100644 index 00000000..a648228e --- /dev/null +++ b/docs/static/custom.css @@ -0,0 +1,4 @@ +/* Allow tables to wrap. */ +.wy-table-responsive table td, .wy-table-responsive table th { + white-space: inherit; +} diff --git a/docs/favicon.ico b/docs/static/favicon.ico similarity index 100% rename from docs/favicon.ico rename to docs/static/favicon.ico