Deployed 6137427 with MkDocs version: 1.0.4

This commit is contained in:
Christian Schabesberger 2019-01-12 16:30:56 +01:00
parent 6dea049dfb
commit bb9fc64099
13 changed files with 293 additions and 8 deletions

View File

@ -104,6 +104,11 @@
<a class="" href="../04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="../05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

View File

@ -97,6 +97,11 @@
<a class="" href="../04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="../05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

View File

@ -99,6 +99,11 @@
<a class="" href="../04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="../05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

View File

@ -107,6 +107,11 @@
<a class="" href="../04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="../05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

View File

@ -99,6 +99,11 @@
</ul>
</li>
<li class="toctree-l1">
<a class="" href="../05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;
@ -176,6 +181,8 @@ click on that little paper symbol next to the <code>GET IT</code> button. If it
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../05_documentation/" class="btn btn-neutral float-right" title="Documentation">Next <span class="icon icon-circle-arrow-right"></span></a>
<a href="../03_Implement_a_service/" class="btn btn-neutral" title="Implement a service"><span class="icon icon-circle-arrow-left"></span> Previous</a>
@ -206,6 +213,8 @@ click on that little paper symbol next to the <code>GET IT</code> button. If it
<span><a href="../03_Implement_a_service/" style="color: #fcfcfc;">&laquo; Previous</a></span>
<span style="margin-left: 15px"><a href="../05_documentation/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
<script>var base_url = '..';</script>

236
05_documentation/index.html Normal file
View File

