Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How to build with Sphinx Collections? #17

Closed
anugrahjo opened this issue Mar 7, 2023 · 4 comments
Closed

How to build with Sphinx Collections? #17

anugrahjo opened this issue Mar 7, 2023 · 4 comments

Comments

@anugrahjo
Copy link

Is there an example package where 'Sphinx Collections' is used? Inside conf.py, I set 'collections' with a dict for copying a folder but it doesn't seem to do anything during the build. Should I add sphinx_collections to the list of extensions in conf.py? In general, what changes should I make on my original repository to use 'Sphinx Collections'?

@jgarte
Copy link
Contributor

jgarte commented Mar 8, 2023

Hi @anugrahjo,

Yes, you should be adding sphinx.collections to your conf.py file similar to here or here.

We have a related ticket open to create a better example project for showing off sphinx-collections: #10

Can you share the project repository that you are working on?

@anugrahjo
Copy link
Author

anugrahjo commented Mar 8, 2023

Hi @jgarte,

I see, thanks. It should be sphinxcontrib.collections by the way. I have tried all possible names for the extension before raising this issue. It would be nice to add it to the Introduction in the documentation. Everything else was pretty clear in the docs, but the extension name to be used in conf.py couldn't be found anywhere.

I am working on a template repository for documentation and testing for my lab. It does not do much. Do you still need it?

@jgarte
Copy link
Contributor

jgarte commented Mar 8, 2023

@danwos

See @anugrahjo 's comment regarding sphinxcontrib.collections. What do you think?

I am working on template repository for documentation and testing for my lab. It does not do much. Do you still need it?

If you end up finishing the example feel free to share it. Any examples of how people are using sphinx-collections would be great.

@anugrahjo
Copy link
Author

@jgarte
Sure, once the documentation template is final, I will share it here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants