Like the documentation of python or django, how do I have multiple versions of my doc with sphinx ?
I saved my doc on git, and I want my user to be able to see documentation for different version like v2.7,v3.4, etc
Thank you for the help
You could just use Read The Docs to host your documentation for you. They automatically handle multiple versions with a dropdown:
https://docs.readthedocs.io/en/latest/index.html
If you'd like to host your own documentation on GitHub Pages or some other web server, I made a Sphinx extension that does what you're looking for:
https://github.com/sphinx-contrib/sphinxcontrib-versioning
There's the sphinx-multiversion extension.
It's similar to sphinxcontrib-versioning, but sphinxcontrib-versioning doesn't seem to be actively maintained. The last release was in 2016, and it doesn't work with more recent versions of Sphinx (issue #77). sphinx-multiversion is a new implementation (see comment by the author).
Note on healthiness of the project: as of December 2020, it seems that SMV is a one-person project and there are a number of open issues and pull requests that haven't been responded to (though see this comment by the author).
Related
In this video (https://www.youtube.com/watch?v=qPHKWsZK2Jc&list=PLvv0ScY6vfd-p1gSnbQhY7vMe2rng0IL0&index=10) from about a year ago, there is example code on the SDL_CreateWindow function documentation page. I have seen other posts talking about the SDL examples.
If you look at the documentation now it is the same minus the example code
https://wiki.libsdl.org/SDL2/SDL_CreateWindow
Am I blind or is there no longer any example code on the SDL2 wiki?
If not, does anybody know what the reasons for removing it are?
I expect that
There are some official examples somewhere
If they were removed from the official wiki they would at least be placed in a 'legacy' repo or something like that.
A Google (DuckDuckGo) search gives only third party examples and, aside from a few forum posts, no mention of there ever being any examples on the wiki.
In 2022, the Wiki migrated from MoinMoin to ghwikipp. With that came a host of breaks and bugs. Your issue specifically is covered under issue #233.
The images were also broken, but that issue shows a workaround for viewing the Wiki in working form: use archive.org on wiki.libsdl.org, not wiki.libsdl.org/SDL2 where it is currently hosted. This gives you your examples back.
e.g. like this
If you have some sort of MediaWiki viewer program, you can also just pull an old revision from the Repo and read it offline. Even Github's MarkDown viewer isn't terrible. Caveat that new changes won't be reflected.
They promise us that it will be fixed at some point, and they do seem to be working hard on it. The only hardfix is either to (a) wait, or (b) help them finish their migration.
Like the documentation of python or django, how do I have multiple versions of my doc with sphinx ?
I saved my doc on git, and I want my user to be able to see documentation for different version like v2.7,v3.4, etc
Thank you for the help
You could just use Read The Docs to host your documentation for you. They automatically handle multiple versions with a dropdown:
https://docs.readthedocs.io/en/latest/index.html
If you'd like to host your own documentation on GitHub Pages or some other web server, I made a Sphinx extension that does what you're looking for:
https://github.com/sphinx-contrib/sphinxcontrib-versioning
There's the sphinx-multiversion extension.
It's similar to sphinxcontrib-versioning, but sphinxcontrib-versioning doesn't seem to be actively maintained. The last release was in 2016, and it doesn't work with more recent versions of Sphinx (issue #77). sphinx-multiversion is a new implementation (see comment by the author).
Note on healthiness of the project: as of December 2020, it seems that SMV is a one-person project and there are a number of open issues and pull requests that haven't been responded to (though see this comment by the author).
Having had a good Google, I can't seem to find a CDN link for ui-grid ... is there a reason it's not on a CDN?
Edit: Added to CDNJS Sept. 2015
Yes, because UI-Grid (as of this writing) is still pre-release. Once it's ready for release we'll look at automating submission to something like cdnjs.
In the meantime you can use rawgit.com's cdn links:
//cdn.rawgit.com/angular-ui/ui-grid.info/gh-pages/release/3.0.0-rc.20/ui-grid.min.js
//cdn.rawgit.com/angular-ui/ui-grid.info/gh-pages/release/3.0.0-rc.20/ui-grid.min.css
Just replace the release tag with the most recent RC.
You can find the latest stable version here: https://cdnjs.com/libraries/angular-ui-grid
What`s new with the RestKit-release? Should I update? Where are the changes documented?
I can not find any information on the several news channels: website, github, twitter, google groups
This is on github.
And describes in general terms the changes.
I would suggest if you are in active development you should upgrade, if you are maintaining something and have no problems with Restkit I would leave as is until you able to fully test with the new version.
http://restkit.org/api/ This page will give you API documents.
https://github.com/RestKit/RestKit/wiki/Upgrading-from-v0.10.x-to-v0.20.0 - Upgrading from v0.10.x to v0.20.0
I need to find release notes for Bash from 3 to 4.
I could not find them neither by google.com/linux nor by default google.
I also looked unsuccessfully at gnu.org.
Where are the release notes for Bash?
From Bash website you can download "Bourne again shell (BASH)".
Inside the download you can find the release notes.
EDIT: Or browse the source online, see NEWS for the summaries, and CHANGES for details.
For patch releases, these could be useful:
https://ftp.gnu.org/gnu/bash/bash-4.4-patches/
https://ftp.gnu.org/gnu/bash/bash-5.0-patches/
https://ftp.gnu.org/gnu/bash/bash-5.1-patches/
https://ftp.gnu.org/gnu/bash/bash-5.2-patches/
There are two files distributed with the source: NEWS and CHANGES. CHANGES documents everything, while NEWS summarises new features.
You can find a summary for BASH 4 here, or check out section B1 of the FAQ for the latest NEWS.
Here you go:
http://tiswww.case.edu/php/chet/bash/NEWS
On my machine (Ubuntu 9.04) it's located at /usr/share/doc/bash/CHANGES.gz