-
-
Notifications
You must be signed in to change notification settings - Fork 3.6k
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
Docusaurus basics #11752
base: main
Are you sure you want to change the base?
Docusaurus basics #11752
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From what I understand, docosaurus renders the docs with JS, that has the downside of some of our integrations that work over the generated HTML not working, like search and content embedding. Maybe have a limitations section?
@stsewd yup, sounds good, thanks |
File Tree Diff won't work here either... |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good. As Santos mentioned, we should add a "Limitations" section before merging.
commands: | ||
# "docs/" was created following the Docusaurus tutorial: | ||
# npx create-docusaurus@latest docs classic | ||
# but you can just use your existing Docusaurus site | ||
# | ||
# Install Docusaurus dependencies | ||
- cd docs/ && npm install | ||
# Build the site | ||
- cd docs/ && npm run build | ||
# Copy generated files into Read the Docs directory | ||
- mkdir --parents $READTHEDOCS_OUTPUT/html/ | ||
- cp --recursive docs/build/* $READTHEDOCS_OUTPUT/html/ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Once we merge and deploy #11710 this would be as following:
build:
install:
- cd docs/ && npm install
build:
html:
- cd docs/ && npm run build
post_build:
- mkdir --parents $READTHEDOCS_OUTPUT/html/
- cp --recursive docs/build/* $READTHEDOCS_OUTPUT/html/
Not a lot of info here, but probably worth pushing out anyway
📚 Documentation previews 📚
docs
): https://docs--11752.org.readthedocs.build/en/11752/dev
): https://dev--11752.org.readthedocs.build/en/11752/