Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork7.9k
Doc multi version master#1100
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Merged
Merged
Uh oh!
There was an error while loading.Please reload this page.
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
stix_fonts_demo.py fails with bad refcount
broken links in the gallery
This allows for multiple versions of the matplotlib documentation tobe made available. The scheme is that the rootdocumentation (i.e.http://matplotlib.sf.net/) will always be thelatest stable version. Other versions of the documentation will beavailable in subdirectories off of the root (the latest stable versionis merely a symlink or redirect back to the root). This is the sameconvention used by "docs.python.org", as an aside.The index.html page uses some JavaScript to load a little snippet ofHTML from "/versions.html" that lists the available versions."versions.html" is not part of this repository, but is part of thematplotlib.github.com repository and is updated by hand whenever newversions are added or removed from the archive. This approach allowsall versions of the documentation to point to all other versions ofthe documentation. This JavaScript XMLHttpRequest magic doesn'thappen when the user is viewing static files on their local machine,and this is a happy coincidence.The perhaps controversial outcome of this change is that the summarylist of plotting commands is removed from the front page. For one, wewant to steer people toward the version of the documentation thatcorresponds to the version they are running. Also, this was amanually created list, and has become quite out of date over time.Better, IMHO, to link to the pyplot documentation.This freed up room to move much of the content that existed in thesidebar to the main body, where I feel it's much less buried. I planto add a lot more external resources and links, so having the room todo this would be very helpful.Adds a "Fork me on Github" banner.
Support multi-version documentation on the website
…_masterConflicts:boilerplate.pylib/matplotlib/image.pylib/matplotlib/pyplot.py
Note also: There are a ton of warnings and errors in the master doc build right now. I will create another pull request for that. |
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This is#1067 rebased against master. There shouldn't be too much to vet here, except for@pelson's benefit to see how the changes to
boilerplate.py
were handled.There was no need to generate a colormap list in this case, since master already has a correct and autogenerated list of colormaps thanks to the work by@endolith.
It was not possible to generate the
plotting
docstring inboilerplate.py
, sinceboilerplate.py
doesn't know about any of the hard-coded functions inpyplot.py
(gca
,gcf
etc.) -- ideally at some point all that stuff should probably be cleaned up, but this is working for now.