Skip to content

Commit

Permalink
update conf.py, requirements.yaml for new doc theme
Browse files Browse the repository at this point in the history
  • Loading branch information
janash committed Nov 9, 2023
1 parent 35021f5 commit f9d3d6a
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 5 deletions.
5 changes: 3 additions & 2 deletions {{cookiecutter.repo_name}}/docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,11 @@
'sphinx.ext.napoleon',
'sphinx.ext.intersphinx',
'sphinx.ext.extlinks',
'sphinx_design'

'sphinx_design',
'sphinx_copybutton',
]


autosummary_generate = True
napoleon_google_docstring = False
napoleon_use_param = False
Expand Down
7 changes: 6 additions & 1 deletion {{cookiecutter.repo_name}}/docs/getting_started.rst
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
Getting Started
===============

This page details how to get started with {{cookiecutter.project_name}}.

You might choose to write an overview tutorial or set of tutorials.

.. code-block:: python
import {{cookiecutter.repo_name}}
8 changes: 6 additions & 2 deletions {{cookiecutter.repo_name}}/docs/requirements.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: docs
name: docs_{{cookiecutter.project_name}}
channels:
{% if cookiecutter.dependency_source == 'Prefer conda-forge over the default anaconda channel with pip fallback' %}
- conda-forge
Expand All @@ -11,15 +11,19 @@ dependencies:
{% if cookiecutter.dependency_source == 'Prefer conda-forge over the default anaconda channel with pip fallback' %}
- pydata-sphinx-theme
- sphinx-design
- sphinx-copybutton
{% endif %}

{% if cookiecutter.dependency_source == 'Prefer default anaconda channel with pip fallback' %}
# Pip-only installs
- pip:
- -e ../
- pydata-sphinx-theme
- sphinx-design
- sphinx-copybutton
{% else %}

# Pip-only installs
#- pip:
- pip:
- -e ../
{% endif %}

0 comments on commit f9d3d6a

Please sign in to comment.