Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
GitHub is where the world builds software
Millions of developers and companies build, ship, and maintain their software on GitHub — the largest and most advanced development platform in the world.
Fix Python 3.7 and PEP 479 incompatibility #1518
PyPI's documentation hosting has been deprecated, and in fact, it is no longer possable to upload documentation to PyPI. Therefore, it is a disservice to our users to document how to deploy to that service. See the mailing list dicussions for the official announcement: https://mail.python.org/pipermail/distutils-sig/2015-May/026327.html https://mail.python.org/pipermail/distutils-sig/2015-May/026381.html
Python-Markdown has moved its documentation to https://python-markdown.github.io/. See Python-Markdown/markdown#601 for details. The docs now point to the new location. The Python-Markdown GitHub repo was also moved to https://github.com/Python-Markdown/markdown so any links to the repo have been updated as well.
Present the sections in a logical manner: 1. File Layout (where to save documents) * Configure Navigation... 2. Writing with Markdown * Supported extensions... Added documentation for all included extensions. Also added some basic information about Markdown; pointing to the implementation and rules. Fixes #1385, fixes #316, and fixes #1172.
This should help when providing support to users with multiple Pythons installed on their system. The `--version` flag's output mimics pip. Specifically, the location `mkdocs` is installed at and the Python version it is installed under. Typical output might look like: mkdocs, version 0.17.2 from /usr/local/lib/python2.7/site-packages/mkdocs (Python 2.7)
* Use a web worker in the browser with a fallback (fixes #859 & closes #1396). * Optionally pre-build search index (fixes #859 & closes #1061). * Upgrade to lunr.js 2.x (fixes #1319). * Support search in languages other than English (fixes #826). * Allow the user to define the word separators (fixes #867). * Only run searches for queries of length > 2 (fixes #1127). * Remove dependency on require.js, mustache, etc. (fixes #1218). * Compress the search index (fixes #1128).
Note that the icons in the themes will not show up until FontAwesome is updated to at least version 4.6 and/or an up-to-date version of the upstream readthedocs css is imported. This commit also fixes a slight documentation error regarding the default value of `repo_name` and removes some tautological tests.
If/when deploying to usr/org pages, the deploy script is run from the Pages repo, not the project repo. Therefore, we need ot get the current sha from the project repo.
The previous version worked only when ../mkdocs was pointing back to the current directory. Fixes #1490.
With [PEP 479](https://www.python.org/dev/peps/pep-0479/) implemented in Python 3.7, raised `StopIteration` is now translated into `RuntimeError`, which breaks `mkdocs build` command. The recommended way to exit generators is to use `return` instead of raising `StopIteartion`: https://www.python.org/dev/peps/pep-0479/#id39
Notice that by switching the branch we get all of the commits on master up to and including the relevant commit. However, we only want the one relevant commit. Therefore, I cloned your repo locally, cherry-picked your commit and pushed it to #1536. No need for you to do do anything else at this point.