From a0c57b35a338f95a7426f49461cbfa203ec49a24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= <nicolas@loeuillet.org> Date: Tue, 4 Nov 2014 08:33:05 +0100 Subject: add HTML documentation --- docs/en/Getting_started.html | 105 ++++++++++++++++++ docs/en/Help_wallabag.html | 90 ++++++++++++++++ .../User_documentation/Download_and_install.html | 120 +++++++++++++++++++++ docs/en/User_documentation/Hidden_options.html | 90 ++++++++++++++++ .../Save_your_first_article.html | 115 ++++++++++++++++++++ 5 files changed, 520 insertions(+) create mode 100644 docs/en/Getting_started.html create mode 100644 docs/en/Help_wallabag.html create mode 100644 docs/en/User_documentation/Download_and_install.html create mode 100644 docs/en/User_documentation/Hidden_options.html create mode 100644 docs/en/User_documentation/Save_your_first_article.html (limited to 'docs/en') diff --git a/docs/en/Getting_started.html b/docs/en/Getting_started.html new file mode 100644 index 00000000..011959bf --- /dev/null +++ b/docs/en/Getting_started.html @@ -0,0 +1,105 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Getting started</title> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> + <link href='../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li class="active"><a href="../en/Getting_started.html">Getting started</a></li><li><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Getting started </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Monday, November 3, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 1:28 PM </span> + </div> + + <p><strong>wallabag</strong> is a read-it-later application: it saves a web page by keeping content only. Elements like navigation or ads are deleted.</p> +<h2>Features</h2> +<ul> +<li>content of the web page is saved: text and pictures. </li> +<li>the web application is responsive</li> +<li>you can export articles into ePub</li> +<li>you can read your articles offline thanks to smartphones applications</li> +<li>you can easily save a new link thanks to browser addons</li> +<li>many templates are available to change your wallabag as you wish</li> +<li>and many others great features ! </li> +</ul> +<p>This user documentation is here to learn to you what you can do with wallabag.</p> +<h2>Demonstration</h2> +<p>If you want to try all wallabag features, there is a demonstration website: <a href="http://demo.wallabag.org"><a href="http://demo.wallabag.org">http://demo.wallabag.org</a></a></p> +<h2>Create an account</h2> +<p>Maybe you don't want to install and update wallabag by yourself, or you can't do it, it's possible to create a free account on <a href="https://www.framabag.org">Framabag.org</a>. Just your email is needed.</p> </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + diff --git a/docs/en/Help_wallabag.html b/docs/en/Help_wallabag.html new file mode 100644 index 00000000..5d4c307f --- /dev/null +++ b/docs/en/Help_wallabag.html @@ -0,0 +1,90 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Help wallabag</title> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> + <link href='../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li><a href="../en/Getting_started.html">Getting started</a></li><li class="active"><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Help wallabag </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Monday, November 3, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 1:28 PM </span> + </div> + + <p>TODO</p> </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + diff --git a/docs/en/User_documentation/Download_and_install.html b/docs/en/User_documentation/Download_and_install.html new file mode 100644 index 00000000..5ed5ce36 --- /dev/null +++ b/docs/en/User_documentation/Download_and_install.html @@ -0,0 +1,120 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Download and install</title> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> + <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li class="active"><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Download and install </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Friday, October 31, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 6:13 AM </span> + </div> + + <h2>I don't want to install wallabag</h2> +<p>If you can't or don't want to install Wallabag on your server, we suggest you create a free account on Framabag wich uses our software: read the complete documentation here (TODO write Create a framabag account).</p> +<h2>I want to install wallabag</h2> +<p><a href="http://www.wallabag.org/download">Download the latest wallabag version</a> and unpack it. Copy the files on your web server.</p> +<h2>Prerequisites for your web server</h2> +<ul> +<li><a href="http://php.net/manual/en/install.php">PHP 5.3.3 or more</a></li> +<li><a href="http://php.net/manual/en/book.sqlite.php">SQLite</a> or <a href="http://php.net/manual/fr/book.mysql.php">MySQL</a> or <a href="http://php.net/manual/en/book.pgsql.php">PostgreSQL</a></li> +<li><a href="http://php.net/xml">XML for PHP</a></li> +<li><a href="http://php.net/pcre">PCRE</a></li> +<li><a href="http://php.net/manual/book.filter.php">Data filtering</a></li> +<li><a href="http://php.net/tidy">Tidy for PHP</a></li> +<li><a href="http://php.net/curl">cURL</a></li> +<li><a href="http://www.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen">allow_url_fopen</a></li> +<li><a href="http://php.net/manual/en/book.gettext.php">gettext</a></li> +</ul> +<p>To ensure that your server has all the prerequisites, you can run the file <code>wallabag_compatibility_test.php</code> that is located in the <code>install</code> directory of wallabag.</p> +<h2>Installation of the dependencies</h2> +<p>In order to work properly, wallabag needs some dependencies. To install them, you have to use <code>composer</code>. In your wallabag folder, run the following commands:</p> +<pre><code>curl -s http://getcomposer.org/installer | php +php composer.phar install</code></pre> +<p>If you can't install <code>composer</code> (In order to work properly, Wallabag needs some dependencies), we provide you a <a href="http://wllbg.org/vendor">vendor.zip</a> file to unpack in your wallabag directory. </p> +<h2>Permissions</h2> +<p>Your web server needs a writing access in <code>assets</code>, <code>cache</code> and <code>db</code> directory. Otherwise, a message will report that the installation is impossible.</p> +<h2>Installation of wallabag. At last.</h2> +<p>Access to wallabag from your web browser. If your server is correctly configured, you reach the setup screen. </p> +<p>Fill your database type (<code>sqlite</code>, <code>mysql</code> ou <code>postgresql</code>) and finally the information for your user account.</p> +<p>wallabag is now installed. </p> +<h2>Login</h2> +<p>From your web browser, you reach the login screen : fill your username and your password to connect to your account.</p> +<p>Enjoy!</p> </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + diff --git a/docs/en/User_documentation/Hidden_options.html b/docs/en/User_documentation/Hidden_options.html new file mode 100644 index 00000000..65420813 --- /dev/null +++ b/docs/en/User_documentation/Hidden_options.html @@ -0,0 +1,90 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Hidden options</title> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> + <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li class="active"><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Hidden options </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Monday, November 3, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 1:28 PM </span> + </div> + + <p>TODO</p> </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + diff --git a/docs/en/User_documentation/Save_your_first_article.html b/docs/en/User_documentation/Save_your_first_article.html new file mode 100644 index 00000000..a3a89efa --- /dev/null +++ b/docs/en/User_documentation/Save_your_first_article.html @@ -0,0 +1,115 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Save your first article</title> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> + <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li class="active"><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Save your first article </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Sunday, October 26, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 9:34 PM </span> + </div> + + <p>Once connected, you have many ways to save an article.</p> +<h2>From the web application</h2> +<h2>Thanks to the bookmarklet</h2> +<p><a href="http://en.wikipedia.org/wiki/Bookmarklet">From Wikipedia</a></p> +<pre><code>A bookmarklet is a bookmark stored in a web browser that contains JavaScript commands to extend the browser's functionality.</code></pre> +<h2>From your smartphone</h2> +<h3>Android</h3> +<h4>Installation and configuration</h4> +<p>TODO</p> +<h4>Saving an article</h4> +<p>TODO</p> +<h4>Reading</h4> +<p>TODO</p> +<h3>iOS</h3> +<h4>Installation and configuration</h4> +<p>TODO</p> +<h4>Use</h4> +<p>TODO</p> +<h3>Windows Phone</h3> +<h4>Installation and configuration</h4> +<p>TODO</p> +<h2>From your browser</h2> +<h3>Firefox</h3> +<p>TODO</p> +<h3>Chrome</h3> +<p>TODO</p> </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + -- cgit v1.2.3 From c4457fba85d4b564bebde844d3176964d4f252b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= <nicolas@loeuillet.org> Date: Mon, 24 Nov 2014 13:46:39 +0100 Subject: upgrade documentation --- docs/en/Getting_started.html | 15 +-- docs/en/Help_wallabag.html | 32 +++++-- docs/en/User_documentation/Configure_wallabag.html | 106 +++++++++++++++++++++ .../User_documentation/Download_and_install.html | 17 ++-- docs/en/User_documentation/Hidden_options.html | 40 ++++++-- .../Save_your_first_article.html | 61 ++++++++---- 6 files changed, 223 insertions(+), 48 deletions(-) create mode 100644 docs/en/User_documentation/Configure_wallabag.html (limited to 'docs/en') diff --git a/docs/en/Getting_started.html b/docs/en/Getting_started.html index 011959bf..269bbcd9 100644 --- a/docs/en/Getting_started.html +++ b/docs/en/Getting_started.html @@ -5,7 +5,7 @@ <!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> <head> <title>Getting started</title> - <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> <meta name="description" content="Documentation for wallabag" /> <meta name="author" content="Nicolas Lœuillet"> <link rel="icon" href="../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> @@ -14,7 +14,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Font --> - <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> <link href='../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> </head> @@ -39,7 +39,7 @@ </div> <div id="sub-nav-collapse" class="sub-nav-collapse"> <!-- Navigation --> - <ul class="nav nav-list"><li class="active"><a href="../en/Getting_started.html">Getting started</a></li><li><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + <ul class="nav nav-list"><li class="active"><a href="../en/Getting_started.html">Getting started</a></li><li><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> <!-- Links --> <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> @@ -51,11 +51,11 @@ <div class="content-page"> <article> <div class="page-header sub-header clearfix"> - <h1>Getting started </h1> + <h1>Getting started <a href="https://github.com/wallabag/documentation/blob/master/en/00_Getting_started.md" class="btn">Fix this page</a> </h1> <span style="float: left; font-size: 10px; color: gray;"> - Monday, November 3, 2014 </span> + Friday, October 31, 2014 </span> <span style="float: right; font-size: 10px; color: gray;"> - 1:28 PM </span> + 8:34 PM </span> </div> <p><strong>wallabag</strong> is a read-it-later application: it saves a web page by keeping content only. Elements like navigation or ads are deleted.</p> @@ -73,7 +73,8 @@ <h2>Demonstration</h2> <p>If you want to try all wallabag features, there is a demonstration website: <a href="http://demo.wallabag.org"><a href="http://demo.wallabag.org">http://demo.wallabag.org</a></a></p> <h2>Create an account</h2> -<p>Maybe you don't want to install and update wallabag by yourself, or you can't do it, it's possible to create a free account on <a href="https://www.framabag.org">Framabag.org</a>. Just your email is needed.</p> </article> +<p>Maybe you don't want to install and update wallabag by yourself, or you can't do it, it's possible to create a free account on <a href="https://www.framabag.org">Framabag.org</a>. Just your email is needed.</p> + </article> </div> </div> </div> diff --git a/docs/en/Help_wallabag.html b/docs/en/Help_wallabag.html index 5d4c307f..5ec6f458 100644 --- a/docs/en/Help_wallabag.html +++ b/docs/en/Help_wallabag.html @@ -5,7 +5,7 @@ <!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> <head> <title>Help wallabag</title> - <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> <meta name="description" content="Documentation for wallabag" /> <meta name="author" content="Nicolas Lœuillet"> <link rel="icon" href="../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> @@ -14,7 +14,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Font --> - <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> <link href='../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> </head> @@ -39,7 +39,7 @@ </div> <div id="sub-nav-collapse" class="sub-nav-collapse"> <!-- Navigation --> - <ul class="nav nav-list"><li><a href="../en/Getting_started.html">Getting started</a></li><li class="active"><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + <ul class="nav nav-list"><li><a href="../en/Getting_started.html">Getting started</a></li><li class="active"><a href="../en/Help_wallabag.html">Help wallabag</a></li><li><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> <!-- Links --> <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> @@ -51,14 +51,32 @@ <div class="content-page"> <article> <div class="page-header sub-header clearfix"> - <h1>Help wallabag </h1> + <h1>Help wallabag <a href="https://github.com/wallabag/documentation/blob/master/en/01_Help_wallabag.md" class="btn">Fix this page</a> </h1> <span style="float: left; font-size: 10px; color: gray;"> - Monday, November 3, 2014 </span> + Tuesday, November 4, 2014 </span> <span style="float: right; font-size: 10px; color: gray;"> - 1:28 PM </span> + 8:52 PM </span> </div> - <p>TODO</p> </article> + <h2>Report bugs</h2> +<h3>Contact wallabag support</h3> +<p>TODO</p> +<h3>Create a new issue</h3> +<p>TODO</p> +<h2>Write and fix documentation</h2> +<p>TODO</p> +<h2>Fix bugs</h2> +<p>TODO</p> +<h2>Spread the word</h2> +<p>It's not so complicated: just talk about wallabag! Use #wallabag hashtag on all your social networks: twitter, Facebook, Diaspora*, Google+, etc. </p> +<p>Here are our accounts on social networks: </p> +<ul> +<li><a href="https://framasphere.org/people/2335ff202f920132196e2a0000053625">Diaspora*</a></li> +<li><a href="https:/twitter.com/wallabagapp">twitter</a></li> +<li><a href="https://www.facebook.com/wallabag">Facebook</a></li> +<li><a href="https://plus.google.com/+WallabagOrg/">Google+</a></li> +</ul> + </article> </div> </div> </div> diff --git a/docs/en/User_documentation/Configure_wallabag.html b/docs/en/User_documentation/Configure_wallabag.html new file mode 100644 index 00000000..af73636d --- /dev/null +++ b/docs/en/User_documentation/Configure_wallabag.html @@ -0,0 +1,106 @@ +<!DOCTYPE html> +<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]--> +<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]--> +<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> +<head> + <title>Configure wallabag</title> + <meta charset="utf-8"> + <meta name="description" content="Documentation for wallabag" /> + <meta name="author" content="Nicolas Lœuillet"> + <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> + <!-- Mobile --> + <meta name="apple-mobile-web-app-capable" content="yes" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Font --> + + <!-- CSS --> + <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> +</head> +<body> + <!-- Docs --> + <div class="container-fluid fluid-height wrapper"> + <div class="navbar navbar-fixed-top hidden-print"> + <div class="container-fluid"> + <a class="brand navbar-brand pull-left" href="../../index.html">wallabag</a> + <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p> + </div> + </div> + <div class="row columns content"> + <div class="left-column article-tree col-sm-3 hidden-print"> + <!-- For Mobile --> + <div class="responsive-collapse"> + <button type="button" class="btn btn-sidebar" id="menu-spinner-button"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div id="sub-nav-collapse" class="sub-nav-collapse"> + <!-- Navigation --> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li class="active"><a href="../../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> + + <!-- Links --> + <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> + <!-- Twitter --> + </div> + </div> + </div> + <div class="right-column content-area col-sm-9"> + <div class="content-page"> + <article> + <div class="page-header sub-header clearfix"> + <h1>Configure wallabag <a href="https://github.com/wallabag/documentation/blob/master/en/02_User_documentation/06_Configure_wallabag.md" class="btn">Fix this page</a> </h1> + <span style="float: left; font-size: 10px; color: gray;"> + Sunday, November 16, 2014 </span> + <span style="float: right; font-size: 10px; color: gray;"> + 9:22 PM </span> + </div> + + <h1>Configure wallabag</h1> +<p>From the configuration menu, you can change some wallabag's options. </p> +<p>Some parts won't be presented here as they have a complete chapter in the documentation (RSS +feeds, import from a third party service, export your data, Epub conversion and multi-user mode).</p> +<h2>Theme</h2> +<p>Of tastes and colors, we do not discuss. That's why wallabag offers you to change its skin to please everyone.</p> +<p>Select the theme of your choice from the drop down list and confirm by clicking on <strong>Update</strong>.</p> +<h2>Language</h2> +<p>Select the language of your choice in the drop down list and confirm by clicking on <strong>Update</strong> +.</p> +<h2>Password</h2> +<p>Fill in your new password in the two dedicated fields and confirm by clicking on <strong>Update</strong>.</p> +<p>You will be disconnected and need to enter your new password to access your wallabag.</p> +<h2>Clear the cache</h2> +<p>The cache allows wallabag perform certain functions faster.</p> +<p>After updating wallabag, it is advised to clear the cache. You only have to click to do so.</p> + </article> + </div> + </div> + </div> + </div> + + + + <!-- jQuery --> + <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script> + <script> + if (typeof jQuery == 'undefined') + document.write(unescape("%3Cscript src='../../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E")); + </script> + + <!-- hightlight.js --> + <script src="../../js/highlight.min.js"></script> + <script>hljs.initHighlightingOnLoad();</script> + + <!-- JS --> + + <!-- Front end file editor --> + <script src="../../js/custom.js"></script> + <!--[if lt IE 9]> + <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + +</body> +</html> + diff --git a/docs/en/User_documentation/Download_and_install.html b/docs/en/User_documentation/Download_and_install.html index 5ed5ce36..5ee9221f 100644 --- a/docs/en/User_documentation/Download_and_install.html +++ b/docs/en/User_documentation/Download_and_install.html @@ -5,7 +5,7 @@ <!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> <head> <title>Download and install</title> - <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> <meta name="description" content="Documentation for wallabag" /> <meta name="author" content="Nicolas Lœuillet"> <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> @@ -14,7 +14,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Font --> - <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> </head> @@ -39,7 +39,7 @@ </div> <div id="sub-nav-collapse" class="sub-nav-collapse"> <!-- Navigation --> - <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li class="active"><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li class="active"><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> <!-- Links --> <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> @@ -51,11 +51,11 @@ <div class="content-page"> <article> <div class="page-header sub-header clearfix"> - <h1>Download and install </h1> + <h1>Download and install <a href="https://github.com/wallabag/documentation/blob/master/en/02_User_documentation/02_Download_and_install.md" class="btn">Fix this page</a> </h1> <span style="float: left; font-size: 10px; color: gray;"> - Friday, October 31, 2014 </span> + Sunday, November 16, 2014 </span> <span style="float: right; font-size: 10px; color: gray;"> - 6:13 AM </span> + 9:22 PM </span> </div> <h2>I don't want to install wallabag</h2> @@ -84,11 +84,12 @@ php composer.phar install</code></pre> <p>Your web server needs a writing access in <code>assets</code>, <code>cache</code> and <code>db</code> directory. Otherwise, a message will report that the installation is impossible.</p> <h2>Installation of wallabag. At last.</h2> <p>Access to wallabag from your web browser. If your server is correctly configured, you reach the setup screen. </p> -<p>Fill your database type (<code>sqlite</code>, <code>mysql</code> ou <code>postgresql</code>) and finally the information for your user account.</p> +<p>Fill your database type (<code>sqlite</code>, <code>mysql</code> or <code>postgresql</code>) and finally the information for your user account.</p> <p>wallabag is now installed. </p> <h2>Login</h2> <p>From your web browser, you reach the login screen : fill your username and your password to connect to your account.</p> -<p>Enjoy!</p> </article> +<p>Enjoy!</p> + </article> </div> </div> </div> diff --git a/docs/en/User_documentation/Hidden_options.html b/docs/en/User_documentation/Hidden_options.html index 65420813..83c9668b 100644 --- a/docs/en/User_documentation/Hidden_options.html +++ b/docs/en/User_documentation/Hidden_options.html @@ -5,7 +5,7 @@ <!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> <head> <title>Hidden options</title> - <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> <meta name="description" content="Documentation for wallabag" /> <meta name="author" content="Nicolas Lœuillet"> <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> @@ -14,7 +14,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Font --> - <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> </head> @@ -39,7 +39,7 @@ </div> <div id="sub-nav-collapse" class="sub-nav-collapse"> <!-- Navigation --> - <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li class="active"><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li class="active"><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> <!-- Links --> <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> @@ -51,14 +51,40 @@ <div class="content-page"> <article> <div class="page-header sub-header clearfix"> - <h1>Hidden options </h1> + <h1>Hidden options <a href="https://github.com/wallabag/documentation/blob/master/en/02_User_documentation/14_Hidden_options.md" class="btn">Fix this page</a> </h1> <span style="float: left; font-size: 10px; color: gray;"> - Monday, November 3, 2014 </span> + Sunday, November 16, 2014 </span> <span style="float: right; font-size: 10px; color: gray;"> - 1:28 PM </span> + 9:22 PM </span> </div> - <p>TODO</p> </article> + <h2>Be careful</h2> +<p><strong>Attention</strong>, this part is for advanced users only. We'll edit an important file of wallabag, <code>inc/poche/config.inc.php</code>, please make a backup of this file before changes.<br /> +<strong>If you make a mistake while editing a wallabag file, your application may be broken.</strong></p> +<p>This file is created when wallabag is installed.<br /> +Please first install wallabag, make a backup of this file and open it with <del>Sublime Text</del> your favorite editor.</p> +<p>In this file are defined some parameters that you can't change on the wallabag <strong>configuration</strong> page. </p> +<h2>Advanced options</h2> +<p>Each parameter is defined like this:</p> +<pre><code>@define ('PARAMETER_NAME', 'Parameter value');</code></pre> +<p>For each line, you can only change <code>Parameter value</code> part. </p> +<p>TODO explain all the following parameters</p> +<p>Here are all the parameters you can change: </p> +<ul> +<li><code>HTTP_PORT</code> (default value is <code>80</code>): Expected value: a digit.</li> +<li><code>SSL_PORT</code> (default value is <code>443</code>): Expected value: a digit. </li> +<li><code>DEBUG_POCHE</code> (default value is <code>FALSE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>DOWNLOAD_PICTURES</code> (default value is <code>FALSE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>SHARE_TWITTER</code> (default value is <code>TRUE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>SHARE_MAIL</code> (par défaut, <code>TRUE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>SHARE_SHAARLI</code> (default value is <code>FALSE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>SHAARLI_URL</code> (default value is <code>'http://myshaarliurl.com'</code>): Expected value: your Shaarli URL. </li> +<li><code>FLATTR</code> (default value is <code>TRUE</code>): Expected values: <code>TRUE</code> or <code>FALSE</code>.</li> +<li><code>SHOW_PRINTLINK</code> (default value is <code>'1'</code>): Expected values: <code>'0'</code> to disable, <code>'1'</code> to enable.</li> +<li><code>SHOW_READPERCENT</code> (default value is <code>'1'</code>): <code>'0'</code> to disable, <code>'1'</code> to enable.</li> +<li><code>PAGINATION</code> (default value is <code>'12'</code>): Expected value: a digit. </li> +</ul> + </article> </div> </div> </div> diff --git a/docs/en/User_documentation/Save_your_first_article.html b/docs/en/User_documentation/Save_your_first_article.html index a3a89efa..180691c5 100644 --- a/docs/en/User_documentation/Save_your_first_article.html +++ b/docs/en/User_documentation/Save_your_first_article.html @@ -5,7 +5,7 @@ <!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]--> <head> <title>Save your first article</title> - <meta http-equiv="content-type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> <meta name="description" content="Documentation for wallabag" /> <meta name="author" content="Nicolas Lœuillet"> <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon"> @@ -14,7 +14,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Font --> - <link href='//fonts.googleapis.com/css?family=Roboto+Slab:400,100,300,700&subset=latin,cyrillic-ext,cyrillic' rel='stylesheet' type='text/css'> + <!-- CSS --> <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'> </head> @@ -39,7 +39,7 @@ </div> <div id="sub-nav-collapse" class="sub-nav-collapse"> <!-- Navigation --> - <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li class="active"><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li><li><a href="#" class="aj-nav folder">Technical documentation</a><ul class="nav nav-list"></ul></li></ul> <div class="well well-sidebar"> + <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li class="active"><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar"> <!-- Links --> <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br> @@ -51,39 +51,62 @@ <div class="content-page"> <article> <div class="page-header sub-header clearfix"> - <h1>Save your first article </h1> + <h1>Save your first article <a href="https://github.com/wallabag/documentation/blob/master/en/02_User_documentation/03_Save_your_first_article.md" class="btn">Fix this page</a> </h1> <span style="float: left; font-size: 10px; color: gray;"> - Sunday, October 26, 2014 </span> + Sunday, November 16, 2014 </span> <span style="float: right; font-size: 10px; color: gray;"> - 9:34 PM </span> + 9:22 PM </span> </div> - <p>Once connected, you have many ways to save an article.</p> + <h1>Save your first article</h1> +<p>Once connected on wallabag, you have many ways to save an article.</p> <h2>From the web application</h2> -<h2>Thanks to the bookmarklet</h2> -<p><a href="http://en.wikipedia.org/wiki/Bookmarklet">From Wikipedia</a></p> -<pre><code>A bookmarklet is a bookmark stored in a web browser that contains JavaScript commands to extend the browser's functionality.</code></pre> +<p>Let's see first how to do from the web application. In the menu, you have a link <strong>save a link</strong>. Clicking on it, a form shows up : you simply have to type the web adress of the article you want to save.</p> +<p>Confirm to store the content of the article.</p> +<p>By default, only the text is saved. If you want to store a copy of the images on your server, you have to enable the setting <em>DOWNLOAD_PICTURES</em>. Read the chapter on hidden options for more information. </p> +<h2>From the bookmarklet</h2> +<p>From <a href="http://fr.wikipedia.org/wiki/Bookmarklet">Wikipedia's definition</a></p> +<blockquote> +<p>A bookmarklet is a <a href="http://en.wikipedia.org/wiki/Internet_bookmark">bookmark</a> stored in a <a href="http://en.wikipedia.org/wiki/Web_browser">web browser</a> that contains <a href="http://en.wikipedia.org/wiki/JavaScript">JavaScript</a>commands to extend the browser's functionality.</p> +<p>Bookmarklets are unobtrusive scripts stored as the URL of a bookmark in a web browser or as a hyperlink on a web page.</p> +<p>When clicked, a bookmarklet performs some function, one of a wide variety such as a search query or data extraction. Bookmarklets are usually <a href="http://en.wikipedia.org/wiki/Computer_program">JavaScript programs</a>.</p> +</blockquote> +<p>From the wallabag's menu, click on <strong>settings</strong>. On the first part of this page, we have listed all the ways to save an article. You'll find the bookmarklet (it's the Bag it ! link) to drag and drop in the bookmarks bar of your web browser. +From now on, when you want to save the article you are browsing, you just have to click on this bookmarklet and the article will be automatically saved.</p> <h2>From your smartphone</h2> +<h3>Above all else</h3> +<p>To use a smartphone application, you have to enable RSS feeds from the settings panel of wallabag. Then some information will be displayed, like your security tokken. Read the chapter on RSS feeds for more information.</p> <h3>Android</h3> <h4>Installation and configuration</h4> -<p>TODO</p> -<h4>Saving an article</h4> -<p>TODO</p> +<p>You can download the android application from the <a href="https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche">Google Play Store</a> and from <a href="https://f-droid.org/app/fr.gaulupeau.apps.InThePoche">F-droid</a>. It's the exact same application on those two stores.</p> +<p>Once installed, start the application, go to the <strong>settings</strong> part et fill in the <strong>URL (complete address of your wallabag installation or your Framabag account)</strong> and <strong>User ID (in most cases, you'll have to put 1)</strong> fields. If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security <strong>Token</strong> (enter properly all the token's letters as seen in the settings part of wallabag).</p> +<h4>Saving of an article</h4> +<p>Now that everything is correctly set up, as soon as you browse on your smartphone's web browser, you can share an article in wallabag at any time from the <strong>Share</strong> menu : you'll find a <strong>Bag it !</strong> entry which will add your article in wallabag.</p> <h4>Reading</h4> -<p>TODO</p> +<p>When you open the application, click on Synchronize : your recently saved articles will be downloaded on your smartphone.</p> +<p>You don't need an internet connection anymore : click on <strong>List articles</strong> to start your reading.</p> +<p>At the end of each article, a <strong>Mark as read</strong> button allows you to archive the article.</p> +<p>To date, the synchronisation occurs in one direction (from wallabag to the application), thus preventing mark as read an article on wallabag from your smartphone.</p> <h3>iOS</h3> <h4>Installation and configuration</h4> <p>TODO</p> -<h4>Use</h4> +<h4>Utilization</h4> <p>TODO</p> <h3>Windows Phone</h3> <h4>Installation and configuration</h4> -<p>TODO</p> -<h2>From your browser</h2> +<p>You can download the Windows Phone application from the <a href="http://www.windowsphone.com/fr-fr/store/app/wallabag/ff890514-348c-4d0b-9b43-153fff3f7450">Windows Store</a> or directly from your smartphone's Store.</p> +<p>Once installed, the application will show you a notification on the first launch, asking the configuration of your wallabag server. Go to the <strong>Settings</strong> part of the application by pressing the three dots menu at the bottom of the screen, then fill in the <strong>URL (complete address of your wallabag installation or your Framabag account)</strong> and <strong>User ID (in most cases, you'll have to put 1)</strong> fields.</p> +<p>If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security <strong>Token</strong> (enter properly all the token's letters as seen in the setting part of wallabag).</p> +<h2>From your web browser</h2> <h3>Firefox</h3> -<p>TODO</p> +<p>Download the Firefox add-on on <a href="https://addons.mozilla.org/firefox/addon/wallabag/">addons.mozilla.org</a> and install it like any other Firefox add-on.</p> +<p>In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.</p> +<p>Personalize the Firefox toolbar to add wallabag (<strong>W</strong> icon). When you find an article you want to save, click on this icon : a new window will open to add the article and will close itself automatically.</p> <h3>Chrome</h3> -<p>TODO</p> </article> +<p>Download the Chrome add-on <a href="https://chrome.google.com/webstore/detail/wallabag/bepdcjnnkglfjehplaogpoonpffbdcdj">on the dedicated website</a> and install it like any other Chrome add-on.</p> +<p>In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.</p> +<p>During the addon's installation, a new icon appear in Chrome toolbar (a <strong>W</strong> icon). When you find an article you want to save, click on this icon : a popup will appear to confirm that your article has been saved.</p> + </article> </div> </div> </div> -- cgit v1.2.3