Skip to content

[Docs] Generate searchable tutorial rst pages#820

Draft
ehennestad wants to merge 9 commits into
mainfrom
tutorial-rst-export
Draft

[Docs] Generate searchable tutorial rst pages#820
ehennestad wants to merge 9 commits into
mainfrom
tutorial-rst-export

Conversation

@ehennestad
Copy link
Copy Markdown
Collaborator

Motivation

This PR replaces iframe-embedded tutorial pages with generated reStructuredText pages so tutorial content becomes searchable in the Sphinx/Read the Docs docs. It adds conversion pipelines for tutorial exports, publishes tutorial media to a docs-specific static location, and carries the formatting fixes needed for lists, links, TOCs, and image sizing in the rendered tutorial pages.

How to test the behavior?

matnwb_exportTutorials('RunLivescript', false, 'IgnoreFiles', string.empty, 'ExportFormat', '.html')

Checklist

  • Have you ensured the PR description clearly describes the problem and solutions?
  • Have you checked to ensure that there aren't other open or previously closed Pull Requests for the same change?
  • If this PR fixes an issue, is the first line of the PR description fix #XX where XX is the issue number?

🤖 Generated with Codex

@ehennestad ehennestad changed the title [codex] Generate searchable tutorial rst pages [Docs] Generate searchable tutorial rst pages Apr 19, 2026
Updated file identifier. Should be globally unique and not confused with session id
Used reproducible random number generation to produce predictable files / output
Fix ophys tutorial, removing image processing toolbox dependency
@ehennestad ehennestad added the topic: docs related to documentation label May 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

topic: docs related to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant