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

[Questions] Local versus documentation setup #49

Closed
s0h3ck opened this issue Feb 8, 2020 · 2 comments
Closed

[Questions] Local versus documentation setup #49

s0h3ck opened this issue Feb 8, 2020 · 2 comments

Comments

@s0h3ck
Copy link

s0h3ck commented Feb 8, 2020

Hello, I am exploring Sphinx and I tried your package. I am curious how to get the result in your documentation here.

My setup is a default setup following the Sphinx documentation with conf.py and index.rst in the source directory.

Question 1: How do I maximize the space?

Me:

1581174471

The documentation:

1581174496

Question 2: How does nested toctree work? For example, the block quotes does not have plus or minus button in my local version, but it has one in the documentation.

Me:

1581175747

The documentation:

1581175735

Question 3: Are you still using Python 2? The sphinxcontrib.youtube didn't work for me. I had to install sphinxcontrib.yt. sphinxcontrib.yt is apparently an updated version for Python 3. The documentation mentions sphinxcontrib.youtube, so it may be a mistake in the documentation. Which library do you use?

@marble
Copy link
Member

marble commented Feb 9, 2020

In the TYPO3 community we are using Sphinx for documentation:
https://docs.typo3.org In the footer you'll find the link to the currently used theme https://github.com/TYPO3-Documentation/t3SphinxThemeRtd which builds on the ReadTheDocs theme.
We are using this docker container for rendering: https://github.com/t3docs/docker-render-documentation You can use that container or study the recipe.
Right now we are in a transition phase to move to this brand new 'sphinx_typo3_theme' here. It is still work in progress, but already integrated - in a suboptimal way - in the 'develop' version of the Docker container.
The container is still using Python2 at the moment, because the "TCT" and "Toolchain" need to be refactored and adapted to Python 3 first.
Hope that helps!

@s0h3ck
Copy link
Author

s0h3ck commented Feb 10, 2020

Hi marble, thanks! Keep up the good work! :)

@s0h3ck s0h3ck closed this as completed Feb 10, 2020
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