pax_global_header 0000666 0000000 0000000 00000000064 12535531646 0014524 g ustar 00root root 0000000 0000000 52 comment=40e7bb02bba2b44f9b6fd446c832ebeccc2654c9 mkdocs-0.14.0/ 0000775 0000000 0000000 00000000000 12535531646 0013066 5 ustar 00root root 0000000 0000000 mkdocs-0.14.0/.gitignore 0000664 0000000 0000000 00000000101 12535531646 0015046 0 ustar 00root root 0000000 0000000 site/ env/ dist/ htmlcov/ .tox/ mkdocs.egg-info/ *.pyc .coverage mkdocs-0.14.0/.travis.yml 0000664 0000000 0000000 00000000572 12535531646 0015203 0 ustar 00root root 0000000 0000000 language: python python: '2.7' env: - TOXENV=py26-unittests - TOXENV=py27-unittests - TOXENV=py33-unittests - TOXENV=py34-unittests - TOXENV=py26-integration - TOXENV=py27-integration - TOXENV=py33-integration - TOXENV=py34-integration - TOXENV=flake8 install: - pip install tox script: tox matrix: fast_finish: true before_install: pip install codecov after_success: codecov mkdocs-0.14.0/CONTRIBUTING.md 0000664 0000000 0000000 00000000244 12535531646 0015317 0 ustar 00root root 0000000 0000000 # Contributing to MkDocs See the contributing guide in the documentation for an introduction to contributing to MkDocs. http://www.mkdocs.org/about/contributing/ mkdocs-0.14.0/LICENSE 0000664 0000000 0000000 00000002404 12535531646 0014073 0 ustar 00root root 0000000 0000000 Copyright © 2014, Tom Christie. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. mkdocs-0.14.0/MANIFEST.in 0000664 0000000 0000000 00000000224 12535531646 0014622 0 ustar 00root root 0000000 0000000 recursive-include mkdocs/themes *.ico *.js *.css *.png *.html *.eot *.svg *.ttf *.woff recursive-exclude * __pycache__ recursive-exclude * *.py[co] mkdocs-0.14.0/README.md 0000664 0000000 0000000 00000003002 12535531646 0014340 0 ustar 00root root 0000000 0000000 # MkDocs **Project documentation with Markdown.** [![PyPI Downloads][pypi-dl-image]][pypi-dl-link] [![PyPI Version][pypi-v-image]][pypi-v-link] [![Build Status][travis-image]][travis-link] [![Windows Build Status][appveyor-image]][appveyor-link] [![Coverage Status][codecov-image]][codecov-link] [![Landscale Code Health][landscape-image]][landscape-link] **See the MkDocs documentation: [www.mkdocs.org][mkdocs]** Release notes: http://www.mkdocs.org/about/release-notes/ Project roadmap: [https://github.com/mkdocs/mkdocs/wiki][roadmap] IRC channel: `#mkdocs` on freenode. Discussions and support: https://groups.google.com/forum/#!forum/mkdocs [appveyor-image]: https://img.shields.io/appveyor/ci/d0ugal/mkdocs/master.png [appveyor-link]: https://ci.appveyor.com/project/d0ugal/mkdocs [codecov-image]: http://codecov.io/github/mkdocs/mkdocs/coverage.svg?branch=master [codecov-link]: http://codecov.io/github/mkdocs/mkdocs?branch=master [landscape-image]: https://landscape.io/github/mkdocs/mkdocs/master/landscape.svg?style=flat-square [landscape-link]: https://landscape.io/github/mkdocs/mkdocs/master [pypi-dl-image]: https://img.shields.io/pypi/dm/mkdocs.png [pypi-dl-link]: https://pypi.python.org/pypi/mkdocs [pypi-v-image]: https://img.shields.io/pypi/v/mkdocs.png [pypi-v-link]: https://pypi.python.org/pypi/mkdocs [travis-image]: https://img.shields.io/travis/mkdocs/mkdocs/master.png [travis-link]: https://travis-ci.org/mkdocs/mkdocs [mkdocs]: http://www.mkdocs.org [roadmap]: https://github.com/mkdocs/mkdocs/wiki mkdocs-0.14.0/appveyor.yml 0000664 0000000 0000000 00000001347 12535531646 0015463 0 ustar 00root root 0000000 0000000 build: false environment: matrix: - TOXENV: py27-unittests - TOXENV: py33-unittests - TOXENV: py34-unittests - TOXENV: py27-integration - TOXENV: py33-integration - TOXENV: py34-integration - TOXENV: flake8 init: - "ECHO %TOXENV%" - ps: "ls C:\\Python*" install: - ps: Invoke-WebRequest "https://bootstrap.pypa.io/ez_setup.py" -OutFile "c:\\ez_setup.py" - ps: Invoke-WebRequest "https://bootstrap.pypa.io/get-pip.py" -OutFile "c:\\get-pip.py" - "c:\\python27\\python c:\\ez_setup.py" - "c:\\python27\\python c:\\get-pip.py" - "c:\\python27\\Scripts\\pip install tox" test_script: - "c:\\python27\\Scripts\\tox --version" - "c:\\python27\\Scripts\\pip --version" - "c:\\python27\\Scripts\\tox" mkdocs-0.14.0/docs/ 0000775 0000000 0000000 00000000000 12535531646 0014016 5 ustar 00root root 0000000 0000000 mkdocs-0.14.0/docs/CNAME 0000664 0000000 0000000 00000000017 12535531646 0014562 0 ustar 00root root 0000000 0000000 www.mkdocs.org mkdocs-0.14.0/docs/about/ 0000775 0000000 0000000 00000000000 12535531646 0015130 5 ustar 00root root 0000000 0000000 mkdocs-0.14.0/docs/about/contributing.md 0000664 0000000 0000000 00000004373 12535531646 0020170 0 ustar 00root root 0000000 0000000 # Contributing to MkDocs An introduction to contributing to the MkDocs project. The MkDocs project welcomes, and depends, on contributions from developers and users in the open source community. Contributions can be made in a number of ways, a few examples are: - Code patches via pull requests - Documentation improvements - Bug reports and patch reviews ## Reporting an Issue? Please include as much detail as you can. Let us know your platform and MkDocs version. If the problem is visual (for example a theme or design issue) please add a screenshot and if you get an error please include the the full error and traceback. ## Testing the Development Version If you want to just install and try out the latest development version of MkDocs you can do so with the following command. This can be useful if you want to provide feedback for a new feature or want to confirm if a bug you have encountered is fixed in the git master. It is **strongly** recommended that you do this within a [virtualenv]. ```bash pip install https://github.com/mkdocs/mkdocs/archive/master.tar.gz ``` ## Installing for Development First you'll need to fork and clone the repository. Once you have a local copy, run the following command. It is **strongly** recommended that you do this within a [virtualenv]. ```bash pip install --editable . ``` This will install MkDocs in development mode which binds the `mkdocs` command to the git repository. ## Running the tests To run the tests, it is recommended that you use [Tox]. This just needs to be pip installed and then the test suite can be ran for MkDocs but running the command `tox` in the root of your MkDocs repository. It will attempt to run the tests against all of the Python versions we support. So don't be concerned if you are missing some and they fail. The rest will be verified by [Travis] when you submit a pull request. ## Submitting Pull Requests Once you are happy with your changes or you are ready for some feedback, push it to your fork and send a pull request. For a change to be accepted it will most likely need to have tests and documentation if it is a new feature. [virtualenv]: https://virtualenv.pypa.io/en/latest/userguide.html [tox]: https://tox.readthedocs.org/en/latest/ [travis]: https://travis-ci.org/repositories mkdocs-0.14.0/docs/about/license.md 0000664 0000000 0000000 00000003577 12535531646 0017110 0 ustar 00root root 0000000 0000000 # License The legal stuff. --- #### Included projects Themes used under license from the Bootstrap, ReadTheDocs, GhostWriter and Bootswatch projects. * Bootstrap theme - [View license](//github.com/twbs/bootstrap/blob/master/LICENSE). * ReadTheDocs theme - [View license](//github.com/snide/sphinx_rtd_theme/blob/master/LICENSE). * Bootswatch theme - [View license](//github.com/thomaspark/bootswatch/blob/gh-pages/LICENSE). * Highlight.js GitHub theme - [View license](//github.com/isagalaev/highlight.js/blob/master/LICENSE). Many thanks to the authors and contributors of those wonderful projects. #### MkDocs License (BSD) Copyright © 2014, Tom Christie. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. mkdocs-0.14.0/docs/about/release-notes.md 0000664 0000000 0000000 00000026671 12535531646 0020234 0 ustar 00root root 0000000 0000000 # Release Notes --- ## Upgrading To upgrade MkDocs to the latest version, use pip: pip install -U mkdocs You can determine your currently installed version using `mkdocs --version`: $ mkdocs --version mkdocs, version 0.14.0 ## Version 0.14.0 (2015-06-09) * Improve Unicode handling by ensuring that all config strings are loaded as Unicode. (#592) * Remove dependancy on the six library. (#583) * Remove dependancy on the ghp-import library. (#547) * Add `--quiet` and `--verbose` options to all subcommands. (#579) * Add short options (`-a`) to most command line options. (#579) * Add copyright footer for readthedocs theme. (#568) * If the requested port in `mkdocs serve` is already in use, don't show the user a full stack trace. (#596) * Bugfix: Fix a JavaScript encoding problem when searching with spaces. (#586) * Bugfix: gh-deploy now works if the mkdocs.yml is not in the git repo root. (#578) * Bugfix: Handle (pass-through instead of dropping) HTML entities while parsing TOC. (#612) * Bugfix: Default extra_templates to an empty list, don't automatically discover them. (#616) ## Version 0.13.3 (2015-06-02) * Bugfix: Reduce validation error to a warning if the site_dir is within the docs_dir as this shouldn't cause any problems with building but will inconvenience users building multiple times. (#580) ## Version 0.13.2 (2015-05-30) * Bugfix: Ensure all errors and warnings are logged before exiting. (#536) * Bugfix: Fix compatibility issues with ReadTheDocs. (#554) ## Version 0.13.1 (2015-05-27) * Bugfix: Fix a problem with minimal configurations which only contain a list of paths in the pages config. (#562) ## Version 0.13.0 (2015-05-26) ### Deprecations #### Deprecate the JSON command In this release the `mkdocs json` command has been marked as deprecated and when used a deprecation warning will be shown. It will be removed in a [future release] of MkDocs, version 1.0 at the latest. The `mkdocs json` command provided a convenient way for users to output the documentation contents as JSON files but with the additions of search to MkDocs this functionality is duplicated. A new index with all the contents from a MkDocs build is created in the [site_dir], so with the default value for the `site_dir` It can be found in `site/mkdocs/search_index.json`. This new file is created on every MkDocs build (with `mkdocs build`) and no configuration is needed to enable it. [future release]: https://github.com/mkdocs/mkdocs/pull/481 [site_dir]: /user-guide/configuration/#site_dir #### Change the pages configuration Provide a [new way] to define pages, and specifically [nested pages], in the mkdocs.yml file and deprecate the existing approach, support will be removed with MkDocs 1.0. [new way]: /user-guide/writing-your-docs/#configure-pages-and-navigation [nested pages]: /user-guide/writing-your-docs/#multilevel-documentation #### Warn users about the removal of builtin themes All themes other than mkdocs and readthedocs will be moved into external packages in a future release of MkDocs. This will enable them to be more easily supported and updates outside MkDocs releases. ### Major Additions #### Search Support for search has now been added to MkDocs. This is based on the JavaScript library [lunr.js]. It has been added to both the `mkdocs` and `readthedocs` themes. See the custom theme documentation on [supporting search] for adding it to your own themes. [lunr.js]: http://lunrjs.com/ [supporting search]: /user-guide/styling-your-docs/#search-and-themes #### New Command Line Interface The command line interface for MkDocs has been re-written with the Python library [Click]. This means that MkDocs now has an easier to use interface with better help output. This change is partially backwards incompatible as while undocumented it was possible to pass any configuration option to the different commands. Now only a small subset of the configuration options can be passed to the commands. To see in full commands and available arguments use `mkdocs --help` and `mkdocs build --help` to have them displayed. [Click]: http://click.pocoo.org/4/ #### Support Extra HTML and XML files Like the [extra_javascript] and [extra_css] configuration options, a new option named [extra_templates] has been added. This will automatically be populated with any `.html` or `.xml` files in the project docs directory. Users can place static HTML and XML files and they will be copied over, or they can also use Jinja2 syntax and take advantage of the [global variables]. By default MkDocs will use this approach to create a sitemap for the documentation. [extra_javascript]: /user-guide/configuration/#extra_javascript [extra_css]: /user-guide/configuration/#extra_css [extra_templates]: /user-guide/configuration/#extra_templates [global variables]: /user-guide/styling-your-docs/#global-context ### Other Changes and Additions * Add support for [Markdown extension configuration options]. (#435) * MkDocs now ships Python [wheels]. (#486) * Only include the build date and MkDocs version on the homepage. (#490) * Generate sitemaps for documentation builds. (#436) * Add a clearer way to define nested pages in the configuration. (#482) * Add an [extra config] option for passing arbitrary variables to the template. (#510) * Add `--no-livereload` to `mkdocs serve` for a simpler development server. (#511) * Add copyright display support to all themes (#549) * Add support for custom commit messages in a `mkdocs gh-deploy` (#516) * Bugfix: Fix linking to media within the same directory as a markdown file called index.md (#535) * Bugfix: Fix errors with unicode filenames (#542). [extra config]: /user-guide/configuration/#extra [Markdown extension configuration options]: /user-guide/configuration/#markdown_extensions [wheels]: http://pythonwheels.com/ ## Version 0.12.2 (2015-04-22) * Bugfix: Fix a regression where there would be an error if some child titles were missing but others were provided in the pages config. (#464) ## Version 0.12.1 (2015-04-14) * Bugfix: Fixed a CSS bug in the table of contents on some browsers where the bottom item was not clickable. ## Version 0.12.0 (2015-04-14) * Display the current MkDocs version in the CLI output. (#258) * Check for CNAME file when using gh-deploy. (#285) * Add the homepage back to the navigation on all themes. (#271) * Add a strict more for local link checking. (#279) * Add Google analytics support to all themes. (#333) * Add build date and MkDocs version to the ReadTheDocs and MkDocs theme outputs. (#382) * Standardise highlighting across all themes and add missing languages. (#387) * Add a verbose flag. (-v) to show more details about what the build. (#147) * Add the option to specify a remote branch when deploying to GitHub. This enables deploying to GitHub pages on personal and repo sites. (#354) * Add favicon support to the ReadTheDocs theme HTML. (#422) * Automatically refresh the browser when files are edited. (#163) * Bugfix: Never re-write URL's in code blocks. (#240) * Bugfix: Don't copy ditfiles when copying media from the `docs_dir`. (#254) * Bugfix: Fix the rendering of tables in the ReadTheDocs theme. (#106) * Bugfix: Add padding to the bottom of all bootstrap themes. (#255) * Bugfix: Fix issues with nested Markdown pages and the automatic pages configuration. (#276) * Bugfix: Fix a URL parsing error with GitHub enterprise. (#284) * Bugfix: Don't error if the mkdocs.yml is completely empty. (#288) * Bugfix: Fix a number of problems with relative urls and Markdown files. (#292) * Bugfix: Don't stop the build if a page can't be found, continue with other pages. (#150) * Bugfix: Remove the site_name from the page title, this needs to be added manually. (#299) * Bugfix: Fix an issue with table of contents cutting off Markdown. (#294) * Bugfix: Fix hostname for BitBucket. (#339) * Bugfix: Ensure all links end with a slash. (#344) * Bugfix: Fix repo links in the readthedocs theme. (#365) * Bugfix: Include jQuery locally to avoid problems using MkDocs offline. (#143) * Bugfix: Don't allow the docs_dir to be in the site_dir or vice versa. (#384) * Bugfix: Remove inline CSS in the ReadTheDocs theme. (#393) * Bugfix: Fix problems with the child titles due to the order the pages config was processed. (#395) * Bugfix: Don't error during live reload when the theme doesn't exist. (#373) * Bugfix: Fix problems with the Meta extension when it may not exist. (#398) * Bugfix: Wrap long inline code otherwise they will run off the screen. (#313) * Bugfix: Remove HTML parsing regular expressions and parse with HTMLParser to fix problems with titles containing code. (#367) * Bugfix: Fix an issue with the scroll to anchor causing the title to be hidden under the navigation. (#7) * Bugfix: Add nicer CSS classes to the HTML tables in bootswatch themes. (#295) * Bugfix: Fix an error when passing in a specific config file with `mkdocs serve`. (#341) * Bugfix: Don't overwrite index.md diles with the `mkdocs new` command. (#412) * Bugfix: Remove bold and italic from code in the ReadTheDocs theme. (#411) * Bugfix: Display images inline in the MkDocs theme. (#415) * Bugfix: Fix problems with no-highlight in the ReadTheDocs theme. (#319) * Bugfix: Don't delete hidden files when using `mkdocs build --clean`. (#346) * Bugfix: Don't block newer verions of Python-markdown on Python >= 2.7. (#376) * Bugfix: Fix encoding issues when opening files across platforms. (#428) ## Version 0.11.1 (2014-11-20) * Bugfix: Fix a CSS wrapping issue with code highlighting in the ReadTheDocs theme. (#233) ## Version 0.11.0 (2014-11-18) * Render 404.html files if they exist for the current theme. (#194) * Bugfix: Fix long nav bars, table rendering and code highlighting in MkDocs and ReadTheDocs themes. (#225) * Bugfix: Fix an issue with the google_analytics code. (#219) * Bugfix: Remove `__pycache__` from the package tar. (#196) * Bugfix: Fix markdown links that go to an anchor on the current page. (#197) * Bugfix: Don't add `prettyprint well` CSS classes to all HTML, only add it in the MkDocs theme. (#183) * Bugfix: Display section titles in the ReadTheDocs theme. (#175) * Bugfix: Use the polling observer in watchdog so rebuilding works on filesystems without inotify. (#184) * Bugfix: Improve error output for common configuration related errors. (#176) ## Version 0.10.0 (2014-10-29) * Added support for Python 3.3 and 3.4. (#103) * Configurable Python-Markdown extensions with the config setting `markdown_extensions`. (#74) * Added `mkdocs json` command to output your rendered documentation as json files. (#128) * Added `--clean` switch to `build`, `json` and `gh-deploy` commands to remove stale files from the output directory. (#157) * Support multiple theme directories to allow replacement of individual templates rather than copying the full theme. (#129) * Bugfix: Fix `