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

ReadTheDocs configuration #18

Merged
merged 14 commits into from
Jul 24, 2021
Merged

ReadTheDocs configuration #18

merged 14 commits into from
Jul 24, 2021

Conversation

devmessias
Copy link
Contributor

@devmessias devmessias commented Jul 22, 2021

  • Helios logo
  • sphinx-gallery
  • API

Before this, the examples was not appearing in the MDE, HeliosFr
docs. This its caused due the export in helios/layouts/__init__.py.
I solved that creating a condition inside of helios/docs/source/templates/custom_module_template.rst
Copy link

@skoudoro skoudoro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @devmessias ,

A lot of temporary files, I recommend you update your gitignore before merging

@devmessias
Copy link
Contributor Author

Hi @devmessias ,

A lot of temporary files, I recommend you update your gitignore before merging

Hi @skoudoro . We have a problem.Tthose files are created by the sphinx-gallery extension. However, I couldn't run the sphinx-gallery in the readthedocs. Also I think it's not possible to use the Xvfb on readthedocs

@devmessias devmessias force-pushed the readthedocs branch 2 times, most recently from b1f28e3 to d514b92 Compare July 22, 2021 19:30
@filipinascimento
Copy link
Contributor

Hi @devmessias ,

A lot of temporary files, I recommend you update your gitignore before merging

Hi @skoudoro , we are trying to figure out the best way to run the sphinx-gallery and send this to readthedocs. We can't do that inside their environment (no Xvfb probably), so the current approach is pre-generating it and them uploading it. @devmessias proposed to have a different repo (gh-pages) for the generated documentation. We can get the org name helios-network (so the address will be helios-network.github.org/docs or something like that) and create a github action to fill this repo with the generated data. Another option would be this a page inside fury, but it could be harder for other people to reach it. What do you think?

We have a issue due the lack of X-server on readthedocs.
In addition, is not possible to install the Xvfb
@skoudoro
Copy link

hi @devmessias and @filipinascimento,

you are now admin of https://github.com/fury-gl/helios-website

you can use this repo for the website

    It seems that there is a issue with vtk and syphinx-gallery.

    HeliosFr and any IPCLayout method dosen't work inside of
    syphinx-gallery script.
@devmessias devmessias added documentation Improvements or additions to documentation enhancement New feature or request labels Jul 23, 2021
@devmessias devmessias merged commit 1dc2882 into fury-gl:main Jul 24, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants