Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
JohnGriffiths authored Dec 5, 2023
1 parent 55ffd9c commit fbe343c
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 8 deletions.
10 changes: 5 additions & 5 deletions doc/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ def setup(app):
("Examples", "auto_examples/index"),
("User guide", "user_guide/index"),
("FAQ", "faq"),
("GitHub", "https://github.com/neurotechx/eeg-notebooks", True),
("GitHub", "https://github.com/neurotechx/eeg-expy", True),
],
# Set the page width to not be restricted to hardset value
Expand Down Expand Up @@ -261,8 +261,8 @@ def setup(app):
'within_subsection_order': FileNameSortKey,
'default_thumb_file': 'img/eeg-notebooks_logo.png',
'backreferences_dir': 'generated', # Where to drop linking files between examples & API
'doc_module': ('eeg-notebooks'),
'reference_url': {'eeg-notebooks': None},
'doc_module': ('eeg-expy'),
'reference_url': {'eeg-expy': None},
'remove_config_comments': True}

"""
Expand All @@ -282,8 +282,8 @@ def setup(app):
'within_subsection_order': FileNameSortKey,
'default_thumb_file': 'img/eeg-notebooks_logo.png',
'backreferences_dir': 'generated', # Where to drop linking files between examples & API
'doc_module': ('eeg-notebooks',),
'reference_url': {'eeg-notebooksS': None},
'doc_module': ('eeg-expy',),
'reference_url': {'eeg-expy': None},
'remove_config_comments': True,
}
Expand Down
7 changes: 4 additions & 3 deletions doc/misc/about_the_docs.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# About the EEG-notebooks Documentation Pages
# About the EEG-ExPy Documentation Pages

A few comments on how these are put together:

The documentation pages are written for the following readthedocs sphinx-based setup:

- `readthedocs` auto-generates the documentation, using various configuration files
- In particular, we use [Nbsphinx](https://github.com/spatialaudio/nbsphinx) to create `html` pages directly from a combination of jupyter notebooks, `.rst` files, and `.md` files
- Because the notebook files are not located under the docs folder, we additionally need to make use of [nbsphinx-link](https://github.com/vidartf/nbsphinx-link)
- In particular, we use [Nbsphinx](https://github.com/spatialaudio/nbsphinx) to create `html` pages directly.
from a combination of jupyter notebooks, `.rst` files, and `.md` files
- Because the files are not located under the docs folder, we additionally need to make use of [nbsphinx-link](https://github.com/vidartf/nbsphinx-link)


0 comments on commit fbe343c

Please sign in to comment.