@ -0,0 +1,236 @@
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<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">
<link rel="shortcut icon" href="../img/favicon.ico">
<title>Documentation - NewPipe Documentation</title>
<!-- local fonts -->
<link rel="stylesheet" href="../css/local_fonts.css" type="text/css" />
<link rel="stylesheet" href="../css/theme.css" type="text/css" />
<link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
<!-- local code syntax highlighting -->
<link rel="stylesheet" href="../css/github.min.css" type="text/css" />
<link rel="stylesheet" href="../css/highlight.css" type="text/css" />
<script>
// Current page data
var mkdocs_page_name = "Documentation";
var mkdocs_page_input_path = "05_documentation.md";
var mkdocs_page_url = null;
</script>
<script src="../js/jquery-2.1.1.min.js" defer></script>
<script src="../js/modernizr-2.8.3.min.js" defer></script>
<script src="../js/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-nav-search">
<a href=".." class="icon icon-home"> NewPipe Documentation</a>
<div role="search">
<form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1">
<a class="" href="..">Welcome to the NewPipe Documentation.</a>
</li>
<li class="toctree-l1">
<a class="" href="../00_Prepare_everything/">Prepare everything</a>
</li>
<li class="toctree-l1">
<a class="" href="../01_Concept_of_the_extractor/">Concept of the Extractor</a>
</li>
<li class="toctree-l1">
<a class="" href="../02_Concept_of_LinkHandler/">Concept of LinkHandler</a>
</li>
<li class="toctree-l1">
<a class="" href="../03_Implement_a_service/">Implement a service</a>
</li>
<li class="toctree-l1">
<a class="" href="../04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1 current">
<a class="current" href="./">Documentation</a>
<ul class="subnav">
<li class="toctree-l2"><a href="#documentation">Documentation</a></li>
<ul>
<li><a class="toctree-l3" href="#installation">Installation</a></li>
<li><a class="toctree-l3" href="#windows">Windows</a></li>
<li><a class="toctree-l3" href="#macos">MacOS</a></li>
<li><a class="toctree-l3" href="#linuxbsd">Linux/*BSD</a></li>
<li><a class="toctree-l3" href="#update">Update</a></li>
</ul>
<li class="toctree-l2"><a href="#using-mkdocs">Using mkdocs</a></li>
<ul>
<li><a class="toctree-l3" href="#write-and-deploy">Write and Deploy</a></li>
</ul>
</ul>
</li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="..">NewPipe Documentation</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="..">Docs</a> &raquo;</li>
<li>Documentation</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main">
<div class="section">
<h1 id="documentation">Documentation</h1>
<p>The Documentation you are currently reading is written using <a href="https://www.mkdocs.org/">mkdocs</a>. It is a tool that will generate a static website based on files writting in <a href="https://www.markdownguide.org/">markdown</a>. Markdown has the advantage that it is simple to read and write, and that there are several tools that can translate a markdown file into languages like html or latex.</p>
<h2 id="installation">Installation</h2>
<p>Mkdos is written in <a href="https://www.python.org/">python</a> and is distributed through the python internal package manager <a href="https://pypi.org/project/pip/">pip</a>, thus you need to get python and pip running on your operating system first.</p>
<h2 id="windows">Windows</h2>
<ol>
<li>Download the latest <a href="https://www.python.org/downloads/windows/">Python3</a>.</li>
<li>When running the setup program make sure to check <code>Add Python 3.x to PATH</code>.
<img alt="check_path" src="../img/check_path.png" /></li>
<li>Install python</li>
<li>Open powershell or cmd, and type: <code>pip3 install mkdocs</code>.</li>
</ol>
<h2 id="macos">MacOS</h2>
<p>MacOS already comes along with python, however pip is still missing. The easyest, and most nondistructive way is to install the MacOS package manager <a href="https://brew.sh/index_de">homebrew</a> first. The advantage of homebrew are that it will only modify your home directory, but not the root dir. So your OS will not be touched by this.</p>
<ol>
<li>Install <a href="https://brew.sh/index_de">homebrew</a></li>
<li>Install Python from homebrew, which will also install pip. Run this command:
<code>brew install python</code>.</li>
<li>Install mkdocs:
<code>pip3 install mkdocs</code></li>
</ol>
<h2 id="linuxbsd">Linux/*BSD</h2>
<p>Also Linux/*BSD comes pre installed with python. Most distributions also deliver pip by default. If its not installed you may need to figure out how to install pip3 through the package manager of your system.</p>
<ol>
<li>Install pip3 with these commands according to distributions: <ul>
<li><strong>Ubuntu/Mint</strong>: <code>apt install python3-pip</code></li>
<li><strong>Fedora/CentOS</strong>: <code>sudo dnf install python3-pip</code></li>
<li><strong>Arch/Manjaro</strong>: <code>sudo pacman -S python-pip</code></li>
<li><strong>openSuse</strong>: <code>sudo zypper install python-pip</code></li>
<li><strong>*BSD</strong>: You are already advanced enough to know how you can force the bits on your disk to become pip by meditating upon it.</li>
</ul>
</li>
<li>Run <code>pip3 install mkdocs</code> to install mkdocs only for the current user,
or run <code>sudo pip3 install mkdocs</code> to install mkdocs systemwide. Last one has the higher chance to work properly.</li>
</ol>
<h2 id="update">Update</h2>
<p>Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run <code>pip3 install --upgrade mkdocs</code> or <code>sudo pip3 install --upgrade mkdocs</code> if you installed pip system wide on a linux/bsd system.</p>
<h1 id="using-mkdocs">Using mkdocs</h1>
<p>In order to extend this documentation you have to clone it from its <a href="https://github.com/TeamNewPipe/documentation">git repository</a>. When you cloned it, you will find a <a href="https://github.com/TeamNewPipe/documentation/blob/master/mkdocs.yml">mkdocs.yml</a> file, and a <a href="https://github.com/TeamNewPipe/documentation/tree/master/docs">docs</a> directory inside. The yaml file is the <a href="https://www.mkdocs.org/user-guide/configuration/">config file</a> while in the directory docs the documentation files are stored. <a href="https://www.mkdocs.org/user-guide/writing-your-docs/">here</a> is a guide about how to use mkdocs.</p>
<h2 id="write-and-deploy">Write and Deploy</h2>
<p>If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run <code>mkdocs serve</code> this will start the mkdocs internal webserver on port <code>8000</code>. So all you have to do is type <code>localhost:8000</code> into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content.</p>
<p>If you want to deploy the page, so it will be up to date at the <a href="https://teamnewpipe.github.io/documentation/">github pages</a> simply type <code>mkdocs gh-deploy</code>. However please be aware that this will not push your changes to the <code>master</code> branch of the repository. So you still have to commit and push your changes to the actual git repository of this documentation. <em>Please be aware that only priviliged maintainers can do this.</em></p>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../04_Run_changes_in_App/" class="btn btn-neutral" title="Run the changes in the App"><span class="icon icon-circle-arrow-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
</div>
Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" style="cursor: pointer">
<span class="rst-current-version" data-toggle="rst-current-version">
<span><a href="../04_Run_changes_in_App/" style="color: #fcfcfc;">&laquo; Previous</a></span>
</span>
</div>
<script>var base_url = '..';</script>
<script src="../js/theme.js" defer></script>
<script src="../search/main.js" defer></script>
</body>
</html>

View File

@ -71,6 +71,11 @@
<a class="" href="/04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="/05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

BIN
img/check_path.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

View File

@ -93,6 +93,11 @@
<a class="" href="04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;
@ -182,5 +187,5 @@ It focuses on making it possible for the creator of a scraper for a streaming se
<!--
MkDocs version : 1.0.4
Build Date UTC : 2018-12-14 08:57:47
Build Date UTC : 2019-01-12 15:30:55
-->

View File

@ -71,6 +71,11 @@
<a class="" href="./04_Run_changes_in_App/">Run the changes in the App</a>
</li>
<li class="toctree-l1">
<a class="" href="./05_documentation/">Documentation</a>
</li>
</ul>
</div>
&nbsp;

File diff suppressed because one or more lines are too long

View File

@ -2,32 +2,37 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2018-12-14</lastmod>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>None</loc>
<lastmod>2019-01-12</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>

Binary file not shown.