mirror of
https://github.com/mkdocs/mkdocs.git
synced 2026-03-27 09:58:31 +07:00
513 lines
27 KiB
HTML
513 lines
27 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="Project documentation with Markdown.">
|
|
<meta name="author" content="MkDocs Team">
|
|
<link rel="canonical" href="https://www.mkdocs.org/">
|
|
<link rel="shortcut icon" href="img/favicon.ico">
|
|
<title>MkDocs</title>
|
|
<link href="css/bootstrap.min.css" rel="stylesheet">
|
|
<link href="css/font-awesome.min.css" rel="stylesheet">
|
|
<link href="css/base.css" rel="stylesheet">
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/github.min.css">
|
|
<link href="css/extra.css" rel="stylesheet">
|
|
|
|
<script src="js/jquery-1.10.2.min.js" defer></script>
|
|
<script src="js/bootstrap.min.js" defer></script>
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/django.min.js"></script>
|
|
<script>hljs.initHighlightingOnLoad();</script>
|
|
<script>
|
|
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
|
|
|
|
ga('create', 'UA-27795084-5', 'mkdocs.org');
|
|
ga('send', 'pageview');
|
|
</script>
|
|
</head>
|
|
|
|
<body class="homepage">
|
|
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
|
|
<div class="container">
|
|
<a class="navbar-brand" href=".">MkDocs</a>
|
|
<!-- Expander button -->
|
|
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
|
<span class="navbar-toggler-icon"></span>
|
|
</button>
|
|
|
|
<!-- Expanded navigation -->
|
|
<div id="navbar-collapse" class="navbar-collapse collapse">
|
|
<!-- Main navigation -->
|
|
<ul class="nav navbar-nav">
|
|
<li class="navitem active">
|
|
<a href="." class="nav-link">Home</a>
|
|
</li>
|
|
<li class="dropdown">
|
|
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
|
|
<li>
|
|
<a href="user-guide/writing-your-docs/" class="dropdown-item">Writing Your Docs</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="user-guide/styling-your-docs/" class="dropdown-item">Styling Your Docs</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="user-guide/configuration/" class="dropdown-item">Configuration</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="user-guide/deploying-your-docs/" class="dropdown-item">Deploying Your Docs</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="user-guide/custom-themes/" class="dropdown-item">Custom Themes</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="user-guide/plugins/" class="dropdown-item">Plugins</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="dropdown">
|
|
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">About <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
|
|
<li>
|
|
<a href="about/release-notes/" class="dropdown-item">Release Notes</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="about/contributing/" class="dropdown-item">Contributing</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="about/license/" class="dropdown-item">License</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<ul class="nav navbar-nav ml-auto">
|
|
<li class="nav-item">
|
|
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
|
<i class="fa fa-search"></i> Search
|
|
</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a rel="prev" class="nav-link disabled">
|
|
<i class="fa fa-arrow-left"></i> Previous
|
|
</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a rel="next" href="user-guide/writing-your-docs/" class="nav-link">
|
|
Next <i class="fa fa-arrow-right"></i>
|
|
</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a href="https://github.com/mkdocs/mkdocs/" class="nav-link"><i class="fa fa-github"></i> GitHub</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
|
<div class="navbar-header">
|
|
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
|
<span class="fa fa-angle-down"></span>
|
|
</button>
|
|
</div>
|
|
|
|
|
|
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
|
<ul class="nav flex-column">
|
|
|
|
<li class="nav-item" data-level="1"><a href="#mkdocs" class="nav-link">MkDocs</a>
|
|
<ul class="nav flex-column">
|
|
<li class="nav-item" data-level="2"><a href="#overview" class="nav-link">Overview</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#installation" class="nav-link">Installation</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#getting-started" class="nav-link">Getting Started</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#adding-pages" class="nav-link">Adding pages</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#theming-our-documentation" class="nav-link">Theming our documentation</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#changing-the-favicon-icon" class="nav-link">Changing the Favicon Icon</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#building-the-site" class="nav-link">Building the site</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#other-commands-and-options" class="nav-link">Other Commands and Options</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#deploying" class="nav-link">Deploying</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-level="2"><a href="#getting-help" class="nav-link">Getting help</a>
|
|
<ul class="nav flex-column">
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div></div>
|
|
<div class="col-md-9" role="main">
|
|
|
|
<h1 id="mkdocs">MkDocs<a class="headerlink" href="#mkdocs" title="Permanent link"></a></h1>
|
|
<p>Project documentation with Markdown.</p>
|
|
<hr />
|
|
<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link"></a></h2>
|
|
<p>MkDocs is a <strong>fast</strong>, <strong>simple</strong> and <strong>downright gorgeous</strong> static site
|
|
generator that's geared towards building project documentation. Documentation
|
|
source files are written in Markdown, and configured with a single YAML
|
|
configuration file. Start by reading the introduction below, then check the User
|
|
Guide for more info.</p>
|
|
<h3 id="host-anywhere">Host anywhere<a class="headerlink" href="#host-anywhere" title="Permanent link"></a></h3>
|
|
<p>MkDocs builds completely static HTML sites that you can host on GitHub pages,
|
|
Amazon S3, or <a href="user-guide/deploying-your-docs/">anywhere</a> else you choose.</p>
|
|
<h3 id="great-themes-available">Great themes available<a class="headerlink" href="#great-themes-available" title="Permanent link"></a></h3>
|
|
<p>There's a stack of good looking <a href="user-guide/styling-your-docs/">themes</a> available for MkDocs. Choose between
|
|
the built in themes: <a href="user-guide/styling-your-docs/#mkdocs">mkdocs</a> and <a href="user-guide/styling-your-docs/#readthedocs">readthedocs</a>, select one of the 3rd
|
|
party themes listed on the <a href="https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes">MkDocs Themes</a> wiki page, or <a href="user-guide/custom-themes/">build your own</a>.</p>
|
|
<h3 id="preview-your-site-as-you-work">Preview your site as you work<a class="headerlink" href="#preview-your-site-as-you-work" title="Permanent link"></a></h3>
|
|
<p>The built-in dev-server allows you to preview your documentation as you're
|
|
writing it. It will even auto-reload and refresh your browser whenever you save
|
|
your changes.</p>
|
|
<h3 id="easy-to-customize">Easy to customize<a class="headerlink" href="#easy-to-customize" title="Permanent link"></a></h3>
|
|
<p>Get your project documentation looking just the way you want it by customizing
|
|
the <a href="user-guide/configuration/#theme">theme</a> and/or installing some <a href="user-guide/plugins/">plugins</a>.</p>
|
|
<hr />
|
|
<h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link"></a></h2>
|
|
<h3 id="install-with-a-package-manager">Install with a Package Manager<a class="headerlink" href="#install-with-a-package-manager" title="Permanent link"></a></h3>
|
|
<p>If you have and use a package manager (such as <a href="https://help.ubuntu.com/community/AptGet/Howto">apt-get</a>, <a href="https://dnf.readthedocs.io/en/latest/index.html">dnf</a>, <a href="https://brew.sh/">homebrew</a>,
|
|
<a href="http://yum.baseurl.org/">yum</a>, <a href="https://chocolatey.org/">chocolatey</a>, etc.) to install packages on your system, then you may
|
|
want to search for a "MkDocs" package and, if a recent version is available,
|
|
install it with your package manager (check your system's documentation for
|
|
details). That's it, you're done! Skip down to <a href="#getting-started">Getting Started</a>.</p>
|
|
<p>If your package manager does not have a recent "MkDocs" package, you can still
|
|
use your package manager to install "Python" and "pip". Then you can use pip to
|
|
<a href="#installing-mkdocs">install MkDocs</a>.</p>
|
|
<h3 id="manual-installation">Manual Installation<a class="headerlink" href="#manual-installation" title="Permanent link"></a></h3>
|
|
<p>In order to manually install MkDocs you'll need <a href="https://www.python.org/">Python</a> installed on your
|
|
system, as well as the Python package manager, <a href="https://pip.readthedocs.io/en/stable/installing/">pip</a>. You can check if you have
|
|
these already installed from the command line:</p>
|
|
<pre><code class="bash">$ python --version
|
|
Python 2.7.14
|
|
$ pip --version
|
|
pip 18.1 from /usr/local/lib/python2.7/site-packages/pip (python 2.7)
|
|
</code></pre>
|
|
|
|
<p>MkDocs supports Python versions 2.7.9+, 3.4, 3.5, 3.6, 3.7, and pypy.</p>
|
|
<h4 id="installing-python">Installing Python<a class="headerlink" href="#installing-python" title="Permanent link"></a></h4>
|
|
<p>Install <a href="https://www.python.org/">Python</a> by downloading an installer appropriate for your system from
|
|
<a href="https://www.python.org/downloads/">python.org</a> and running it.</p>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">Note</p>
|
|
<p>If you are installing Python on Windows, be sure to check the box to have
|
|
Python added to your PATH if the installer offers such an option (it's
|
|
normally off by default).</p>
|
|
<p><img alt="Add Python to PATH" src="img/win-py-install.png" /></p>
|
|
</div>
|
|
<h4 id="installing-pip">Installing pip<a class="headerlink" href="#installing-pip" title="Permanent link"></a></h4>
|
|
<p>If you're using a recent version of Python, the Python package manager, <a href="https://pip.readthedocs.io/en/stable/installing/">pip</a>,
|
|
is most likely installed by default. However, you may need to upgrade pip to the
|
|
lasted version:</p>
|
|
<pre><code class="bash">pip install --upgrade pip
|
|
</code></pre>
|
|
|
|
<p>If you need to install <a href="https://pip.readthedocs.io/en/stable/installing/">pip</a> for the first time, download <a href="https://bootstrap.pypa.io/get-pip.py">get-pip.py</a>.
|
|
Then run the following command to install it:</p>
|
|
<pre><code class="bash">python get-pip.py
|
|
</code></pre>
|
|
|
|
<h4 id="installing-mkdocs">Installing MkDocs<a class="headerlink" href="#installing-mkdocs" title="Permanent link"></a></h4>
|
|
<p>Install the <code>mkdocs</code> package using pip:</p>
|
|
<pre><code class="bash">pip install mkdocs
|
|
</code></pre>
|
|
|
|
<p>You should now have the <code>mkdocs</code> command installed on your system. Run <code>mkdocs
|
|
--version</code> to check that everything worked okay.</p>
|
|
<pre><code class="bash">$ mkdocs --version
|
|
mkdocs, version 0.15.3
|
|
</code></pre>
|
|
|
|
<div class="admonition note">
|
|
<p class="admonition-title">Note</p>
|
|
<p>If you would like manpages installed for MkDocs, the <a href="https://github.com/click-contrib/click-man">click-man</a> tool can
|
|
generate and install them for you. Simply run the following two commands:</p>
|
|
<pre><code>pip install click-man
|
|
click-man --target path/to/man/pages mkdocs
|
|
</code></pre>
|
|
<p>See the <a href="https://github.com/click-contrib/click-man#automatic-man-page-installation-with-setuptools-and-pip">click-man documentation</a> for an explanation of why manpages are
|
|
not automatically generated and installed by pip.</p>
|
|
</div>
|
|
<div class="admonition note">
|
|
<p class="admonition-title">Note</p>
|
|
<p>If you are using Windows, some of the above commands may not work
|
|
out-of-the-box.</p>
|
|
<p>A quick solution may be to preface every Python command with <code>python -m</code>
|
|
like this:</p>
|
|
<pre><code>python -m pip install mkdocs
|
|
python -m mkdocs
|
|
</code></pre>
|
|
<p>For a more permanent solution, you may need to edit your <code>PATH</code> environment
|
|
variable to include the <code>Scripts</code> directory of your Python installation.
|
|
Recent versions of Python include a script to do this for you. Navigate to
|
|
your Python installation directory (for example <code>C:\Python34\</code>), open the
|
|
<code>Tools</code>, then <code>Scripts</code> folder, and run the <code>win_add2path.py</code> file by double
|
|
clicking on it. Alternatively, you can <a href="https://svn.python.org/projects/python/trunk/Tools/scripts/win_add2path.py">download</a> the script and run it
|
|
(<code>python win_add2path.py</code>).</p>
|
|
</div>
|
|
<hr />
|
|
<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link"></a></h2>
|
|
<p>Getting started is super easy.</p>
|
|
<pre><code class="bash">mkdocs new my-project
|
|
cd my-project
|
|
</code></pre>
|
|
|
|
<p>Take a moment to review the initial project that has been created for you.</p>
|
|
<p><img alt="The initial MkDocs layout" src="img/initial-layout.png" /></p>
|
|
<p>There's a single configuration file named <code>mkdocs.yml</code>, and a folder named
|
|
<code>docs</code> that will contain your documentation source files. Right now the <code>docs</code>
|
|
folder just contains a single documentation page, named <code>index.md</code>.</p>
|
|
<p>MkDocs comes with a built-in dev-server that lets you preview your documentation
|
|
as you work on it. Make sure you're in the same directory as the <code>mkdocs.yml</code>
|
|
configuration file, and then start the server by running the <code>mkdocs serve</code>
|
|
command:</p>
|
|
<pre><code class="bash">$ mkdocs serve
|
|
INFO - Building documentation...
|
|
INFO - Cleaning site directory
|
|
[I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000
|
|
[I 160402 15:50:43 handlers:58] Start watching changes
|
|
[I 160402 15:50:43 handlers:60] Start detecting changes
|
|
</code></pre>
|
|
|
|
<p>Open up <code>http://127.0.0.1:8000/</code> in your browser, and you'll see the default
|
|
home page being displayed:</p>
|
|
<p><img alt="The MkDocs live server" src="img/screenshot.png" /></p>
|
|
<p>The dev-server also supports auto-reloading, and will rebuild your documentation
|
|
whenever anything in the configuration file, documentation directory, or theme
|
|
directory changes.</p>
|
|
<p>Open the <code>docs/index.md</code> document in your text editor of choice, change the
|
|
initial heading to <code>MkLorum</code>, and save your changes. Your browser will
|
|
auto-reload and you should see your updated documentation immediately.</p>
|
|
<p>Now try editing the configuration file: <code>mkdocs.yml</code>. Change the
|
|
<a href="user-guide/configuration/#site_name"><code>site_name</code></a> setting to <code>MkLorum</code> and save the file.</p>
|
|
<pre><code class="yaml">site_name: MkLorum
|
|
</code></pre>
|
|
|
|
<p>Your browser should immediately reload, and you'll see your new site name take
|
|
effect.</p>
|
|
<p><img alt="The site_name setting" src="img/site-name.png" /></p>
|
|
<h2 id="adding-pages">Adding pages<a class="headerlink" href="#adding-pages" title="Permanent link"></a></h2>
|
|
<p>Now add a second page to your documentation:</p>
|
|
<pre><code class="bash">curl 'https://jaspervdj.be/lorem-markdownum/markdown.txt' > docs/about.md
|
|
</code></pre>
|
|
|
|
<p>As our documentation site will include some navigation headers, you may want to
|
|
edit the configuration file and add some information about the order, title, and
|
|
nesting of each page in the navigation header by adding a <a href="user-guide/configuration/#nav"><code>nav</code></a>
|
|
setting:</p>
|
|
<pre><code class="yaml">site_name: MkLorum
|
|
nav:
|
|
- Home: index.md
|
|
- About: about.md
|
|
</code></pre>
|
|
|
|
<p>Save your changes and you'll now see a navigation bar with <code>Home</code> and <code>About</code>
|
|
items on the left as well as <code>Search</code>, <code>Previous</code>, and <code>Next</code> items on the
|
|
right.</p>
|
|
<p><img alt="Screenshot" src="img/multipage.png" /></p>
|
|
<p>Try the menu items and navigate back and forth between pages. Then click on
|
|
<code>Search</code>. A search dialog will appear, allowing you to search for any text on
|
|
any page. Notice that the search results include every occurrence of the search
|
|
term on the site and links directly to the section of the page in which the
|
|
search term appears. You get all of that with no effort or configuration on your
|
|
part!</p>
|
|
<p><img alt="Screenshot" src="img/search.png" /></p>
|
|
<h2 id="theming-our-documentation">Theming our documentation<a class="headerlink" href="#theming-our-documentation" title="Permanent link"></a></h2>
|
|
<p>Now change the configuration file to alter how the documentation is displayed by
|
|
changing the theme. Edit the <code>mkdocs.yml</code> file and add a <a href="user-guide/configuration/#theme"><code>theme</code></a> setting:</p>
|
|
<pre><code class="yaml">site_name: MkLorum
|
|
nav:
|
|
- Home: index.md
|
|
- About: about.md
|
|
theme: readthedocs
|
|
</code></pre>
|
|
|
|
<p>Save your changes, and you'll see the ReadTheDocs theme being used.</p>
|
|
<p><img alt="Screenshot" src="img/readthedocs.png" /></p>
|
|
<h2 id="changing-the-favicon-icon">Changing the Favicon Icon<a class="headerlink" href="#changing-the-favicon-icon" title="Permanent link"></a></h2>
|
|
<p>By default, MkDocs uses the <a href="/img/favicon.ico">MkDocs favicon</a> icon. To use a different icon, create
|
|
an <code>img</code> subdirectory in your <code>docs_dir</code> and copy your custom <code>favicon.ico</code> file
|
|
to that directory. MkDocs will automatically detect and use that file as your
|
|
favicon icon.</p>
|
|
<h2 id="building-the-site">Building the site<a class="headerlink" href="#building-the-site" title="Permanent link"></a></h2>
|
|
<p>That's looking good. You're ready to deploy the first pass of your <code>MkLorum</code>
|
|
documentation. First build the documentation:</p>
|
|
<pre><code class="bash">mkdocs build
|
|
</code></pre>
|
|
|
|
<p>This will create a new directory, named <code>site</code>. Take a look inside the
|
|
directory:</p>
|
|
<pre><code class="bash">$ ls site
|
|
about fonts index.html license search.html
|
|
css img js mkdocs sitemap.xml
|
|
</code></pre>
|
|
|
|
<p>Notice that your source documentation has been output as two HTML files named
|
|
<code>index.html</code> and <code>about/index.html</code>. You also have various other media that's
|
|
been copied into the <code>site</code> directory as part of the documentation theme. You
|
|
even have a <code>sitemap.xml</code> file and <code>mkdocs/search_index.json</code>.</p>
|
|
<p>If you're using source code control such as <code>git</code> you probably don't want to
|
|
check your documentation builds into the repository. Add a line containing
|
|
<code>site/</code> to your <code>.gitignore</code> file.</p>
|
|
<pre><code class="bash">echo "site/" >> .gitignore
|
|
</code></pre>
|
|
|
|
<p>If you're using another source code control tool you'll want to check its
|
|
documentation on how to ignore specific directories.</p>
|
|
<p>After some time, files may be removed from the documentation but they will still
|
|
reside in the <code>site</code> directory. To remove those stale files, just run <code>mkdocs</code>
|
|
with the <code>--clean</code> switch.</p>
|
|
<pre><code class="bash">mkdocs build --clean
|
|
</code></pre>
|
|
|
|
<h2 id="other-commands-and-options">Other Commands and Options<a class="headerlink" href="#other-commands-and-options" title="Permanent link"></a></h2>
|
|
<p>There are various other commands and options available. For a complete list of
|
|
commands, use the <code>--help</code> flag:</p>
|
|
<pre><code class="bash">mkdocs --help
|
|
</code></pre>
|
|
|
|
<p>To view a list of options available on a given command, use the <code>--help</code> flag
|
|
with that command. For example, to get a list of all options available for the
|
|
<code>build</code> command run the following:</p>
|
|
<pre><code class="bash">mkdocs build --help
|
|
</code></pre>
|
|
|
|
<h2 id="deploying">Deploying<a class="headerlink" href="#deploying" title="Permanent link"></a></h2>
|
|
<p>The documentation site that you just built only uses static files so you'll be
|
|
able to host it from pretty much anywhere. <a href="https://help.github.com/articles/creating-project-pages-manually/">GitHub project pages</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Amazon
|
|
S3</a> may be good hosting options, depending upon your needs. Upload the contents
|
|
of the entire <code>site</code> directory to wherever you're hosting your website from and
|
|
you're done. For specific instructions on a number of common hosts, see the
|
|
<a href="user-guide/deploying-your-docs/">Deploying your Docs</a> page.</p>
|
|
<h2 id="getting-help">Getting help<a class="headerlink" href="#getting-help" title="Permanent link"></a></h2>
|
|
<p>To get help with MkDocs, please use the <a href="https://groups.google.com/forum/#!forum/mkdocs">discussion group</a>, <a href="https://github.com/mkdocs/mkdocs/issues">GitHub issues</a> or
|
|
the MkDocs IRC channel <code>#mkdocs</code> on freenode.</p></div>
|
|
</div>
|
|
</div>
|
|
|
|
<footer class="col-md-12">
|
|
<hr>
|
|
<p>Copyright © 2014 <a href="https://twitter.com/_tomchristie">Tom Christie</a>, Maintained by the <a href="/about/release-notes/#maintenance-team">MkDocs Team</a>.</p>
|
|
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
|
</footer>
|
|
<script>
|
|
var base_url = ".",
|
|
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
|
</script>
|
|
<script src="js/base.js" defer></script>
|
|
<script src="search/main.js" defer></script>
|
|
|
|
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
|
<div class="modal-dialog modal-lg">
|
|
<div class="modal-content">
|
|
<div class="modal-header">
|
|
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
|
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
|
</div>
|
|
<div class="modal-body">
|
|
<p>
|
|
From here you can search these documents. Enter
|
|
your search terms below.
|
|
</p>
|
|
<form>
|
|
<div class="form-group">
|
|
<input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
|
</div>
|
|
</form>
|
|
<div id="mkdocs-search-results"></div>
|
|
</div>
|
|
<div class="modal-footer">
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
|
<div class="modal-dialog">
|
|
<div class="modal-content">
|
|
<div class="modal-header">
|
|
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
|
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
|
</div>
|
|
<div class="modal-body">
|
|
<table class="table">
|
|
<thead>
|
|
<tr>
|
|
<th style="width: 20%;">Keys</th>
|
|
<th>Action</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="help shortcut"><kbd>?</kbd></td>
|
|
<td>Open this help</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="next shortcut"><kbd>n</kbd></td>
|
|
<td>Next page</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="prev shortcut"><kbd>p</kbd></td>
|
|
<td>Previous page</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="search shortcut"><kbd>s</kbd></td>
|
|
<td>Search</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="modal-footer">
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|
|
|
|
<!--
|
|
MkDocs version : 1.1
|
|
Build Date UTC : 2020-02-23 00:23:55
|
|
-->
|