From bf67ac345f588130e98e784b4ee4740b0dad83fc Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sun, 7 May 2017 19:02:17 +0200 Subject: [PATCH 01/67] Update Github badges Signed-off-by: ArthurHoaro --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d57f5202..7633b2cb 100644 --- a/README.md +++ b/README.md @@ -6,10 +6,10 @@ _Do you want to share the links you discover?_ _Shaarli is a minimalist delicious clone that you can install on your own server._ _It is designed to be personal (single-user), fast and handy._ -[![](https://img.shields.io/badge/stable-v0.7.1-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.7.1) +[![](https://img.shields.io/badge/stable-v0.8.4-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.8.4) [![](https://img.shields.io/travis/shaarli/Shaarli/stable.svg?label=stable)](https://travis-ci.org/shaarli/Shaarli) • -[![](https://img.shields.io/badge/latest-v0.8.4-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.8.4) +[![](https://img.shields.io/badge/latest-v0.9.0-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.9.0) [![](https://img.shields.io/travis/shaarli/Shaarli/latest.svg?label=latest)](https://travis-ci.org/shaarli/Shaarli) • [![](https://img.shields.io/badge/master-v0.9.x-blue.svg)](https://github.com/shaarli/Shaarli) From 29a837f347f53f751b723d466a2cd05fd92fd34e Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sun, 12 Mar 2017 19:03:50 +0100 Subject: [PATCH 02/67] Bulk deletion * Add a checkboxes in linklist which display a sub-header containing action buttons * Strongly rely on JS * Requires a modern browser (ES6 syntax support) * Checkboxes are hidden if the browser is old or JS disabled --- index.php | 19 ++++++---- tpl/default/css/shaarli.css | 13 +++++++ tpl/default/js/shaarli.js | 73 +++++++++++++++++++++++++++++++++++- tpl/default/linklist.html | 5 ++- tpl/default/page.header.html | 7 ++++ 5 files changed, 106 insertions(+), 11 deletions(-) diff --git a/index.php b/index.php index ab1e30da..5e61cbb0 100644 --- a/index.php +++ b/index.php @@ -1329,18 +1329,21 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) // -------- User clicked the "Delete" button when editing a link: Delete link from database. if ($targetPage == Router::$PAGE_DELETELINK) { - // We do not need to ask for confirmation: - // - confirmation is handled by JavaScript - // - we are protected from XSRF by the token. - if (! tokenOk($_GET['token'])) { die('Wrong token.'); } - $id = intval(escape($_GET['lf_linkdate'])); - $link = $LINKSDB[$id]; - $pluginManager->executeHooks('delete_link', $link); - unset($LINKSDB[$id]); + if (strpos($_GET['lf_linkdate'], ' ') !== false) { + $ids = array_values(array_filter(preg_split('/\s+/', escape($_GET['lf_linkdate'])))); + } else { + $ids = [$_GET['lf_linkdate']]; + } + foreach ($ids as $id) { + $id = (int) escape($id); + $link = $LINKSDB[$id]; + $pluginManager->executeHooks('delete_link', $link); + unset($LINKSDB[$id]); + } $LINKSDB->save($conf->get('resource.page_cache')); // save to disk $history->deleteLink($link); diff --git a/tpl/default/css/shaarli.css b/tpl/default/css/shaarli.css index 73fade5f..efdf06d4 100644 --- a/tpl/default/css/shaarli.css +++ b/tpl/default/css/shaarli.css @@ -275,6 +275,19 @@ body, .pure-g [class*="pure-u"] { } } +.subheader-form a.button { + color: #f5f5f5; + font-weight: bold; + text-decoration: none; + border: 2px solid #f5f5f5; + border-radius: 5px; + padding: 3px 10px; +} + +.linklist-item-editbuttons .delete-checkbox { + display: none; +} + #header-login-form input[type="text"], #header-login-form input[type="password"] { width: 200px; } diff --git a/tpl/default/js/shaarli.js b/tpl/default/js/shaarli.js index 4d47fcd0..7abd20b2 100644 --- a/tpl/default/js/shaarli.js +++ b/tpl/default/js/shaarli.js @@ -357,11 +357,64 @@ window.onload = function () { var continent = document.getElementById('continent'); var city = document.getElementById('city'); if (continent != null && city != null) { - continent.addEventListener('change', function(event) { + continent.addEventListener('change', function (event) { hideTimezoneCities(city, continent.options[continent.selectedIndex].value, true); }); hideTimezoneCities(city, continent.options[continent.selectedIndex].value, false); } + + /** + * Bulk actions + * + * Note: Requires a modern browser. + */ + if (testEs6Compatibility()) { + let linkCheckboxes = document.querySelectorAll('.delete-checkbox'); + for(let checkbox of linkCheckboxes) { + checkbox.style.display = 'block'; + checkbox.addEventListener('click', function(event) { + let count = 0; + for(let checkbox of linkCheckboxes) { + count = checkbox.checked ? count + 1 : count; + } + let bar = document.getElementById('actions'); + if (count == 0 && bar.classList.contains('open')) { + bar.classList.toggle('open'); + } else if (count > 0 && ! bar.classList.contains('open')) { + bar.classList.toggle('open'); + } + }); + } + + let deleteButton = document.getElementById('actions-delete'); + let token = document.querySelector('input[type="hidden"][name="token"]'); + if (deleteButton != null && token != null) { + deleteButton.addEventListener('click', function(event) { + event.preventDefault(); + + let links = []; + for(let checkbox of linkCheckboxes) { + if (checkbox.checked) { + links.push({ + 'id': checkbox.value, + 'title': document.querySelector('.linklist-item[data-id="'+ checkbox.value +'"] .linklist-link').innerHTML + }); + } + } + + let message = 'Are you sure you want to delete '+ links.length +' links?\n'; + message += 'This action is IRREVERSIBLE!\n\nTitles:\n'; + let ids = ''; + for (let item of links) { + message += ' - '+ item['title'] +'\n'; + ids += item['id'] +'+'; + } + if (window.confirm(message)) { + window.location = '?delete_link&lf_linkdate='+ ids +'&token='+ token.value; + } + }); + } + } }; function activateFirefoxSocial(node) { @@ -397,7 +450,7 @@ function activateFirefoxSocial(node) { */ function hideTimezoneCities(cities, currentContinent, reset = false) { var first = true; - [].forEach.call(cities, function(option) { + [].forEach.call(cities, function (option) { if (option.getAttribute('data-continent') != currentContinent) { option.className = 'hidden'; } else { @@ -409,3 +462,19 @@ function hideTimezoneCities(cities, currentContinent, reset = false) { } }); } + +/** + * Check if the browser is compatible with ECMAScript 6 syntax + * + * Source: http://stackoverflow.com/a/29046739/1484919 + * + * @returns {boolean} + */ +function testEs6Compatibility() +{ + "use strict"; + + try { eval("var foo = (x)=>x+1"); } + catch (e) { return false; } + return true; +} diff --git a/tpl/default/linklist.html b/tpl/default/linklist.html index 57ef4567..6a4e14a6 100644 --- a/tpl/default/linklist.html +++ b/tpl/default/linklist.html @@ -15,6 +15,8 @@ {/if} + + {if="isLoggedIn()===true"} - +{if="isLoggedIn()===true"} + Date: Mon, 27 Mar 2017 14:01:06 +0200 Subject: [PATCH 15/67] Add Note bookmarklet #580 --- tpl/default/tools.html | 13 ++++++++++--- tpl/vintage/tools.html | 10 +++++++++- 2 files changed, 19 insertions(+), 4 deletions(-) diff --git a/tpl/default/tools.html b/tpl/default/tools.html index baa033af..6951ad28 100644 --- a/tpl/default/tools.html +++ b/tpl/default/tools.html @@ -86,8 +86,16 @@

Bookmarklets

+ class="bookmarklet-link" + href="javascript:( + function(){ + window.open( + '{$pageabsaddr}?private=1&post='+ + '&description='%20+%20encodeURIComponent(document.getSelection())+ + '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' + ); + } + )();"> ✚ {'Add Note'|t}
@@ -146,4 +154,3 @@

{'3rd party'|t}

value="{'Drag this link to your bookmarks toolbar, or right-click it and choose Bookmark This Link'|t}"> - diff --git a/tpl/vintage/tools.html b/tpl/vintage/tools.html index c36aa5b5..69689807 100644 --- a/tpl/vintage/tools.html +++ b/tpl/vintage/tools.html @@ -39,7 +39,15 @@

✚Add Note + href="javascript:( + function(){ + window.open( + '{$pageabsaddr}?private=1&post='+ + '&description='%20+%20encodeURIComponent(document.getSelection())+ + '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' + ); + } + )();">✚Add Note ⇐ Drag this link to your bookmarks toolbar (or right-click it and choose Bookmark This Link....).
From 7d86f40bdb2135655b5b4fe8cbcc1ac102114f86 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sat, 1 Apr 2017 12:17:37 +0200 Subject: [PATCH 16/67] Empty tag search will look for not tagged links Fixes #784 From now, searching for tags with an empty value will return only not tagged links, with the search bar showing `x results [not tagged]`. Note that using the api, the searchtags request parameter must be set to `false` to get the same result. - [ ] Update API doc --- application/FeedBuilder.php | 5 +++++ application/LinkDB.php | 27 +++++------------------ application/LinkFilter.php | 30 ++++++++++++++++++++++++++ application/Utils.php | 4 ++++ index.php | 18 +++++++++++++--- tests/LinkDBTest.php | 2 +- tests/LinkFilterTest.php | 19 +++++++++++++--- tests/api/controllers/GetLinksTest.php | 4 ++-- tests/api/controllers/InfoTest.php | 4 ++-- tests/utils/ReferenceLinkDB.php | 26 +++++++++++++++++++++- tpl/default/linklist.html | 6 +++++- tpl/vintage/linklist.html | 6 +++++- 12 files changed, 115 insertions(+), 36 deletions(-) diff --git a/application/FeedBuilder.php b/application/FeedBuilder.php index a1f4da48..7377bcec 100644 --- a/application/FeedBuilder.php +++ b/application/FeedBuilder.php @@ -97,6 +97,11 @@ public function __construct($linkDB, $feedType, $serverInfo, $userInput, $isLogg */ public function buildData() { + // Search for untagged links + if (isset($this->userInput['searchtags']) && empty($this->userInput['searchtags'])) { + $this->userInput['searchtags'] = false; + } + // Optionally filter the results: $linksToDisplay = $this->linkDB->filterSearch($this->userInput); diff --git a/application/LinkDB.php b/application/LinkDB.php index 4cee2af9..a03c2c06 100644 --- a/application/LinkDB.php +++ b/application/LinkDB.php @@ -450,29 +450,12 @@ public function filterDay($request) { public function filterSearch($filterRequest = array(), $casesensitive = false, $visibility = 'all') { // Filter link database according to parameters. - $searchtags = !empty($filterRequest['searchtags']) ? escape($filterRequest['searchtags']) : ''; - $searchterm = !empty($filterRequest['searchterm']) ? escape($filterRequest['searchterm']) : ''; + $searchtags = isset($filterRequest['searchtags']) ? escape($filterRequest['searchtags']) : ''; + $searchterm = isset($filterRequest['searchterm']) ? escape($filterRequest['searchterm']) : ''; - // Search tags + fullsearch. - if (! empty($searchtags) && ! empty($searchterm)) { - $type = LinkFilter::$FILTER_TAG | LinkFilter::$FILTER_TEXT; - $request = array($searchtags, $searchterm); - } - // Search by tags. - elseif (! empty($searchtags)) { - $type = LinkFilter::$FILTER_TAG; - $request = $searchtags; - } - // Fulltext search. - elseif (! empty($searchterm)) { - $type = LinkFilter::$FILTER_TEXT; - $request = $searchterm; - } - // Otherwise, display without filtering. - else { - $type = ''; - $request = ''; - } + // Search tags + fullsearch - blank string parameter will return all links. + $type = LinkFilter::$FILTER_TAG | LinkFilter::$FILTER_TEXT; + $request = [$searchtags, $searchterm]; $linkFilter = new LinkFilter($this); return $linkFilter->filter($type, $request, $casesensitive, $visibility); diff --git a/application/LinkFilter.php b/application/LinkFilter.php index 81832a4b..0e887d38 100644 --- a/application/LinkFilter.php +++ b/application/LinkFilter.php @@ -253,6 +253,9 @@ public function filterTags($tags, $casesensitive = false, $visibility = 'all') { // Implode if array for clean up. $tags = is_array($tags) ? trim(implode(' ', $tags)) : $tags; + if ($tags === false) { + return $this->filterUntagged($visibility); + } if (empty($tags)) { return $this->noFilter($visibility); } @@ -295,6 +298,33 @@ public function filterTags($tags, $casesensitive = false, $visibility = 'all') return $filtered; } + /** + * Return only links without any tag. + * + * @param string $visibility return only all/private/public links. + * + * @return array filtered links. + */ + public function filterUntagged($visibility) + { + $filtered = []; + foreach ($this->links as $key => $link) { + if ($visibility !== 'all') { + if (! $link['private'] && $visibility === 'private') { + continue; + } else if ($link['private'] && $visibility === 'public') { + continue; + } + } + + if (empty(trim($link['tags']))) { + $filtered[$key] = $link; + } + } + + return $filtered; + } + /** * Returns the list of articles for a given day, chronologically sorted * diff --git a/application/Utils.php b/application/Utils.php index 5c077450..87e5cc8f 100644 --- a/application/Utils.php +++ b/application/Utils.php @@ -91,6 +91,10 @@ function endsWith($haystack, $needle, $case = true) */ function escape($input) { + if (is_bool($input)) { + return $input; + } + if (is_array($input)) { $out = array(); foreach($input as $key => $value) { diff --git a/index.php b/index.php index 5c21c2f6..c96d0136 100644 --- a/index.php +++ b/index.php @@ -1609,7 +1609,15 @@ function($a, $b) { return $a['order'] - $b['order']; } function buildLinkList($PAGE,$LINKSDB, $conf, $pluginManager) { // Used in templates - $searchtags = !empty($_GET['searchtags']) ? escape(normalize_spaces($_GET['searchtags'])) : ''; + if (isset($_GET['searchtags'])) { + if (! empty($_GET['searchtags'])) { + $searchtags = escape(normalize_spaces($_GET['searchtags'])); + } else { + $searchtags = false; + } + } else { + $searchtags = ''; + } $searchterm = !empty($_GET['searchterm']) ? escape(normalize_spaces($_GET['searchterm'])) : ''; // Smallhash filter @@ -1624,7 +1632,11 @@ function buildLinkList($PAGE,$LINKSDB, $conf, $pluginManager) } else { // Filter links according search parameters. $visibility = ! empty($_SESSION['privateonly']) ? 'private' : 'all'; - $linksToDisplay = $LINKSDB->filterSearch($_GET, false, $visibility); + $request = [ + 'searchtags' => $searchtags, + 'searchterm' => $searchterm, + ]; + $linksToDisplay = $LINKSDB->filterSearch($request, false, $visibility); } // ---- Handle paging. @@ -1671,7 +1683,7 @@ function buildLinkList($PAGE,$LINKSDB, $conf, $pluginManager) } // Compute paging navigation - $searchtagsUrl = empty($searchtags) ? '' : '&searchtags=' . urlencode($searchtags); + $searchtagsUrl = $searchtags === '' ? '' : '&searchtags=' . urlencode($searchtags); $searchtermUrl = empty($searchterm) ? '' : '&searchterm=' . urlencode($searchterm); $previous_page_url = ''; if ($i != count($keys)) { diff --git a/tests/LinkDBTest.php b/tests/LinkDBTest.php index 1f62a34a..6fbf597a 100644 --- a/tests/LinkDBTest.php +++ b/tests/LinkDBTest.php @@ -448,7 +448,7 @@ public function testFilterHashInValid() public function testReorderLinksDesc() { self::$privateLinkDB->reorder('ASC'); - $linkIds = array(42, 4, 1, 0, 7, 6, 8, 41); + $linkIds = array(42, 4, 9, 1, 0, 7, 6, 8, 41); $cpt = 0; foreach (self::$privateLinkDB as $key => $value) { $this->assertEquals($linkIds[$cpt++], $key); diff --git a/tests/LinkFilterTest.php b/tests/LinkFilterTest.php index 37d5ca30..74162358 100644 --- a/tests/LinkFilterTest.php +++ b/tests/LinkFilterTest.php @@ -63,6 +63,12 @@ public function testFilter() count(self::$linkFilter->filter(LinkFilter::$FILTER_TAG, '')) ); + // Untagged only + $this->assertEquals( + self::$refDB->countUntaggedLinks(), + count(self::$linkFilter->filter(LinkFilter::$FILTER_TAG, false)) + ); + $this->assertEquals( ReferenceLinkDB::$NB_LINKS_TOTAL, count(self::$linkFilter->filter(LinkFilter::$FILTER_TEXT, '')) @@ -146,7 +152,7 @@ public function testFilterUnknownTag() public function testFilterDay() { $this->assertEquals( - 3, + 4, count(self::$linkFilter->filter(LinkFilter::$FILTER_DAY, '20121206')) ); } @@ -339,7 +345,7 @@ public function testExcludeSearch() ); $this->assertEquals( - 7, + ReferenceLinkDB::$NB_LINKS_TOTAL - 1, count(self::$linkFilter->filter(LinkFilter::$FILTER_TEXT, '-revolution')) ); } @@ -399,7 +405,7 @@ public function testTagFilterWithExclusion() ); $this->assertEquals( - 7, + ReferenceLinkDB::$NB_LINKS_TOTAL - 1, count(self::$linkFilter->filter(LinkFilter::$FILTER_TAG, '-free')) ); } @@ -425,6 +431,13 @@ public function testFilterCrossedSearch() array('', $terms) )) ); + $this->assertEquals( + 1, + count(self::$linkFilter->filter( + LinkFilter::$FILTER_TAG | LinkFilter::$FILTER_TEXT, + array(false, 'PSR-2') + )) + ); $this->assertEquals( 1, count(self::$linkFilter->filter( diff --git a/tests/api/controllers/GetLinksTest.php b/tests/api/controllers/GetLinksTest.php index 10330cd9..f1b262bc 100644 --- a/tests/api/controllers/GetLinksTest.php +++ b/tests/api/controllers/GetLinksTest.php @@ -94,7 +94,7 @@ public function testGetLinks() $this->assertEquals($this->refDB->countLinks(), count($data)); // Check order - $order = [41, 8, 6, 7, 0, 1, 4, 42]; + $order = [41, 8, 6, 7, 0, 1, 9, 4, 42]; $cpt = 0; foreach ($data as $link) { $this->assertEquals(self::NB_FIELDS_LINK, count($link)); @@ -163,7 +163,7 @@ public function testGetLinksLimitAll() $data = json_decode((string) $response->getBody(), true); $this->assertEquals($this->refDB->countLinks(), count($data)); // Check order - $order = [41, 8, 6, 7, 0, 1, 4, 42]; + $order = [41, 8, 6, 7, 0, 1, 9, 4, 42]; $cpt = 0; foreach ($data as $link) { $this->assertEquals(self::NB_FIELDS_LINK, count($link)); diff --git a/tests/api/controllers/InfoTest.php b/tests/api/controllers/InfoTest.php index 4beef3f7..5d6a2329 100644 --- a/tests/api/controllers/InfoTest.php +++ b/tests/api/controllers/InfoTest.php @@ -80,7 +80,7 @@ public function testGetInfo() $this->assertEquals(200, $response->getStatusCode()); $data = json_decode((string) $response->getBody(), true); - $this->assertEquals(8, $data['global_counter']); + $this->assertEquals(\ReferenceLinkDB::$NB_LINKS_TOTAL, $data['global_counter']); $this->assertEquals(2, $data['private_counter']); $this->assertEquals('Shaarli', $data['settings']['title']); $this->assertEquals('?', $data['settings']['header_link']); @@ -103,7 +103,7 @@ public function testGetInfo() $this->assertEquals(200, $response->getStatusCode()); $data = json_decode((string) $response->getBody(), true); - $this->assertEquals(8, $data['global_counter']); + $this->assertEquals(\ReferenceLinkDB::$NB_LINKS_TOTAL, $data['global_counter']); $this->assertEquals(2, $data['private_counter']); $this->assertEquals($title, $data['settings']['title']); $this->assertEquals($headerLink, $data['settings']['header_link']); diff --git a/tests/utils/ReferenceLinkDB.php b/tests/utils/ReferenceLinkDB.php index 36d58c68..29d63fac 100644 --- a/tests/utils/ReferenceLinkDB.php +++ b/tests/utils/ReferenceLinkDB.php @@ -4,7 +4,7 @@ */ class ReferenceLinkDB { - public static $NB_LINKS_TOTAL = 8; + public static $NB_LINKS_TOTAL = 9; private $_links = array(); private $_publicCount = 0; @@ -37,6 +37,16 @@ public function __construct() 'ut' ); + $this->addLink( + 9, + 'PSR-2: Coding Style Guide', + 'http://www.php-fig.org/psr/psr-2/', + 'This guide extends and expands on PSR-1, the basic coding standard.', + 0, + DateTime::createFromFormat(LinkDB::LINK_DATE_FORMAT, '20121206_152312'), + '' + ); + $this->addLink( 8, 'Free as in Freedom 2.0 @website', @@ -161,6 +171,20 @@ public function countPrivateLinks() return $this->_privateCount; } + /** + * Returns the number of links without tag + */ + public function countUntaggedLinks() + { + $cpt = 0; + foreach ($this->_links as $link) { + if (empty($link['tags'])) { + ++$cpt; + } + } + return $cpt; + } + public function getLinks() { return $this->_links; diff --git a/tpl/default/linklist.html b/tpl/default/linklist.html index 57ef4567..3d6be529 100644 --- a/tpl/default/linklist.html +++ b/tpl/default/linklist.html @@ -89,7 +89,7 @@
{'Nothing found.'|t}
- {elseif="!empty($search_term) or !empty($search_tags) or !empty($visibility)"} + {elseif="!empty($search_term) or $search_tags !== '' or !empty($visibility)"}
@@ -105,6 +105,10 @@ {$value} {/loop} + {elseif="$search_tags === false"} + + {'untagged'|t} + {/if} {if="!empty($visibility)"} {'with status'|t} diff --git a/tpl/vintage/linklist.html b/tpl/vintage/linklist.html index fc116667..8458caa1 100644 --- a/tpl/vintage/linklist.html +++ b/tpl/vintage/linklist.html @@ -55,7 +55,7 @@ {if="count($links)==0"}
Nothing found.
- {elseif="!empty($search_term) or !empty($search_tags)"} + {elseif="!empty($search_term) or $search_tags !== ''"}
{$result_count} results {if="!empty($search_term)"} @@ -69,6 +69,10 @@ {$value} x {/loop} + {elseif="$search_tags === false"} + + untagged x + {/if}
{/if} From acadb0801fea760c63dffba069be9241bd8e7a6e Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Thu, 25 May 2017 16:30:37 +0200 Subject: [PATCH 17/67] Display visited links in grey Fixes #244 --- tpl/default/css/shaarli.css | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tpl/default/css/shaarli.css b/tpl/default/css/shaarli.css index 28920648..3391fa05 100644 --- a/tpl/default/css/shaarli.css +++ b/tpl/default/css/shaarli.css @@ -539,8 +539,8 @@ body, .pure-g [class*="pure-u"] { color: #1b926c; } -.linklist-item-title .linklist-link:visited { - color: #1b926c; +.linklist-item-title a:visited .linklist-link { + color: #555555; } .linklist-item-title a:hover, .linklist-item-title .linklist-link:hover{ From d6aec9e60b5dad7b6e64b62dc4aa8a9f403634dc Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Thu, 25 May 2017 16:45:08 +0200 Subject: [PATCH 18/67] Selection is now limited to 2k characters using bookmarklets to avoid having too large URL Fixes #528 --- tpl/default/tools.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tpl/default/tools.html b/tpl/default/tools.html index 6951ad28..bf6b6ca3 100644 --- a/tpl/default/tools.html +++ b/tpl/default/tools.html @@ -75,7 +75,7 @@

Bookmarklets

window.open( '{$pageabsaddr}?post='%20+%20encodeURIComponent(url)+ '&title='%20+%20encodeURIComponent(title)+ - '&description='%20+%20encodeURIComponent(document.getSelection())+ + '&description='%20+%20encodeURIComponent(document.getSelection().toString().substr(0, 2000))+ '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' ); } @@ -91,7 +91,7 @@

Bookmarklets

function(){ window.open( '{$pageabsaddr}?private=1&post='+ - '&description='%20+%20encodeURIComponent(document.getSelection())+ + '&description='%20+%20encodeURIComponent(document.getSelection().toString().substr(0, 2000))+ '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' ); } From e2bcb9d915fdda15253dd730a6d172323a8e8564 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sun, 28 May 2017 13:04:31 +0200 Subject: [PATCH 19/67] Bookmarklet size limit: increase to 4500 chars and add an alert warning --- tpl/default/tools.html | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/tpl/default/tools.html b/tpl/default/tools.html index bf6b6ca3..35173d17 100644 --- a/tpl/default/tools.html +++ b/tpl/default/tools.html @@ -72,10 +72,15 @@

Bookmarklets

function(){ var%20url%20=%20location.href; var%20title%20=%20document.title%20||%20url; + var%20desc=document.getSelection().toString(); + if(desc.length>4000){ + desc=desc.substr(0,4000)+'...'; + alert('{function="str_replace(' ', '%20', t('The selected text is too long, it will be truncated.'))"}'); + } window.open( '{$pageabsaddr}?post='%20+%20encodeURIComponent(url)+ '&title='%20+%20encodeURIComponent(title)+ - '&description='%20+%20encodeURIComponent(document.getSelection().toString().substr(0, 2000))+ + '&description='%20+%20encodeURIComponent(desc)+ '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' ); } @@ -89,9 +94,14 @@

Bookmarklets

class="bookmarklet-link" href="javascript:( function(){ + var%20desc=document.getSelection().toString(); + if(desc.length>4000){ + desc=desc.substr(0,4000)+'...'; + alert("{function="str_replace(' ', '%20', t('The selected text is too long, it will be truncated.'))"}"); + } window.open( '{$pageabsaddr}?private=1&post='+ - '&description='%20+%20encodeURIComponent(document.getSelection().toString().substr(0, 2000))+ + '&description='%20+%20encodeURIComponent(desc)+ '&source=bookmarklet','_blank','menubar=no,height=800,width=600,toolbar=no,scrollbars=yes,status=no,dialog=1' ); } From 807cade64c571929dc19afe3d44787c5abe84f57 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Wed, 31 May 2017 17:50:11 +0200 Subject: [PATCH 20/67] Add creation date when editing a link Also, alter the title on edition Fixes #431 --- index.php | 2 +- tpl/default/css/shaarli.css | 8 ++++++++ tpl/default/editlink.html | 9 +++++++-- 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/index.php b/index.php index 92eb443b..cb0afbd0 100644 --- a/index.php +++ b/index.php @@ -1431,7 +1431,7 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) 'url' => $url, 'description' => $description, 'tags' => $tags, - 'private' => $private + 'private' => $private, ); } else { $link['linkdate'] = $link['created']->format(LinkDB::LINK_DATE_FORMAT); diff --git a/tpl/default/css/shaarli.css b/tpl/default/css/shaarli.css index 28920648..8b86bce2 100644 --- a/tpl/default/css/shaarli.css +++ b/tpl/default/css/shaarli.css @@ -992,6 +992,14 @@ form[name="linkform"].page-form { color: #3f3f3f; } +/** + * EDIT LINK + */ +#editlinkform .created-date { + color: #767676; + margin-bottom: 10px; +} + /** * LOGIN */ diff --git a/tpl/default/editlink.html b/tpl/default/editlink.html index 354499a4..d03fd72f 100644 --- a/tpl/default/editlink.html +++ b/tpl/default/editlink.html @@ -8,11 +8,15 @@
-

{'Shaare'|t}

+

+ {if="!$link_is_new"}{'Edit'|t}{/if} + {'Shaare'|t} +

{if="isset($link.id)"} {/if} + {if="!$link_is_new"}
{'Created:'|t} {$link.created|format_date}
{/if}
@@ -55,7 +59,8 @@

{'Shaare'|t}

- + {if="!$link_is_new"} From 4c970f099f2210ac91cccdca1d0c3564a8f79c1a Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Wed, 31 May 2017 18:24:21 +0200 Subject: [PATCH 21/67] Make sure that the tag exists before altering/removing it Fixes #886 --- index.php | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/index.php b/index.php index 2ff2505a..39230c80 100644 --- a/index.php +++ b/index.php @@ -1176,6 +1176,7 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) die('Wrong token.'); } + $count = 0; // Delete a tag: if (isset($_POST['deletetag']) && !empty($_POST['fromtag'])) { $needle = trim($_POST['fromtag']); @@ -1184,13 +1185,16 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) foreach($linksToAlter as $key=>$value) { $tags = explode(' ',trim($value['tags'])); - unset($tags[array_search($needle,$tags)]); // Remove tag. - $value['tags']=trim(implode(' ',$tags)); - $LINKSDB[$key]=$value; - $history->updateLink($LINKSDB[$key]); + if (($pos = array_search($needle,$tags)) !== false) { + unset($tags[$pos]); // Remove tag. + $value['tags']=trim(implode(' ',$tags)); + $LINKSDB[$key]=$value; + $history->updateLink($LINKSDB[$key]); + ++$count; + } } $LINKSDB->save($conf->get('resource.page_cache')); - echo ''; + echo ''; exit; } @@ -1202,13 +1206,16 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) foreach($linksToAlter as $key=>$value) { $tags = preg_split('/\s+/', trim($value['tags'])); // Replace tags value. - $tags[array_search($needle, $tags)] = trim($_POST['totag']); - $value['tags'] = implode(' ', array_unique($tags)); - $LINKSDB[$key] = $value; - $history->updateLink($LINKSDB[$key]); + if (($pos = array_search($needle,$tags)) !== false) { + $tags[$pos] = trim($_POST['totag']); + $value['tags'] = implode(' ', array_unique($tags)); + $LINKSDB[$key] = $value; + $history->updateLink($LINKSDB[$key]); + ++$count; + } } $LINKSDB->save($conf->get('resource.page_cache')); // Save to disk. - echo ''; + echo ''; exit; } } From d99aef535fa209c27c46a97dee4187ac21c84d4d Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Wed, 31 May 2017 18:36:35 +0200 Subject: [PATCH 22/67] Refactoring of CHANGETAG part to avoid duplicated code --- index.php | 61 ++++++++++++++++++++++++------------------------------- 1 file changed, 27 insertions(+), 34 deletions(-) diff --git a/index.php b/index.php index 39230c80..eb6b17d9 100644 --- a/index.php +++ b/index.php @@ -1176,48 +1176,41 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) die('Wrong token.'); } - $count = 0; - // Delete a tag: if (isset($_POST['deletetag']) && !empty($_POST['fromtag'])) { - $needle = trim($_POST['fromtag']); - // True for case-sensitive tag search. - $linksToAlter = $LINKSDB->filterSearch(array('searchtags' => $needle), true); - foreach($linksToAlter as $key=>$value) - { - $tags = explode(' ',trim($value['tags'])); - if (($pos = array_search($needle,$tags)) !== false) { - unset($tags[$pos]); // Remove tag. - $value['tags']=trim(implode(' ',$tags)); - $LINKSDB[$key]=$value; - $history->updateLink($LINKSDB[$key]); - ++$count; - } - } - $LINKSDB->save($conf->get('resource.page_cache')); - echo ''; + $delete = true; + } else if (isset($_POST['renametag']) && !empty($_POST['fromtag']) && !empty($_POST['totag'])) { + $delete = false; + } else { + $PAGE->renderPage('changetag'); exit; } - // Rename a tag: - if (isset($_POST['renametag']) && !empty($_POST['fromtag']) && !empty($_POST['totag'])) { - $needle = trim($_POST['fromtag']); - // True for case-sensitive tag search. - $linksToAlter = $LINKSDB->filterSearch(array('searchtags' => $needle), true); - foreach($linksToAlter as $key=>$value) { - $tags = preg_split('/\s+/', trim($value['tags'])); - // Replace tags value. - if (($pos = array_search($needle,$tags)) !== false) { + $count = 0; + $needle = trim($_POST['fromtag']); + // True for case-sensitive tag search. + $linksToAlter = $LINKSDB->filterSearch(array('searchtags' => $needle), true); + foreach($linksToAlter as $key => $value) + { + $tags = explode(' ',trim($value['tags'])); + if (($pos = array_search($needle,$tags)) !== false) { + if ($delete) { + unset($tags[$pos]); // Remove tag. + } else { $tags[$pos] = trim($_POST['totag']); - $value['tags'] = implode(' ', array_unique($tags)); - $LINKSDB[$key] = $value; - $history->updateLink($LINKSDB[$key]); - ++$count; } + $value['tags'] = trim(implode(' ', array_unique($tags))); + $LINKSDB[$key]=$value; + $history->updateLink($LINKSDB[$key]); + ++$count; } - $LINKSDB->save($conf->get('resource.page_cache')); // Save to disk. - echo ''; - exit; } + $LINKSDB->save($conf->get('resource.page_cache')); + $redirect = $delete ? 'do=changetag' : 'searchtags='. urlencode(escape($_POST['totag'])); + $alert = $delete + ? sprintf(t('The tag was removed from %d links.'), $count) + : sprintf(t('The tag was renamed in %d links.'), $count); + echo ''; + exit; } // -------- User wants to add a link without using the bookmarklet: Show form. From 9bf82f4fa14a871fcda1e14e07767d788540c8e3 Mon Sep 17 00:00:00 2001 From: Lucas Cimon Date: Wed, 7 Jun 2017 16:08:35 +0200 Subject: [PATCH 23/67] Fixing "Uncaught TypeError" in shaarli.js - fix #893 --- tpl/default/js/shaarli.js | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/tpl/default/js/shaarli.js b/tpl/default/js/shaarli.js index 4ebb7815..b120c91e 100644 --- a/tpl/default/js/shaarli.js +++ b/tpl/default/js/shaarli.js @@ -418,7 +418,8 @@ window.onload = function () { * * TODO: support error code in the backend for AJAX requests */ - var existingTags = document.querySelector('input[name="taglist"]').value.split(' '); + var tagList = document.querySelector('input[name="taglist"]'); + var existingTags = tagList ? tagList.value.split(' ') : []; var awesomepletes = []; // Display/Hide rename form @@ -515,7 +516,7 @@ window.onload = function () { }); }); - updateAwesompleteList('.rename-tag-input', document.querySelector('input[name="taglist"]').value.split(' '), awesomepletes); + updateAwesompleteList('.rename-tag-input', existingTags, awesomepletes); }; /** From 49cc8e5d747e6c3504803cf4fa1589fa204e32b5 Mon Sep 17 00:00:00 2001 From: Lucas Cimon Date: Fri, 2 Jun 2017 17:58:26 +0200 Subject: [PATCH 24/67] Tagcloud/list improvments --- index.php | 10 +++++++++- tpl/default/tag.cloud.html | 7 ++++++- tpl/default/tag.list.html | 5 ++++- 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/index.php b/index.php index 2ff2505a..85486eb5 100644 --- a/index.php +++ b/index.php @@ -805,6 +805,9 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) $tagList = array(); foreach($tags as $key => $value) { + if (in_array($key, $filteringTags)) { + continue; + } // Tag font size scaling: // default 15 and 30 logarithm bases affect scaling, // 22 and 6 are arbitrary font sizes for max and min sizes. @@ -829,12 +832,17 @@ function renderPage($conf, $pluginManager, $LINKSDB, $history) exit; } - // -------- Tag cloud + // -------- Tag list if ($targetPage == Router::$PAGE_TAGLIST) { $visibility = ! empty($_SESSION['privateonly']) ? 'private' : 'all'; $filteringTags = isset($_GET['searchtags']) ? explode(' ', $_GET['searchtags']) : []; $tags = $LINKSDB->linksCountPerTag($filteringTags, $visibility); + foreach ($filteringTags as $tag) { + if (array_key_exists($tag, $tags)) { + unset($tags[$tag]); + } + } if (! empty($_GET['sort']) && $_GET['sort'] === 'alpha') { alphabetical_sort($tags, false, true); diff --git a/tpl/default/tag.cloud.html b/tpl/default/tag.cloud.html index 59aa2ee0..96b357a3 100644 --- a/tpl/default/tag.cloud.html +++ b/tpl/default/tag.cloud.html @@ -13,6 +13,11 @@
{$countTags=count($tags)}

{'Tag cloud'|t} - {$countTags} {'tags'|t}

+ {if="!empty($search_tags)"} +

+ {'List all links with those tags'|t} +

+ {/if}
@@ -40,7 +45,7 @@

{'Tag cloud'|t} - {$countTags} {'tags'|t}

{loop="tags"} - {$key}{$key}{$value.count} {loop="$value.tag_plugin"} {$value} diff --git a/tpl/default/tag.list.html b/tpl/default/tag.list.html index 62e2e7c6..81d6e5af 100644 --- a/tpl/default/tag.list.html +++ b/tpl/default/tag.list.html @@ -13,6 +13,9 @@
{$countTags=count($tags)}

{'Tag list'|t} - {$countTags} {'tags'|t}

+

+ {'List all links with those tags'|t} +

@@ -50,7 +53,7 @@

{'Tag list'|t} - {$countTags} {'tags'|t}

{/if} {$value} - {$key} + {$key} {loop="$value.tag_plugin"} {$value} From 8eb6bac137d31b36ff2da5970f1ac398cf574435 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sun, 11 Jun 2017 14:09:42 +0200 Subject: [PATCH 25/67] Fix Firefox Social button in the default theme is no longer required since the JS function is now in . Also, include the trailing slash in the post URL. Fixes #895 --- tpl/default/js/shaarli.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tpl/default/js/shaarli.js b/tpl/default/js/shaarli.js index b120c91e..4f49affa 100644 --- a/tpl/default/js/shaarli.js +++ b/tpl/default/js/shaarli.js @@ -606,7 +606,7 @@ function htmlEntities(str) function activateFirefoxSocial(node) { var loc = location.href; - var baseURL = loc.substring(0, loc.lastIndexOf("/")); + var baseURL = loc.substring(0, loc.lastIndexOf("/") + 1); // Keeping the data separated (ie. not in the DOM) so that it's maintainable and diffable. var data = { @@ -619,7 +619,7 @@ function activateFirefoxSocial(node) { icon32URL: baseURL + "/images/favicon.ico", icon64URL: baseURL + "/images/favicon.ico", - shareURL: baseURL + "{noparse}?post=%{url}&title=%{title}&description=%{text}&source=firefoxsocialapi{/noparse}", + shareURL: baseURL + "?post=%{url}&title=%{title}&description=%{text}&source=firefoxsocialapi", homepageURL: baseURL }; node.setAttribute("data-service", JSON.stringify(data)); From 53ed6d7d1e678d7486337ce67a2f17b30bac21ac Mon Sep 17 00:00:00 2001 From: nodiscc Date: Thu, 26 Jan 2017 18:52:54 +0100 Subject: [PATCH 26/67] Generate HTML documentation using MkDocs (WIP) MkDocs is a static site generator geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML file. * http://www.mkdocs.org/ * http://www.mkdocs.org/user-guide/configuration/ Ref. #312 * remove pandoc-generated HTML documentation * move markdown doc to doc/md/, * mkdocs.yml: * generate HTML doc in doc/html * add pages TOC/ordering * use index.md as index page * Makefile: remove execute permissions from generated files * Makefile: rewrite htmlpages GFM to markdown conversion using sed: awk expression aslo matched '][' which causes invalid output on complex links with images or code blocks * Add mkdocs.yml to .gitattributes, exclude this file from release archives * Makefile: rename: htmldoc -> doc_html target * run make doc: pull latest markdown documentation from wiki * run make htmlpages: update html documentation --- .gitattributes | 1 + Makefile | 50 +- doc/3rd-party-libraries.html | 88 - doc/Backup,-restore,-import-and-export.html | 152 -- doc/Browsing-and-searching.html | 83 - doc/Coding-guidelines.html | 75 - doc/Community-&-Related-software.html | 131 -- ...llation-over-SSH-and-serve-it-locally.html | 165 -- ...te-and-serve-multiple-Shaarlis-(farm).html | 159 -- doc/Datastore-hacks.html | 124 -- doc/Development.html | 112 -- doc/Development.md | 35 - doc/Directory-structure.html | 135 -- doc/Docker.html | 245 --- ...Download-CSS-styles-from-an-OPML-list.html | 257 --- doc/Download-and-Installation.html | 172 -- ...e-patch---add-new-via-field-for-links.html | 254 --- doc/FAQ.html | 107 -- doc/Firefox-share.html | 95 -- doc/GnuPG-signature.html | 175 -- doc/Home.html | 76 - doc/Plugin-System.html | 634 ------- doc/Plugins.html | 155 -- doc/REST-API.html | 169 -- doc/RSS-feeds.html | 99 -- doc/Release-Shaarli.html | 224 --- doc/Security.html | 135 -- doc/Server-configuration.html | 459 ----- doc/Server-requirements.html | 195 --- doc/Server-security.html | 175 -- doc/Shaarli-configuration.html | 298 ---- doc/Sharing-button.html | 94 - doc/Static-analysis.html | 82 - doc/Theming.html | 182 -- doc/Troubleshooting.html | 202 --- doc/Unit-tests.html | 226 --- doc/Upgrade-and-migration.html | 259 --- doc/Usage.html | 95 -- doc/Versioning-and-Branches.html | 156 -- doc/_Footer.html | 70 - doc/_Sidebar.html | 119 -- doc/html/3rd-party-libraries/index.html | 369 ++++ .../index.html | 411 +++++ doc/html/Bookmarklet/index.html | 375 ++++ doc/html/Browsing-and-searching/index.html | 362 ++++ doc/html/Coding-guidelines/index.html | 348 ++++ .../Community-&-Related-software/index.html | 419 +++++ .../Continuous-integration-tools/index.html | 367 ++++ .../index.html | 403 +++++ .../index.html | 396 +++++ doc/html/Datastore-hacks/index.html | 369 ++++ doc/html/Development-guidelines/index.html | 352 ++++ doc/html/Directory-structure/index.html | 371 ++++ doc/html/Docker-101/index.html | 410 +++++ doc/html/Docker-resources/index.html | 370 ++++ .../index.html | 496 ++++++ doc/html/Download-and-Installation/index.html | 444 +++++ doc/html/FAQ/index.html | 388 +++++ doc/html/Features/index.html | 371 ++++ doc/html/Firefox-share/index.html | 368 ++++ doc/html/GnuPG-signature/index.html | 439 +++++ doc/html/Plugin-System/index.html | 968 +++++++++++ doc/html/Plugins/index.html | 414 +++++ doc/html/REST-API/index.html | 431 +++++ doc/html/RSS-feeds/index.html | 367 ++++ doc/html/Release-Shaarli/index.html | 529 ++++++ .../Reverse-proxy-configuration/index.html | 350 ++++ doc/html/Security/index.html | 386 +++++ doc/html/Server-configuration/index.html | 747 ++++++++ doc/html/Server-requirements/index.html | 475 ++++++ doc/html/Server-security/index.html | 429 +++++ doc/html/Shaarli-configuration/index.html | 563 ++++++ doc/html/Shaarli-images/index.html | 425 +++++ doc/html/Static-analysis/index.html | 359 ++++ doc/html/Theming/index.html | 435 +++++ doc/html/Troubleshooting/index.html | 441 +++++ doc/html/Unit-tests/index.html | 492 ++++++ doc/html/Upgrade-and-migration/index.html | 534 ++++++ doc/html/Versioning-and-Branches/index.html | 418 +++++ doc/{ => html}/config.json | 0 doc/html/css/highlight.css | 124 ++ doc/html/css/theme.css | 12 + doc/html/css/theme_extra.css | 193 +++ doc/html/fonts/fontawesome-webfont.eot | Bin 0 -> 37405 bytes doc/html/fonts/fontawesome-webfont.svg | Bin 0 -> 197829 bytes doc/html/fonts/fontawesome-webfont.ttf | Bin 0 -> 79076 bytes doc/html/fonts/fontawesome-webfont.woff | Bin 0 -> 43572 bytes doc/{ => html}/github-markdown.css | 0 doc/{ => html}/images/bookmarklet.png | Bin doc/{ => html}/images/doc-logo.png | Bin doc/{ => html}/images/doc-logo.svg | Bin doc/{ => html}/images/firefoxshare.png | Bin doc/{ => html}/images/rss-filter-1.png | Bin doc/{ => html}/images/rss-filter-2.png | Bin doc/html/img/favicon.ico | Bin 0 -> 1150 bytes doc/html/index.html | 344 ++++ doc/html/js/highlight.pack.js | 2 + doc/html/js/jquery-2.1.1.min.js | Bin 0 -> 84245 bytes doc/html/js/modernizr-2.8.3.min.js | Bin 0 -> 11084 bytes doc/html/js/theme.js | 82 + doc/html/mkdocs/js/lunr.min.js | Bin 0 -> 15439 bytes doc/html/mkdocs/js/mustache.min.js | Bin 0 -> 8835 bytes doc/html/mkdocs/js/require.js | 36 + .../js/search-results-template.mustache | 4 + doc/html/mkdocs/js/search.js | 88 + doc/html/mkdocs/js/text.js | 390 +++++ doc/html/mkdocs/search_index.json | 1519 +++++++++++++++++ doc/html/search.html | 324 ++++ doc/html/sitemap.xml | 266 +++ doc/{ => md}/3rd-party-libraries.md | 13 +- .../Backup,-restore,-import-and-export.md | 23 +- doc/{Sharing-button.md => md/Bookmarklet.md} | 7 +- doc/{ => md}/Browsing-and-searching.md | 7 +- doc/{ => md}/Coding-guidelines.md | 6 +- doc/{ => md}/Community-&-Related-software.md | 73 +- doc/md/Continuous-integration-tools.md | 24 + ...tallation-over-SSH-and-serve-it-locally.md | 7 +- ...eate-and-serve-multiple-Shaarlis-(farm).md | 21 +- doc/{ => md}/Datastore-hacks.md | 3 +- doc/md/Development-guidelines.md | 9 + doc/{ => md}/Directory-structure.md | 3 +- doc/md/Docker-101.md | 62 + doc/md/Docker-resources.md | 19 + .../Download-CSS-styles-from-an-OPML-list.md | 13 +- doc/{ => md}/Download-and-Installation.md | 15 +- ...ple-patch---add-new-via-field-for-links.md | 97 +- doc/{ => md}/FAQ.md | 15 +- doc/{Usage.md => md/Features.md} | 3 +- doc/{ => md}/Firefox-share.md | 3 +- doc/{ => md}/GnuPG-signature.md | 25 +- doc/{ => md}/Plugin-System.md | 89 +- doc/{ => md}/Plugins.md | 15 +- doc/md/REST-API.md | 104 ++ doc/{ => md}/RSS-feeds.md | 3 +- doc/{ => md}/Release-Shaarli.md | 77 +- doc/md/Reverse-proxy-configuration.md | 6 + doc/{ => md}/Security.md | 1 - doc/{ => md}/Server-configuration.md | 55 +- doc/{ => md}/Server-requirements.md | 32 +- doc/{ => md}/Server-security.md | 11 +- doc/{ => md}/Shaarli-configuration.md | 29 +- doc/md/Shaarli-images.md | 72 + doc/{ => md}/Static-analysis.md | 11 +- doc/{ => md}/Theming.md | 35 +- doc/{ => md}/Troubleshooting.md | 38 +- doc/{ => md}/Unit-tests.md | 17 +- doc/{ => md}/Upgrade-and-migration.md | 50 +- doc/md/Versioning-and-Branches.md | 75 + doc/{ => md}/_Footer.md | 3 +- doc/md/_Sidebar.md | 45 + doc/md/config.json | 6 + doc/md/github-markdown.css | 287 ++++ doc/md/images/bookmarklet.png | Bin 0 -> 53346 bytes doc/md/images/doc-logo.png | Bin 0 -> 19543 bytes doc/md/images/doc-logo.svg | Bin 0 -> 69439 bytes doc/md/images/firefoxshare.png | Bin 0 -> 757 bytes doc/md/images/rss-filter-1.png | Bin 0 -> 18682 bytes doc/md/images/rss-filter-2.png | Bin 0 -> 15604 bytes doc/{Home.md => md/index.md} | 11 +- doc/sidebar.html | 52 - mkdocs.yml | 53 + tpl/default/page.footer.html | 10 + 162 files changed, 21193 insertions(+), 7136 deletions(-) delete mode 100644 doc/3rd-party-libraries.html delete mode 100644 doc/Backup,-restore,-import-and-export.html delete mode 100644 doc/Browsing-and-searching.html delete mode 100644 doc/Coding-guidelines.html delete mode 100644 doc/Community-&-Related-software.html delete mode 100644 doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html delete mode 100644 doc/Create-and-serve-multiple-Shaarlis-(farm).html delete mode 100644 doc/Datastore-hacks.html delete mode 100644 doc/Development.html delete mode 100644 doc/Development.md delete mode 100644 doc/Directory-structure.html delete mode 100644 doc/Docker.html delete mode 100644 doc/Download-CSS-styles-from-an-OPML-list.html delete mode 100644 doc/Download-and-Installation.html delete mode 100644 doc/Example-patch---add-new-via-field-for-links.html delete mode 100644 doc/FAQ.html delete mode 100644 doc/Firefox-share.html delete mode 100644 doc/GnuPG-signature.html delete mode 100644 doc/Home.html delete mode 100644 doc/Plugin-System.html delete mode 100644 doc/Plugins.html delete mode 100644 doc/REST-API.html delete mode 100644 doc/RSS-feeds.html delete mode 100644 doc/Release-Shaarli.html delete mode 100644 doc/Security.html delete mode 100644 doc/Server-configuration.html delete mode 100644 doc/Server-requirements.html delete mode 100644 doc/Server-security.html delete mode 100644 doc/Shaarli-configuration.html delete mode 100644 doc/Sharing-button.html delete mode 100644 doc/Static-analysis.html delete mode 100644 doc/Theming.html delete mode 100644 doc/Troubleshooting.html delete mode 100644 doc/Unit-tests.html delete mode 100644 doc/Upgrade-and-migration.html delete mode 100644 doc/Usage.html delete mode 100644 doc/Versioning-and-Branches.html delete mode 100644 doc/_Footer.html delete mode 100644 doc/_Sidebar.html create mode 100644 doc/html/3rd-party-libraries/index.html create mode 100644 doc/html/Backup,-restore,-import-and-export/index.html create mode 100644 doc/html/Bookmarklet/index.html create mode 100644 doc/html/Browsing-and-searching/index.html create mode 100644 doc/html/Coding-guidelines/index.html create mode 100644 doc/html/Community-&-Related-software/index.html create mode 100644 doc/html/Continuous-integration-tools/index.html create mode 100644 doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html create mode 100644 doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html create mode 100644 doc/html/Datastore-hacks/index.html create mode 100644 doc/html/Development-guidelines/index.html create mode 100644 doc/html/Directory-structure/index.html create mode 100644 doc/html/Docker-101/index.html create mode 100644 doc/html/Docker-resources/index.html create mode 100644 doc/html/Download-CSS-styles-from-an-OPML-list/index.html create mode 100644 doc/html/Download-and-Installation/index.html create mode 100644 doc/html/FAQ/index.html create mode 100644 doc/html/Features/index.html create mode 100644 doc/html/Firefox-share/index.html create mode 100644 doc/html/GnuPG-signature/index.html create mode 100644 doc/html/Plugin-System/index.html create mode 100644 doc/html/Plugins/index.html create mode 100644 doc/html/REST-API/index.html create mode 100644 doc/html/RSS-feeds/index.html create mode 100644 doc/html/Release-Shaarli/index.html create mode 100644 doc/html/Reverse-proxy-configuration/index.html create mode 100644 doc/html/Security/index.html create mode 100644 doc/html/Server-configuration/index.html create mode 100644 doc/html/Server-requirements/index.html create mode 100644 doc/html/Server-security/index.html create mode 100644 doc/html/Shaarli-configuration/index.html create mode 100644 doc/html/Shaarli-images/index.html create mode 100644 doc/html/Static-analysis/index.html create mode 100644 doc/html/Theming/index.html create mode 100644 doc/html/Troubleshooting/index.html create mode 100644 doc/html/Unit-tests/index.html create mode 100644 doc/html/Upgrade-and-migration/index.html create mode 100644 doc/html/Versioning-and-Branches/index.html rename doc/{ => html}/config.json (100%) create mode 100644 doc/html/css/highlight.css create mode 100644 doc/html/css/theme.css create mode 100644 doc/html/css/theme_extra.css create mode 100644 doc/html/fonts/fontawesome-webfont.eot create mode 100644 doc/html/fonts/fontawesome-webfont.svg create mode 100644 doc/html/fonts/fontawesome-webfont.ttf create mode 100644 doc/html/fonts/fontawesome-webfont.woff rename doc/{ => html}/github-markdown.css (100%) rename doc/{ => html}/images/bookmarklet.png (100%) rename doc/{ => html}/images/doc-logo.png (100%) rename doc/{ => html}/images/doc-logo.svg (100%) rename doc/{ => html}/images/firefoxshare.png (100%) rename doc/{ => html}/images/rss-filter-1.png (100%) rename doc/{ => html}/images/rss-filter-2.png (100%) create mode 100644 doc/html/img/favicon.ico create mode 100644 doc/html/index.html create mode 100644 doc/html/js/highlight.pack.js create mode 100644 doc/html/js/jquery-2.1.1.min.js create mode 100644 doc/html/js/modernizr-2.8.3.min.js create mode 100644 doc/html/js/theme.js create mode 100644 doc/html/mkdocs/js/lunr.min.js create mode 100644 doc/html/mkdocs/js/mustache.min.js create mode 100644 doc/html/mkdocs/js/require.js create mode 100644 doc/html/mkdocs/js/search-results-template.mustache create mode 100644 doc/html/mkdocs/js/search.js create mode 100644 doc/html/mkdocs/js/text.js create mode 100644 doc/html/mkdocs/search_index.json create mode 100644 doc/html/search.html create mode 100644 doc/html/sitemap.xml rename doc/{ => md}/3rd-party-libraries.md (73%) rename doc/{ => md}/Backup,-restore,-import-and-export.md (87%) rename doc/{Sharing-button.md => md/Bookmarklet.md} (76%) rename doc/{ => md}/Browsing-and-searching.md (83%) rename doc/{ => md}/Coding-guidelines.md (64%) rename doc/{ => md}/Community-&-Related-software.md (64%) create mode 100644 doc/md/Continuous-integration-tools.md rename doc/{ => md}/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md (88%) rename doc/{ => md}/Create-and-serve-multiple-Shaarlis-(farm).md (77%) rename doc/{ => md}/Datastore-hacks.md (98%) create mode 100644 doc/md/Development-guidelines.md rename doc/{ => md}/Directory-structure.md (98%) create mode 100644 doc/md/Docker-101.md create mode 100644 doc/md/Docker-resources.md rename doc/{ => md}/Download-CSS-styles-from-an-OPML-list.md (92%) rename doc/{ => md}/Download-and-Installation.md (88%) rename doc/{ => md}/Example-patch---add-new-via-field-for-links.md (80%) rename doc/{ => md}/FAQ.md (89%) rename doc/{Usage.md => md/Features.md} (96%) rename doc/{ => md}/Firefox-share.md (86%) rename doc/{ => md}/GnuPG-signature.md (87%) rename doc/{ => md}/Plugin-System.md (88%) rename doc/{ => md}/Plugins.md (86%) create mode 100644 doc/md/REST-API.md rename doc/{ => md}/RSS-feeds.md (93%) rename doc/{ => md}/Release-Shaarli.md (74%) create mode 100644 doc/md/Reverse-proxy-configuration.md rename doc/{ => md}/Security.md (99%) rename doc/{ => md}/Server-configuration.md (92%) rename doc/{ => md}/Server-requirements.md (73%) rename doc/{ => md}/Server-security.md (93%) rename doc/{ => md}/Shaarli-configuration.md (90%) create mode 100644 doc/md/Shaarli-images.md rename doc/{ => md}/Static-analysis.md (68%) rename doc/{ => md}/Theming.md (79%) rename doc/{ => md}/Troubleshooting.md (92%) rename doc/{ => md}/Unit-tests.md (96%) rename doc/{ => md}/Upgrade-and-migration.md (83%) create mode 100644 doc/md/Versioning-and-Branches.md rename doc/{ => md}/_Footer.md (69%) create mode 100644 doc/md/_Sidebar.md create mode 100644 doc/md/config.json create mode 100644 doc/md/github-markdown.css create mode 100644 doc/md/images/bookmarklet.png create mode 100644 doc/md/images/doc-logo.png create mode 100644 doc/md/images/doc-logo.svg create mode 100644 doc/md/images/firefoxshare.png create mode 100644 doc/md/images/rss-filter-1.png create mode 100644 doc/md/images/rss-filter-2.png rename doc/{Home.md => md/index.md} (89%) delete mode 100644 doc/sidebar.html create mode 100644 mkdocs.yml diff --git a/.gitattributes b/.gitattributes index 82f37602..dd0e573c 100644 --- a/.gitattributes +++ b/.gitattributes @@ -33,5 +33,6 @@ doc/**/*.md export-ignore docker/ export-ignore Doxyfile export-ignore Makefile export-ignore +mkdocs.yml export-ignore phpunit.xml export-ignore tests/ export-ignore diff --git a/Makefile b/Makefile index 1d8a73a2..1ddd60f8 100644 --- a/Makefile +++ b/Makefile @@ -194,42 +194,28 @@ doxygen: clean ### update the local copy of the documentation doc: clean - @rm -rf doc - @git clone https://github.com/shaarli/Shaarli.wiki.git doc - @rm -rf doc/.git - -### Generate a custom sidebar -# -# Sidebar content: -# - convert GitHub-flavoured relative links to standard Markdown -# - trim HTML, only keep the list (
    [...]
) part -htmlsidebar: - @echo '
' > doc/sidebar.html - @awk 'BEGIN { FS = "[\\[\\]]{2}" }'\ - 'm = /\[/ { t=$$2; gsub(/ /, "-", $$2); print $$1"["t"]("$$2".html)"$$3 }'\ - '!m { print $$0 }' doc/_Sidebar.md > doc/tmp.md - @pandoc -f markdown -t html5 -s doc/tmp.md | awk '/(ul>|li>)/' >> doc/sidebar.html - @echo '
' >> doc/sidebar.html - @rm doc/tmp.md + @rm -rf doc/md/ + @git clone https://github.com/shaarli/Shaarli.wiki.git doc/md + mv doc/md/Home.md doc/md/index.md + @rm -rf doc/md/.git ### Convert local markdown documentation to HTML # # For all pages: -# - infer title from the file name # - convert GitHub-flavoured relative links to standard Markdown -# - insert the sidebar menu +# - generate html documentation with mkdocs htmlpages: - @for file in `find doc/ -maxdepth 1 -name "*.md"`; do \ - base=`basename $$file .md`; \ - sed -i "1i #$${base//-/ }" $$file; \ - awk 'BEGIN { FS = "[\\[\\]]{2}" }'\ - 'm = /\[/ { t=$$2; gsub(/ /, "-", $$2); print $$1"["t"]("$$2".html)"$$3 }'\ - '!m { print $$0 }' $$file > doc/tmp.md; \ - mv doc/tmp.md $$file; \ - pandoc -f markdown_github -t html5 -s \ - -c "github-markdown.css" \ - -T Shaarli -M pagetitle:"$${base//-/ }" -B doc/sidebar.html \ - -o doc/$$base.html $$file; \ - done; + # Rename local [[links]] to regular links. + @for file in `find doc/md/ -maxdepth 1 -name "*.md"`; do \ + sed -e "s/\[\[\(.*\)\]\]/[\1](\1)/g" "$$file" > doc/md/tmp.md; \ + mv doc/md/tmp.md $$file; \ + done -htmldoc: authors doc htmlsidebar htmlpages + python3 -m venv venv/ + bash -c 'source venv/bin/activate; \ + pip install mkdocs; \ + mkdocs build' + find doc/html/ -type f -exec chmod a-x '{}' \; + rm -r venv + +doc_html: authors doc htmlpages diff --git a/doc/3rd-party-libraries.html b/doc/3rd-party-libraries.html deleted file mode 100644 index 50aba6c0..00000000 --- a/doc/3rd-party-libraries.html +++ /dev/null @@ -1,88 +0,0 @@ - - - - - - - Shaarli – 3rd party libraries - - - - - - -

3rd party libraries

-

CSS

-
    -
  • Yahoo UI CSS Reset -
      -
    • resets default CSS properties for all HTML elements (overriding browsers' default values)
      • -
    • ensures custom CSS stylessheets will provide the same results on all browsers
      • -
    • -
-

Javascript

- -

PHP

- - - diff --git a/doc/Backup,-restore,-import-and-export.html b/doc/Backup,-restore,-import-and-export.html deleted file mode 100644 index 3c168824..00000000 --- a/doc/Backup,-restore,-import-and-export.html +++ /dev/null @@ -1,152 +0,0 @@ - - - - - - - Shaarli – Backup, restore, import and export - - - - - - - -

Backup, restore, import and export

- -
-

Backup and restore the datastore file

-

Backup the file data/datastore.php (by FTP or SSH). Restore by putting the file back in place.

-

Example command:

-
rsync -avzP my.server.com:/var/www/shaarli/data/datastore.php datastore-$(date +%Y-%m-%d_%H%M).php
- -

To export links as an HTML file, under Tools > Export, choose:

-
    -
  • Export all to export both public and private links
    • -
  • Export public to export public links only
    • -
  • Export private to export private links only
    • -
-

Restore by using the Import feature.

- -

Example command:

-
./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all
- -

Diigo

-

If you export your bookmark from Diigo, make sure you use the Delicious export, not the Netscape export. (Their Netscape export is broken, and they don't seem to be interested in fixing it.)

-

Mister Wong

-

See this issue for import tweaks.

-

SemanticScuttle

-

To correctly import the tags from a SemanticScuttle HTML export, edit the HTML file before importing and replace all occurences of tags= (lowercase) to TAGS= (uppercase).

-

Scuttle

-

Shaarli cannot import data directly from Scuttle. However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer.

- -
    -
  • Export your Shaarli links as described above.
    • -
  • For compatibility reasons, check Prepend note permalinks with this Shaarli instance's URL (useful to import bookmarks in a web browser)
    • -
  • In Firefox, open the bookmark manager (not the sidebar! Bookmarks menu > Show all bookmarks or Ctrl+Shift+B)
    • -
  • Select Import and Backup > Import bookmarks in HTML format
    • -
-

Your bookmarks will be imported in Firefox, ready to use, with tags and descriptions retained. "Self" (notes) shaares will still point to the Shaarli instance you exported them from, but the note text can be viewed directly in the bookmark properties inside your browser. Depending on the number of bookmarks, the import can take some time.

-

You may be interested in these Firefox addons to manage links imported from Shaarli

- - - diff --git a/doc/Browsing-and-searching.html b/doc/Browsing-and-searching.html deleted file mode 100644 index ef5b5245..00000000 --- a/doc/Browsing-and-searching.html +++ /dev/null @@ -1,83 +0,0 @@ - - - - - - - Shaarli – Browsing and searching - - - - - - -

Browsing and searching

-

Browsing and Searching

-

-

Plain text search

-

Use the Search text field to search in any of the fields of all links (Title, URL, Description...)

-

Exclude text/tags: Use the - operator before a word or tag (example -uninteresting) to prevent entries containing (or tagged) uninteresting from showing up in the search results.

-

Exact text search: Use double-quotes (example "exact search") to search for the exact expression.

-

Both exclude patterns and exact searches can be combined with normal searches (example "exact search" term otherterm -notthis "very exact" stuff -notagain)

- -

Use the Filter by tags field to restrict displayed links to entries tagged with one or multiple tags (use space to separate tags).

-

Hidden tags: Tags starting with a dot . (example .secret) are private. They can only be seen and searched when logged in.

-

Alternatively you can use the Tag cloud to discover all tags and click on any of them to display related links.

-

To search for links that are not tagged, enter "" in the tag search field.

-

Filtering RSS feeds/Picture wall

-

RSS feeds can also be restricted to only return items matching a text/tag search: see RSS feeds.

- - diff --git a/doc/Coding-guidelines.html b/doc/Coding-guidelines.html deleted file mode 100644 index 8df12182..00000000 --- a/doc/Coding-guidelines.html +++ /dev/null @@ -1,75 +0,0 @@ - - - - - - - Shaarli – Coding guidelines - - - - - - -

Coding guidelines

-

WIP

-

This topic is currently being discussed here:

- - - diff --git a/doc/Community-&-Related-software.html b/doc/Community-&-Related-software.html deleted file mode 100644 index 28b96185..00000000 --- a/doc/Community-&-Related-software.html +++ /dev/null @@ -1,131 +0,0 @@ - - - - - - - Shaarli – Community & Related software - - - - - - -

Community & Related software

-

Unofficial but related work on Shaarli. If you maintain one of these, please get in touch with us to help us find a way to adapt your work to our fork.

-

TODO: contact repos owners to see if they'd like to standardize their work with the community fork.

-

Community

- -

Articles and social media discussions

- -

Third party plugins

- -

Themes

-

See Theming for the list of community-contributed themes, and an installation guide.

-

Server apps

-
    -
  • shaarchiver - Archive your Shaarli bookmarks and their content
    • -
  • shaarli-river - An aggregator for shaarlis with many features
    • -
  • Shaarlo - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: shaarli.fr)
    • -
  • Shaarlimages - An image-oriented aggregator for Shaarlis
    • -
  • mknexen/shaarli-api - A REST API for Shaarli
    • -
  • Self dead link - Detect dead links on shaarli. This version use the database of shaarli. Another version, can be used for other shaarli instances (but is more resource consuming).
    • -
-

Mobile Apps

- -

Integration with other platforms

- -

Alternatives to Shaarli

- - - diff --git a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html b/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html deleted file mode 100644 index d6b76add..00000000 --- a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html +++ /dev/null @@ -1,165 +0,0 @@ - - - - - - - Shaarli – Copy an existing installation over SSH and serve it locally - - - - - - - -

Copy an existing installation over SSH and serve it locally

-

Example bash script:

-
#!/bin/bash
-#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli
-#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally.
-#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli
-#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed
-#Usage: ./local-shaarli.sh
-#Author: nodiscc (nodiscc@gmail.com)
-#License: MIT (http://opensource.org/licenses/MIT)
-set -o errexit
-set -o nounset
-
-##### CONFIG #################
-#The port used by php's local server
-php_local_port=7431
-
-#Name of the SSH server and path where Shaarli is installed
-#TODO: pass these as command-line arguments
-remotehost="my.ssh.server"
-remote_shaarli_dir="/var/www/shaarli"
-
-
-###### FUNCTIONS #############
-_main() {
-    _CBSyncShaarli
-    _CBServeShaarli
-}
-
-_CBSyncShaarli() {
-    remote_temp_dir=$(ssh $remotehost mktemp -d)
-    remote_ssh_user=$(ssh $remotehost whoami)
-    ssh -t "$remotehost" sudo cp -r "$remote_shaarli_dir" "$remote_temp_dir"
-    ssh -t "$remotehost" sudo chown -R "$remote_ssh_user":"$remote_ssh_user" "$remote_temp_dir"
-    scp -rq "$remotehost":"$remote_temp_dir" local-shaarli
-    ssh "$remotehost" rm -r "$remote_temp_dir"
-}
-
-_CBServeShaarli() {
-    #TODO: allow serving a previously downloaded Shaarli
-    #TODO: ask before overwriting local copy, if it exists
-    cd local-shaarli/
-    php -S localhost:${php_local_port}
-    echo "Please go to http://localhost:${php_local_port}"
-}
-
-
-##### MAIN #################
-
-_main
-

This outputs:

-
$ ./local-shaarli.sh
-PHP 5.6.0RC4 Development Server started at Mon Sep  1 21:56:19 2014
-Listening on http://localhost:7431
-Document root is /home/user/local-shaarli/shaarli
-Press Ctrl-C to quit.
-
-[Mon Sep  1 21:56:27 2014] ::1:57868 [200]: /[](.html)
-[Mon Sep  1 21:56:27 2014] ::1:57869 [200]: /index.html[](.html)
-[Mon Sep  1 21:56:37 2014] ::1:57881 [200]: /...[](.html)
- - diff --git a/doc/Create-and-serve-multiple-Shaarlis-(farm).html b/doc/Create-and-serve-multiple-Shaarlis-(farm).html deleted file mode 100644 index 0be81d56..00000000 --- a/doc/Create-and-serve-multiple-Shaarlis-(farm).html +++ /dev/null @@ -1,159 +0,0 @@ - - - - - - - Shaarli – Create and serve multiple Shaarlis (farm) - - - - - - - -

Create and serve multiple Shaarlis (farm)

-

Example bash script (creates multiple shaarli instances and generates an HTML index of them)

-
#!/bin/bash
-set -o errexit
-set -o nounset
-
-#config
-shaarli_base_dir='/var/www/shaarli'
-accounts='bob john whatever username'
-shaarli_repo_url='https://github.com/shaarli/Shaarli'
-ref="master"
-
-#clone multiple shaarli instances
-if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi[](.html)
-   
-for account in $accounts; do
-    if [ -d "$shaarli_base_dir/$account" ];[](.html)
-    then echo "[info] account $account already exists, skipping";[](.html)
-    else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi[](.html)
-done
-
-#generate html index of shaarlis
-htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
-<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
-<html lang="en">
-    <head>
-        <meta http-equiv="content-type" content="text/html; charset=utf-8">
-        <title>My Shaarli farm</title>
-        <style>body {font-family: "Open Sans"}</style>
-    </head>
-    <body>
-    <div>
-    <h1>My Shaarli farm</h1>
-    <ul style="list-style-type: none;">'
-
-accountlinks=''
-    
-htmlfooter='
-    </ul>
-    </div>
-    </body>
-</html>'    
-    
-
-
-for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
-if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi[](.html)
-echo "[info] generating new index of shaarlis"[](.html)
-echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
-echo '[info] done.'[](.html)
-echo "[info] list of accounts: $accounts"[](.html)
-echo "[info] contents of $shaarli_base_dir:"[](.html)
-tree -a -L 1 "$shaarli_base_dir"
-

This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like Ansible

- - diff --git a/doc/Datastore-hacks.html b/doc/Datastore-hacks.html deleted file mode 100644 index ef3e17bb..00000000 --- a/doc/Datastore-hacks.html +++ /dev/null @@ -1,124 +0,0 @@ - - - - - - - Shaarli – Datastore hacks - - - - - - - -

Datastore hacks

-

Decode datastore content

-

To display the array representing the data saved in data/datastore.php, use the following snippet:

-
$data = "tZNdb9MwFIb... <Commented content inside datastore.php>";
-$out = unserialize(gzinflate(base64_decode($data)));
-echo "<pre>"; // Pretty printing is love, pretty printing is life
-print_r($out);
-echo "</pre>";
-exit;
-

This will output the internal representation of the datastore, "unobfuscated" (if this can really be considered obfuscation).

-

Alternatively, you can transform to JSON format (and pretty-print if you have jq installed):

-
php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace("!.*/\* (.+) \*/.*!", "$1", file_get_contents("data/datastore.php")))))));' | jq .
- -
    -
  • Look for <input type="hidden" name="lf_linkdate" value="{$link.linkdate}"> in tpl/editlink.tpl (line 14)
    • -
  • Replace type="hidden" with type="text" from this line
    • -
  • A new date/time field becomes available in the edit/new link dialog.
    • -
  • You can set the timestamp manually by entering it in the format YYYMMDD_HHMMS.
    • -
- - diff --git a/doc/Development.html b/doc/Development.html deleted file mode 100644 index 8a2be413..00000000 --- a/doc/Development.html +++ /dev/null @@ -1,112 +0,0 @@ - - - - - - - Shaarli – Development - - - - - - -

Development

-

Guidelines

-

Please have a look at the following pages:

- -

Continuous integration tools

-

Local development

-

A Makefile is available to perform project-related operations:

-
    -
  • Documentation - generate a local HTML copy of the GitHub wiki
    • -
  • Static analysis - check that the code is compliant to PHP conventions
    • -
  • Unit tests - ensure there are no regressions introduced by new commits
    • -
-

Automatic builds

-

Travis CI is a Continuous Integration build server, that runs a build:

-
    -
  • each time a commit is merged to the mainline (master branch)
    • -
  • each time a Pull Request is submitted or updated
    • -
-

A build is composed of several jobs: one for each supported PHP version (see Server requirements).

-

Each build job:

-
    -
  • updates Composer
    • -
  • installs 3rd-party test dependencies with Composer
    • -
  • runs Unit tests
    • -
-

After all jobs have finished, Travis returns the results to GitHub:

-
    -
  • a status icon represents the result for the master branch: (https://api.travis-ci.org/shaarli/Shaarli.svg)
    • -
  • Pull Requests are updated with the Travis result -
      -
    • Green: all tests have passed
      • -
    • Red: some tests failed
      • -
    • Orange: tests are pending
      • -
    • -
- - diff --git a/doc/Development.md b/doc/Development.md deleted file mode 100644 index 6cfcb683..00000000 --- a/doc/Development.md +++ /dev/null @@ -1,35 +0,0 @@ -#Development -## Guidelines -Please have a look at the following pages: -- [Contributing to Shaarli](https://github.com/shaarli/Shaarli/tree/master/CONTRIBUTING.md)[](.html) -- [Static analysis](Static-analysis.html) - patches should try to stick to the [PHP Standard Recommendations](http://www.php-fig.org/psr/) (PSR), especially: - - [PSR-1](http://www.php-fig.org/psr/psr-1/) - Basic Coding Standard[](.html) - - [PSR-2](http://www.php-fig.org/psr/psr-2/) - Coding Style Guide[](.html) -- [Unit tests](Unit-tests.html) -- [GnuPG signature](GnuPG-signature.html) for tags/releases - -## Continuous integration tools -### Local development -A [`Makefile`](https://github.com/shaarli/Shaarli/blob/master/Makefile) is available to perform project-related operations:[](.html) -- Documentation - generate a local HTML copy of the GitHub wiki -- [Static analysis](Static-analysis.html) - check that the code is compliant to PHP conventions -- [Unit tests](Unit-tests.html) - ensure there are no regressions introduced by new commits - -### Automatic builds -[Travis CI](http://docs.travis-ci.com/) is a Continuous Integration build server, that runs a build:[](.html) -- each time a commit is merged to the mainline (`master` branch) -- each time a Pull Request is submitted or updated - -A build is composed of several jobs: one for each supported PHP version (see [Server requirements](Server-requirements.html)). - -Each build job: -- updates Composer -- installs 3rd-party test dependencies with Composer -- runs [Unit tests](Unit-tests.html) - -After all jobs have finished, Travis returns the results to GitHub: -- a status icon represents the result for the `master` branch: [![(https://api.travis-ci.org/shaarli/Shaarli.svg)](https://travis-ci.org/shaarli/Shaarli)]((https://api.travis-ci.org/shaarli/Shaarli.svg)](https://travis-ci.org/shaarli/Shaarli).html) -- Pull Requests are updated with the Travis result - - Green: all tests have passed - - Red: some tests failed - - Orange: tests are pending diff --git a/doc/Directory-structure.html b/doc/Directory-structure.html deleted file mode 100644 index 3f75db8e..00000000 --- a/doc/Directory-structure.html +++ /dev/null @@ -1,135 +0,0 @@ - - - - - - - Shaarli – Directory structure - - - - - - - -

Directory structure

-

Here is the directory structure of Shaarli and the purpose of the different files:

-
    index.php        # Main program
-    application/     # Shaarli classes
-        ├── LinkDB.php
-        └── Utils.php
-    tests/       # Shaarli unitary & functional tests
-        ├── LinkDBTest.php
-        ├── utils  # utilities to ease testing
-        │   └── ReferenceLinkDB.php
-        └── UtilsTest.php
-    COPYING          # Shaarli license
-    inc/             # static assets and 3rd party libraries
-        ├── awesomplete.*          # tags autocompletion library
-        ├── blazy.*                # picture wall lazy image loading library
-        ├── shaarli.css, reset.css # Shaarli stylesheet.
-        ├── qr.*                   # qr code generation library
-        └──rain.tpl.class.php      # RainTPL templating library
-    tpl/             # RainTPL templates for Shaarli. They are used to build the pages.
-    images/          # Images and icons used in Shaarli
-    data/            # data storage: bookmark database, configuration, logs, banlist…
-        ├── config.php             # Shaarli configuration (login, password, timezone, title…)
-        ├── datastore.php          # Your link database (compressed).
-        ├── ipban.php              # IP address ban system data
-        ├── lastupdatecheck.txt    # Update check timestamp file
-        └──log.txt                 # login/IPban log.
-    cache/           # thumbnails cache
-                     # This directory is automatically created. You can erase it anytime you want.
-    tmp/             # Temporary directory for compiled RainTPL templates.
-                     # This directory is automatically created. You can erase it anytime you want.
- - diff --git a/doc/Docker.html b/doc/Docker.html deleted file mode 100644 index fd0dec4b..00000000 --- a/doc/Docker.html +++ /dev/null @@ -1,245 +0,0 @@ - - - - - - - Shaarli – Docker - - - - - - - -

Docker

- -

Docker usage

-

Basics

-

Install Docker, by following the instructions relevant
-to your OS / distribution, and start the service.

-

Search an image on DockerHub

-
$ docker search debian
-
-NAME            DESCRIPTION                                     STARS   OFFICIAL   AUTOMATED
-ubuntu          Ubuntu is a Debian-based Linux operating s...   2065    [OK][](.html)
-debian          Debian is a Linux distribution that's comp...   603     [OK][](.html)
-google/debian                                                   47                 [OK][](.html)
-

Show available tags for a repository

-
$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool
-
-% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
-Dload  Upload   Total   Spent    Left  Speed
-100  1283    0  1283    0     0    433      0 --:--:--  0:00:02 --:--:--   433
-

Sample output:

-
[[](.html)
-    {
-        "layer": "85a02782",
-        "name": "stretch"
-    },
-    {
-        "layer": "59abecbc",
-        "name": "testing"
-    },
-    {
-        "layer": "bf0fd686",
-        "name": "unstable"
-    },
-    {
-        "layer": "60c52dbe",
-        "name": "wheezy"
-    },
-    {
-        "layer": "c5b806fe",
-        "name": "wheezy-backports"
-    }
-]
-

Pull an image from DockerHub

-
$ docker pull repository[:tag][](.html)
-
-$ docker pull debian:wheezy
-wheezy: Pulling from debian
-4c8cbfd2973e: Pull complete
-60c52dbe9d91: Pull complete
-Digest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe
-Status: Downloaded newer image for debian:wheezy
-

Get and run a Shaarli image

-

DockerHub repository

-

The images can be found in the shaarli/shaarli
-repository.

-

Available image tags

-
    -
  • latest: master branch (tarball release)
    • -
  • stable: stable branch (tarball release)
    • -
  • dev: master branch (Git clone)
    • -
-

All images rely on:

- -

Download from DockerHub

-
$ docker pull shaarli/shaarli
-latest: Pulling from shaarli/shaarli
-32716d9fcddb: Pull complete
-84899d045435: Pull complete
-4b6ad7444763: Pull complete
-e0345ef7a3e0: Pull complete
-5c1dd344094f: Pull complete
-6422305a200b: Pull complete
-7d63f861dbef: Pull complete
-3eb97210645c: Pull complete
-869319d746ff: Already exists
-869319d746ff: Pulling fs layer
-902b87aaaec9: Already exists
-Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
-Status: Downloaded newer image for shaarli/shaarli:latest
-

Create and start a new container from the image

-
# map the host's :8000 port to the container's :80 port
-$ docker create -p 8000:80 shaarli/shaarli
-d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
-
-# launch the container in the background
-$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
-d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
-
-# list active containers
-$ docker ps
-CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
-d40b7af693d6  shaarli/shaarli  /usr/bin/supervisor  15 seconds ago  Up 4 seconds  0.0.0.0:8000->80/tcp  backstabbing_galileo
-

Stop and destroy a container

-
$ docker stop backstabbing_galileo  # those docker guys are really rude to physicists!
-backstabbing_galileo
-
-# check the container is stopped
-$ docker ps
-CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
-
-# list ALL containers
-$ docker ps -a
-CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                      PORTS               NAMES
-d40b7af693d6        shaarli/shaarli     /usr/bin/supervisor   5 minutes ago       Exited (0) 48 seconds ago                       backstabbing_galileo
-
-# destroy the container
-$ docker rm backstabbing_galileo  # let's put an end to these barbarian practices
-backstabbing_galileo
-
-$ docker ps -a
-CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
-

Resources

-

Docker

- -

DockerHub

- -

Service management

- - - diff --git a/doc/Download-CSS-styles-from-an-OPML-list.html b/doc/Download-CSS-styles-from-an-OPML-list.html deleted file mode 100644 index 18cc5d9a..00000000 --- a/doc/Download-CSS-styles-from-an-OPML-list.html +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - Shaarli – Download CSS styles from an OPML list - - - - - - - -

Download CSS styles from an OPML list

-

Download CSS styles for shaarlis listed in an opml file

-

Example php script:

-
<!---- ?php -->
-<!---- Copyright (c) 2014 Nicolas Delsaux (https://github.com/Riduidel) -->
-<!---- License: zlib (http://www.gzip.org/zlib/zlib_license.html) -->
-
-/**
- * Source: https://github.com/Riduidel
- * Download css styles for shaarlis listed in an opml file
- */
-define("SHAARLI_RSS_OPML", "https://www.ecirtam.net/shaarlirss/custom/people.opml");
-
-define("THEMES_TEMP_FOLDER", "new_themes");
-
-if(!file_exists(THEMES_TEMP_FOLDER)) {
-    mkdir(THEMES_TEMP_FOLDER);
-}
-
-function siteUrl($pathInSite) {
-    $indexPos = strpos($pathInSite, "index.php");
-    if(!$indexPos) {
-        return $pathInSite;
-    } else {
-        return substr($pathInSite, 0, $indexPos);
-    }
-}
-
-function createShaarliHashFromOPMLL($opmlFile) {
-    $result = array();
-    $opml = file_get_contents($opmlFile);
-    $opmlXml = simplexml_load_string($opml);
-    $outlineElements = $opmlXml->xpath("body/outline");
-    foreach($outlineElements as $site) {
-        $siteUrl = siteUrl((string) $site['htmlUrl']);[](.html)
-        $result[$siteUrl]=((string) $site['text']);[](.html)
-    }
-    return $result;
-}
-
-function getSiteFolder($url) {
-    $domain = parse_url($url,  PHP_URL_HOST);
-    return THEMES_TEMP_FOLDER."/".str_replace(".", "_", $domain);
-}
-
-function get_http_response_code($theURL) {
-     $headers = get_headers($theURL);
-     return substr($headers[0], 9, 3);[](.html)
-}
-
-/**
- * This makes the code PHP-5 only (particularly the call to "get_headers")
- */
-function copyUserStyleFrom($url, $name, $knownStyles) {
-    $userStyle = $url."inc/user.css";
-    if(in_array($url, $knownStyles)) {
-        // TODO add log message
-    } else {
-        $statusCode = get_http_response_code($userStyle);
-        if(intval($statusCode)<300) {
-            $styleSheet = file_get_contents($userStyle);
-            $siteFolder = getSiteFolder($url);
-            if(!file_exists($siteFolder)) {
-                mkdir($siteFolder);
-            }
-            if(!file_exists($siteFolder.'/user.css')) {
-                // Copy stylesheet
-                file_put_contents($siteFolder.'/user.css', $styleSheet);
-            }
-            if(!file_exists($siteFolder.'/README.md')) {
-                // Then write a readme.md file
-                file_put_contents($siteFolder.'/README.md', 
-                    "User style from ".$name."\n"
-                    ."============================="
-                    ."\n\n"
-                    ."This stylesheet was downloaded from ".$userStyle." on ".date(DATE_RFC822)
-                    );
-            }
-            if(!file_exists($siteFolder.'/config.ini')) {
-                // Write a config file containing useful informations
-                file_put_contents($siteFolder.'/config.ini', 
-                    "site_url=".$url."\n"
-                    ."site_name=".$name."\n"
-                    );
-            }
-            if(!file_exists($siteFolder.'/home.png')) {
-                // And finally copy generated thumbnail
-                $homeThumb = $siteFolder.'/home.png';
-                file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));
-            }
-            echo 'Theme have been downloaded from  <a href="'.$url.'">'.$url.'</a> into '.$siteFolder
-                .'. It looks like <img src="'.$homeThumb.'"><br/>';
-        }
-    }
-}
-
-function getThumbnailUrl($url) {
-    return 'http://api.webthumbnail.org/?url='.$url;
-}
-
-function copyUserStylesFrom($urlToNames, $knownStyles) {
-    foreach($urlToNames as $url => $name) {
-        copyUserStyleFrom($url, $name, $knownStyles);
-    }
-}
-
-/**
- * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/
- * @param directory the directory we want to list files of
- * @return a simple array containing the list of absolute file paths. Notice that current file (".") and parent one("..")
- * are not listed here
- */
-function getDirectoryList ($directory)  {
-    $realPath = realpath($directory);
-    // create an array to hold directory list
-    $results = array();
-    // create a handler for the directory
-    $handler = opendir($directory);
-    // open directory and walk through the filenames
-    while ($file = readdir($handler)) {
-        // if file isn't this directory or its parent, add it to the results
-        if ($file != "." && $file != "..") {
-            $results[ = realpath($realPath . "/" . $file);](-=-realpath($realPath-.-"/"-.-$file);.html)
-        }
-    }
-    // tidy up: close the handler
-    closedir($handler);
-    // done!
-    return $results;
-}
-
-/**
- * Start in themes folder and look in all subfolders for config.ini files. 
- * These config.ini files allow us not to download styles again and again
- */
-function findKnownStyles() {
-    $result = array();
-    $subFolders = getDirectoryList("themes");
-    foreach($subFolders as $folder) {
-        $configFile = $folder."/config.ini";
-        if(file_exists($configFile)) {
-            $iniParameters = parse_ini_file($configFile);
-            array_push($result, $iniParameters['site_url']);[](.html)
-        }
-    }
-    return $result;
-}
-
-$knownStyles = findKnownStyles();
-copyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);
-
-<!--- ? ---->
- - diff --git a/doc/Download-and-Installation.html b/doc/Download-and-Installation.html deleted file mode 100644 index 2c5b3be2..00000000 --- a/doc/Download-and-Installation.html +++ /dev/null @@ -1,172 +0,0 @@ - - - - - - - Shaarli – Download and Installation - - - - - - - -

Download and Installation

-

Get Shaarli!

-

To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your server is properly configured.

-

Several releases are available:

-
- -

Download as an archive

-

Get the latest released version from the releases page.

-

Download our shaarli-full archive to include dependencies.

-

The current latest released version is v0.8.4

-

Or in command lines:

-
$ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip
-$ unzip shaarli-v0.8.4-full.zip
-$ mv Shaarli /path/to/shaarli/
- ---- - - - - - - - - -
!In most cases, download Shaarli from the releases page. Cloning using git or downloading Github branches as zip files requires additional steps (see below).
-

Using git

-
mkdir -p /path/to/shaarli && cd /path/to/shaarli/
-git clone -b v0.8 https://github.com/shaarli/Shaarli.git .
-composer install --no-dev
-
-

Stable version

-

The stable version has been experienced by Shaarli users, and will receive security updates.

-

Download as an archive

-

As a .zip archive:

-
$ wget https://github.com/shaarli/Shaarli/archive/stable.zip
-$ unzip stable.zip
-$ mv Shaarli-stable /path/to/shaarli/
-

As a .tar.gz archive :

-
$ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz
-$ tar xvf stable.tar.gz
-$ mv Shaarli-stable /path/to/shaarli/
-

Clone with Git

-

Composer is required to build a functional Shaarli installation when pulling from git.

-
$ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/
-# install/update third-party dependencies
-$ cd /path/to/shaarli/
-$ composer install --no-dev
-
-

Development version (mainline)

-

Use at your own risk!

-

To get the latest changes from the master branch:

-
# clone the repository  
-$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/
-# install/update third-party dependencies
-$ cd /path/to/shaarli
-$ composer install --no-dev
-
-

Finish Installation

-

Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.

-

install screenshot

-

Setup your Shaarli installation, and it's ready to use!

-
-

Updating Shaarli

-

See Upgrade and Migration

- - diff --git a/doc/Example-patch---add-new-via-field-for-links.html b/doc/Example-patch---add-new-via-field-for-links.html deleted file mode 100644 index 49036a74..00000000 --- a/doc/Example-patch---add-new-via-field-for-links.html +++ /dev/null @@ -1,254 +0,0 @@ - - - - - - - Shaarli – Example patch add new via field for links - - - - - - -

Example patch add new via field for links

-

Example patch to add a new field ("via") for links, an input field to set the "via" property from the "edit link" dialog, and display the "via" field in the link list display. Untested, use at your own risk

-

Thanks to @Knah-Tsaeb in https://github.com/sebsauvage/Shaarli/pull/158

-
From e0f363c18e8fe67990ed2bb1a08652e24e70bbcb Mon Sep 17 00:00:00 2001
-From: Knah Tsaeb <knah-tsaeb@knah-tsaeb.org>
-Date: Fri, 11 Oct 2013 15:18:37 +0200
-Subject: [PATCH] Add a "via"/origin property for links, add new input in "edit link" dialog[](.html)
-Thanks to:
-* https://github.com/Knah-Tsaeb/Shaarli/commit/040eb18ec8cdabd5ea855e108f81f97fbf0478c4
-* https://github.com/Knah-Tsaeb/Shaarli/commit/4123658eae44d7564d1128ce52ddd5689efee813
-* https://github.com/Knah-Tsaeb/Shaarli/commit/f1a8ca9cc8fe49b119d51b2d8382cc1a34542f96
-
----
- index.php         | 43 ++++++++++++++++++++++++++++++++-----------
- tpl/editlink.html |  1 +
- tpl/linklist.html |  1 +
- 3 files changed, 34 insertions(+), 11 deletions(-)
-
-diff --git a/index.php b/index.php
-index 6fae2f8..53f798e 100644
---- a/index.php
-+++ b/index.php
-@@ -436,6 +436,12 @@ if (isset($_POST['login']))[](.html)
- // ------------------------------------------------------------------------------------------
- // Misc utility functions:
- 
-+// Try to get just domain for @via
-+function getJustDomain($url){
-+    $parts = parse_url($url);   
-+    return trim($parts['host']);[](.html)
-+    }
-+
- // Returns the server URL (including port and http/https), without path.
- // e.g. "http://myserver.com:8080"
- // You can append $_SERVER['SCRIPT_NAME'] to get the current script URL.[](.html)
-@@ -799,7 +805,8 @@ class linkdb implements Iterator, Countable, ArrayAccess
-             $found=   (strpos(strtolower($l['title']),$s)!==false)[](.html)
-                    || (strpos(strtolower($l['description']),$s)!==false)[](.html)
-                    || (strpos(strtolower($l['url']),$s)!==false)[](.html)
--                   || (strpos(strtolower($l['tags']),$s)!==false);[](.html)
-+                   || (strpos(strtolower($l['tags']),$s)!==false)[](.html)
-+                   || (!empty($l['via']) && (strpos(strtolower($l['via']),$s)!==false));[](.html)
-             if ($found) $filtered[$l['linkdate'[ = $l;](-=-$l;.html)
-         }
-         krsort($filtered);
-@@ -814,7 +821,7 @@ class linkdb implements Iterator, Countable, ArrayAccess
-         $t = str_replace(',',' ',($casesensitive?$tags:strtolower($tags)));
-         $searchtags=explode(' ',$t);
-         $filtered=array();
--        foreach($this->links as $l)
-+        foreach($this-> links as $l)
-         {
-             $linktags = explode(' ',($casesensitive?$l['tags']:strtolower($l['tags'])));[](.html)
-             if (count(array_intersect($linktags,$searchtags)) == count($searchtags))
-@@ -905,7 +912,7 @@ function showRSS()
-     else $linksToDisplay = $LINKSDB;
-     $nblinksToDisplay = 50;  // Number of links to display.
-     if (!empty($_GET['nb']))  // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links.[](.html)
--    { 
-+    {
-         $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ;[](.html)
-     }
- 
-@@ -944,7 +951,12 @@ function showRSS()
-         // If user wants permalinks first, put the final link in description
-         if ($usepermalinks===true) $descriptionlink = '(<a href="'.$absurl.'">Link</a>)';
-         if (strlen($link['description'])>0) $descriptionlink = '<br>'.$descriptionlink;[](.html)
--        echo '<description><![CDATA['.nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description'])))).$descriptionlink.'[></description>'."\n</item>\n";](></description>'."\n</item>\n";.html)
-+        if(!empty($link['via'])){[](.html)
-+          $via = '<br>Origine => <a href="'.htmlspecialchars($link['via']).'">'.htmlspecialchars(getJustDomain($link['via'])).'</a>';[](.html)
-+        } else {
-+         $via = '';
-+        }
-+        echo '<description><![CDATA['.nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description'])))).$via.$descriptionlink.'[></description>'."\n</item>\n";](></description>'."\n</item>\n";.html)
-         $i++;
-     }
-     echo '</channel></rss><!-- Cached version of '.htmlspecialchars(pageUrl()).' -->';
-@@ -980,7 +992,7 @@ function showATOM()
-     else $linksToDisplay = $LINKSDB;
-     $nblinksToDisplay = 50;  // Number of links to display.
-     if (!empty($_GET['nb']))  // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links.[](.html)
--    { 
-+    {
-         $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ;[](.html)
-     }
- 
-@@ -1006,11 +1018,16 @@ function showATOM()
- 
-         // Add permalink in description
-         $descriptionlink = htmlspecialchars('(<a href="'.$guid.'">Permalink</a>)');
-+        if(isset($link['via']) && !empty($link['via'])){[](.html)
-+          $via = htmlspecialchars('</br> Origine => <a href="'.$link['via'].'">'.getJustDomain($link['via']).'</a>');[](.html)
-+        } else {
-+          $via = '';
-+        }
-         // If user wants permalinks first, put the final link in description
-         if ($usepermalinks===true) $descriptionlink = htmlspecialchars('(<a href="'.$absurl.'">Link</a>)');
-         if (strlen($link['description'])>0) $descriptionlink = '&lt;br&gt;'.$descriptionlink;[](.html)
- 
--        $entries.='<content type="html">'.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink."</content>\n";[](.html)
-+        $entries.='<content type="html">'.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink.$via."</content>\n";[](.html)
-         if ($link['tags']!='') // Adding tags to each ATOM entry (as mentioned in ATOM specification)[](.html)
-         {
-             foreach(explode(' ',$link['tags']) as $tag)[](.html)
-@@ -1478,7 +1495,7 @@ function renderPage()
-         if (!startsWith($url,'http:') && !startsWith($url,'https:') && !startsWith($url,'ftp:') && !startsWith($url,'magnet:') && !startsWith($url,'?'))
-             $url = 'http://'.$url;
-         $link = array('title'=>trim($_POST['lf_title']),'url'=>$url,'description'=>trim($_POST['lf_description']),'private'=>(isset($_POST['lf_private']) ? 1 : 0),[](.html)
--                      'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags));
-+                      'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags), 'via'=>trim($_POST['lf_via']));[](.html)
-         if ($link['title']=='') $link['title']=$link['url']; // If title is empty, use the URL as title.[](.html)
-         $LINKSDB[$linkdate] = $link;[](.html)
-         $LINKSDB->savedb(); // Save to disk.
-@@ -1556,7 +1573,8 @@ function renderPage()
-             $title = (empty($_GET['title']) ? '' : $_GET['title'] ); // Get title if it was provided in URL (by the bookmarklet).[](.html)
-             $description = (empty($_GET['description']) ? '' : $_GET['description']); // Get description if it was provided in URL (by the bookmarklet). [Bronco added that][](.html)
-             $tags = (empty($_GET['tags']) ? '' : $_GET['tags'] ); // Get tags if it was provided in URL[](.html)
--            $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL [](.html)
-+            $via = (empty($_GET['via']) ? '' : $_GET['via'] );[](.html)
-+            $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL[](.html)
-             if (($url!='') && parse_url($url,PHP_URL_SCHEME)=='') $url = 'http://'.$url;
-             // If this is an HTTP link, we try go get the page to extract the title (otherwise we will to straight to the edit form.)
-             if (empty($title) && parse_url($url,PHP_URL_SCHEME)=='http')
-@@ -1567,7 +1585,7 @@ function renderPage()
-                     {
-                         // Look for charset in html header.
-                        preg_match('#<meta .*charset=.*>#Usi', $data, $meta);
-- 
-+
-                        // If found, extract encoding.
-                        if (!empty($meta[0]))[](.html)
-                        {
-@@ -1577,7 +1595,7 @@ function renderPage()
-                            $html_charset = (!empty($enc[1])) ? strtolower($enc[1]) : 'utf-8';[](.html)
-                        }
-                        else { $html_charset = 'utf-8'; }
-- 
-+
-                        // Extract title
-                        $title = html_extract_title($data);
-                        if (!empty($title))
-@@ -1592,7 +1610,7 @@ function renderPage()
-                 $url='?'.smallHash($linkdate);
-                 $title='Note: ';
-             }
--            $link = array('linkdate'=>$linkdate,'title'=>$title,'url'=>$url,'description'=>$description,'tags'=>$tags,'private'=>$private);
-+            $link = array('linkdate'=>$linkdate,'title'=>$title,'url'=>$url,'description'=>$description,'tags'=>$tags,'via' => $via,'private'=>$private);
-         }
- 
-         $PAGE = new pageBuilder;
-@@ -1842,6 +1860,9 @@ function buildLinkList($PAGE,$LINKSDB)
-         $taglist = explode(' ',$link['tags']);[](.html)
-         uasort($taglist, 'strcasecmp');
-         $link['taglist']=$taglist;[](.html)
-+        if(!empty($link['via'])){[](.html)
-+          $link['via']=htmlspecialchars($link['via']);[](.html)
-+        }
-         $linkDisp[$keys[$i[ = $link;](-=-$link;.html)
-         $i++;
-     }
-diff --git a/tpl/editlink.html b/tpl/editlink.html
-index 4a2c30c..14d4f9c 100644
---- a/tpl/editlink.html
-+++ b/tpl/editlink.html
-@@ -16,6 +16,7 @@
-            <i>Title</i><br><input type="text" name="lf_title" value="{$link.title|htmlspecialchars}" style="width:100%"><br>
-            <i>Description</i><br><textarea name="lf_description" rows="4" cols="25" style="width:100%">{$link.description|htmlspecialchars}</textarea><br>
-            <i>Tags</i><br><input type="text" id="lf_tags" name="lf_tags" value="{$link.tags|htmlspecialchars}" style="width:100%"><br>
-+           <i>Origine</i><br><input type="text" name="lf_via" value="{$link.via|htmlspecialchars}" style="width:100%"><br>
-            {if condition="($link_is_new && $GLOBALS['privateLinkByDefault']==true) || $link.private == true"}[](.html)
-             <input type="checkbox" checked="checked" name="lf_private" id="lf_private">
-             &nbsp;<label for="lf_private"><i>Private</i></label><br>
-diff --git a/tpl/linklist.html b/tpl/linklist.html
-index ddc38cb..0a8475f 100644
---- a/tpl/linklist.html
-+++ b/tpl/linklist.html
-@@ -43,6 +43,7 @@
-                 <span class="linktitle"><a href="{$redirector}{$value.url|htmlspecialchars}">{$value.title|htmlspecialchars}</a></span>
-                 <br>
-                 {if="$value.description"}<div class="linkdescription"{if condition="$search_type=='permalink'"} style="max-height:none !important;"{/if}>{$value.description}</div>{/if}
-+                {if condition="isset($value.via) && !empty($value.via)"}<div><a href="{$value.via}">Origine => {$value.via|getJustDomain}</a></div>{/if}
-                 {if="!$GLOBALS['config'['HIDE_TIMESTAMPS'] || isLoggedIn()"}]('HIDE_TIMESTAMPS']-||-isLoggedIn()"}.html)
-                     <span class="linkdate" title="Permalink"><a href="?{$value.linkdate|smallHash}">{$value.localdate|htmlspecialchars} - permalink</a> - </span>
-                 {else}
--- 
-2.1.1
- - diff --git a/doc/FAQ.html b/doc/FAQ.html deleted file mode 100644 index 25584f22..00000000 --- a/doc/FAQ.html +++ /dev/null @@ -1,107 +0,0 @@ - - - - - - - Shaarli – FAQ - - - - - - -

FAQ

-

Why did you create Shaarli ?

-

I was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And… oh… their Firefox addon sends to Diigo every single URL you visit (Don't believe me ? Use Tamper Data and open any page).

-

Enough is enough. Saving simple links should not be a complicated heavy thing. I ditched them all and wrote my own: Shaarli. It's simple, but it does the job and does it well. And my data is not hosted on a foreign server, but on my server.

-

Why use Shaarli and not Delicious/Diigo ?

-

With Shaarli:

-
    -
  • The data is yours: It's hosted on your server.
    • -
  • Never fear of having your data locked-in.
    • -
  • Never fear to have your data sold to third party.
    • -
  • Your private links are not hosted on a third party server.
    • -
  • You are not tracked by browser addons (like Diigo does)
    • -
  • You can change the look and feel of the pages if you want.
    • -
  • You can change the behaviour of the program.
    • -
  • It's magnitude faster than most bookmarking services.
    • -
-

What does Shaarli mean?

-

Shaarli is for shaaring your links.

-

My Shaarli is broken!

-

First of all, ensure that both the web server and Shaarli are correctly configured, and that your installation is supported.

-

If everything looks right but the issue(s) remain(s), please:

-
    -
  • take a look at the troubleshooting section
    • -
  • come chat with us on Gitter, we'll be happy to help ;-)
    • -
  • browse active issues and Pull Requests -
      -
    • if you find one that is related to the issue, feel free to comment and provide additional details (host/Shaarli setup)
      • -
    • else, open a new issue, and provide information about the problem: -
        -
      • what happens? - display glitches, invalid data, security flaws...
        • -
      • what is your configuration? - OS, server version, activated extensions, web browser...
        • -
      • is it reproducible?
        • -
      • -
    • -
-

Why not use a real database? Files are slow!

-

Does browsing this page feel slow? Try browsing older pages, too.

-

It's not slow at all, is it? And don't forget the database contains more than 16000 links, and it's on a shared host, with 32000 visitors/day for my website alone. And it's still damn fast. Why?

-

The data file is only 3.7 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.

- - diff --git a/doc/Firefox-share.html b/doc/Firefox-share.html deleted file mode 100644 index 707119a6..00000000 --- a/doc/Firefox-share.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - - - - Shaarli – Firefox share - - - - - - -

Firefox share

-

Add Shaarli as a sharing service to Firefox

-
    -
  • Open your Shaarli and Login
    • -
  • Click the Tools button in the top bar
    • -
  • Click the ✚Add to Firefox social button and accept the activation.
    • -
- -
    -
  • Add the sharing service as described above
    • -
  • When you are visiting a webpage you would like to share with Shaarli, click the Firefox Share button images/firefoxshare.png
    • -
  • You can edit your link before and after saving, just like the bookmarklet above.
    • -
- ---- - - - - - - - - -
Your Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections.
- - diff --git a/doc/GnuPG-signature.html b/doc/GnuPG-signature.html deleted file mode 100644 index 182a71d4..00000000 --- a/doc/GnuPG-signature.html +++ /dev/null @@ -1,175 +0,0 @@ - - - - - - - Shaarli – GnuPG signature - - - - - - - -

GnuPG signature

-

Introduction

-

PGP and GPG

-

Gnu Privacy Guard (GnuPG) is an Open Source implementation of the Pretty Good [](.html)
-Privacy (OpenPGP) specification. Its main purposes are digital authentication,
-signature and encryption.

-

It is often used by the FLOSS community to verify:

- -

Trust

-

To quote Phil Pennock (the author of the SKS key server - http://sks.spodhuis.org/):

-
-

You MUST understand that presence of data in the keyserver (pools) in no way connotes trust. Anyone can generate a key, with any name or email address, and upload it. All security and trust comes from evaluating security at the “object level”, via PGP Web-Of-Trust signatures. This keyserver makes it possible to retrieve keys, looking them up via various indices, but the collection of keys in this public pool is KNOWN to contain malicious and fraudulent keys. It is the common expectation of server operators that users understand this and use software which, like all known common OpenPGP implementations, evaluates trust accordingly. This expectation is so common that it is not normally explicitly stated.

-
-

Trust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during key signing parties, see:

- -

Generate a GPG key

- -

gpg - provide identity information

-
$ gpg --gen-key
-
-gpg (GnuPG) 2.1.6; Copyright (C) 2015 Free Software Foundation, Inc.
-This is free software: you are free to change and redistribute it.
-There is NO WARRANTY, to the extent permitted by law.
-
-Note: Use "gpg2 --full-gen-key" for a full featured key generation dialog.
-
-GnuPG needs to construct a user ID to identify your key.
-
-Real name: Marvin the Paranoid Android
-Email address: marvin@h2g2.net
-You selected this USER-ID:
-    "Marvin the Paranoid Android <marvin@h2g2.net>"
-
-Change (N)ame, (E)mail, or (O)kay/(Q)uit? o
-We need to generate a lot of random bytes. It is a good idea to perform
-some other action (type on the keyboard, move the mouse, utilize the
-disks) during the prime generation; this gives the random number
-generator a better chance to gain enough entropy.
-

gpg - entropy interlude

-

At this point, you will:

-
    -
  • be prompted for a secure password to protect your key (the input method will depend on your Desktop Environment and configuration)
    • -
  • be asked to use your machine's input devices (mouse, keyboard, etc.) to generate random entropy; this step may take some time
    • -
-

gpg - key creation confirmation

-
gpg: key A9D53A3E marked as ultimately trusted
-public and secret key created and signed.
-
-gpg: checking the trustdb
-gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model
-gpg: depth: 0  valid:   2  signed:   0  trust: 0-, 0q, 0n, 0m, 0f, 2u
-pub   rsa2048/A9D53A3E 2015-07-31
-      Key fingerprint = AF2A 5381 E54B 2FD2 14C4  A9A3 0E35 ACA4 A9D5 3A3E
-uid       [ultimate] Marvin the Paranoid Android <marvin@h2g2.net>[](.html)
-sub   rsa2048/8C0EACF1 2015-07-31
-

gpg - submit your public key to a PGP server (Optional)

-
$ gpg --keyserver pgp.mit.edu --send-keys A9D53A3E
-gpg: sending key A9D53A3E to hkp server pgp.mit.edu
-

Create and push a GPG-signed tag

-

See Release Shaarli.

- - diff --git a/doc/Home.html b/doc/Home.html deleted file mode 100644 index 7f51b93b..00000000 --- a/doc/Home.html +++ /dev/null @@ -1,76 +0,0 @@ - - - - - - - Shaarli – Home - - - - - - -

Home

-

Shaarli wiki

-

Welcome to the Shaarli wiki

-

Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli.

-

For general info, read the README.

-

If you have any questions or ideas, please join the chat (also reachable via IRC), post them in our general discussion (archive) or read the current issues. If you've found a bug, please create a new issue.

-

If you would like a feature added to Shaarli, check the issues labeled feature, enhancement, and plugin.

-

Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the doc/ directory of your Shaarli installation.

- - diff --git a/doc/Plugin-System.html b/doc/Plugin-System.html deleted file mode 100644 index 123bf106..00000000 --- a/doc/Plugin-System.html +++ /dev/null @@ -1,634 +0,0 @@ - - - - - - - Shaarli – Plugin System - - - - - - - -

Plugin System

-

I am a developer. Developer API.

-

I am a template designer. Guide for template designer.

-

Developer API

-

What can I do with plugins?

-

The plugin system let you:

-
    -
  • insert content into specific places across templates.
    • -
  • alter data before templates rendering.
    • -
  • alter data before saving new links.
    • -
-

How can I create a plugin for Shaarli?

-

First, chose a plugin name, such as demo_plugin.

-

Under plugin folder, create a folder named with your plugin name. Then create a .php file in that folder.

-

You should have the following tree view:

-
| index.php
-| plugins/
-|---| demo_plugin/
-|   |---| demo_plugin.php
-

Plugin initialization

-

At the beginning of Shaarli execution, all enabled plugins are loaded. At this point, the plugin system looks for an init() function to execute and run it if it exists. This function must be named this way, and takes the ConfigManager as parameter.

-
<plugin_name>_init($conf)
-

This function can be used to create initial data, load default settings, etc. But also to set plugin errors. If the initialization function returns an array of strings, they will be understand as errors, and displayed in the header to logged in users.

-

Understanding hooks

-

A plugin is a set of functions. Each function will be triggered by the plugin system at certain point in Shaarli execution.

-

These functions need to be named with this pattern:

-
hook_<plugin_name>_<hook_name>($data, $conf)
-

Parameters:

- -

For exemple, if my plugin want to add data to the header, this function is needed:

-
hook_demo_plugin_render_header
-

If this function is declared, and the plugin enabled, it will be called every time Shaarli is rendering the header.

-

Plugin's data

-

Parameters

-

Every hook function has a $data parameter. Its content differs for each hooks.

-

This parameter needs to be returned every time, otherwise data is lost.

-
return $data;
-

Filling templates placeholder

-

Template placeholders are displayed in template in specific places.

-

RainTPL displays every element contained in the placeholder's array. These element can be added by plugins.

-

For example, let's add a value in the placeholder top_placeholder which is displayed at the top of my page:

-
$data['top_placeholder'[] = 'My content';](]-=-'My-content';.html)
-# OR
-array_push($data['top_placeholder'], 'My', 'content');[](.html)
-
-return $data;
-

Data manipulation

-

When a page is displayed, every variable send to the template engine is passed to plugins before that in $data.

-

The data contained by this array can be altered before template rendering.

-

For exemple, in linklist, it is possible to alter every title:

-
// mind the reference if you want $data to be altered
-foreach ($data['links'] as &$value) {[](.html)
-    // String reverse every title.
-    $value['title'] = strrev($value['title']);[](.html)
-}
-
-return $data;
-

Metadata

-

Every plugin needs a <plugin_name>.meta file, which is in fact an .ini file (KEY="VALUE"), to be listed in plugin administration.

-

Each file contain two keys:

-
    -
  • description: plugin description
    • -
  • parameters: user parameter names, separated by a ;.
    • -
  • parameter.<PARAMETER_NAME>: add a text description the specified parameter.
    • -
-
-

Note: In PHP, parse_ini_file() seems to want strings to be between by quotes " in the ini file.

-
-

It's not working!

-

Use demo_plugin as a functional example. It covers most of the plugin system features.

-

If it's still not working, please open an issue.

-

Hooks

- ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
HooksDescription
render_headerAllow plugin to add content in page headers.
render_includesAllow plugin to include their own CSS files.
render_footerAllow plugin to add content in page footer and include their own JS files.
render_linklistIt allows to add content at the begining and end of the page, after every link displayed and to alter link data.
render_editlinkAllow to add fields in the form, or display elements.
render_toolsAllow to add content at the end of the page.
render_picwallAllow to add content at the top and bottom of the page.
render_tagcloudAllow to add content at the top and bottom of the page, and after all tags.
render_taglistAllow to add content at the top and bottom of the page, and after all tags.
render_dailyAllow to add content at the top and bottom of the page, the bottom of each link and to alter data.
render_feedAllow to do add tags in RSS and ATOM feeds.
save_linkAllow to alter the link being saved in the datastore.
delete_linkAllow to do an action before a link is deleted from the datastore.
-

render_header

-

Triggered on every page.

-

Allow plugin to add content in page headers.

-
Data
-

$data is an array containing:

-
    -
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • buttons_toolbar: after the list of buttons in the header.
    • -
-

buttons_toolbar_example

-
    -
  • fields_toolbar: after search fields in the header.
    • -
-
-

Note: This will only be called in linklist.

-
-

fields_toolbar_example

-

render_includes

-

Triggered on every page.

-

Allow plugin to include their own CSS files.

-
Data
-

$data is an array containing:

-
    -
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • css_files: called after loading default CSS.
    • -
-
-

Note: only add the path of the CSS file. E.g: plugins/demo_plugin/custom_demo.css.

-
- -

Triggered on every page.

-

Allow plugin to add content in page footer and include their own JS files.

-
Data
-

$data is an array containing:

-
    -
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • text: called after the end of the footer text.
    • -
  • endofpage: called at the end of the page.
    • -
-

text_example

-
    -
  • js_files: called at the end of the page, to include custom JS scripts.
    • -
-
-

Note: only add the path of the JS file. E.g: plugins/demo_plugin/custom_demo.js.

-
- -

Triggered when linklist is displayed (list of links, permalink, search, tag filtered, etc.).

-

It allows to add content at the begining and end of the page, after every link displayed and to alter link data.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • All templates data, including links.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • action_plugin: next to the button "private only" at the top and bottom of the page.
    • -
-

action_plugin_example

-
    -
  • link_plugin: for every link, between permalink and link URL.
    • -
-

link_plugin_example

-
    -
  • plugin_start_zone: before displaying the template content.
    • -
-

plugin_start_zone_example

-
    -
  • plugin_end_zone: after displaying the template content.
    • -
-

plugin_end_zone_example

- -

Triggered when the link edition form is displayed.

-

Allow to add fields in the form, or display elements.

-
Data
-

$data is an array containing:

-
    -
  • All templates data.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • edit_link_plugin: after tags field.
    • -
-

edit_link_plugin_example

-

render_tools

-

Triggered when the "tools" page is displayed.

-

Allow to add content at the end of the page.

-
Data
-

$data is an array containing:

-
    -
  • All templates data.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • tools_plugin: at the end of the page.
    • -
-

tools_plugin_example

-

render_picwall

-

Triggered when picwall is displayed.

-

Allow to add content at the top and bottom of the page.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • All templates data.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -

  • plugin_start_zone: before displaying the template content.

    • -

  • plugin_end_zone: after displaying the template content.

    • -
-

plugin_start_end_zone_example

-

render_tagcloud

-

Triggered when tagcloud is displayed.

-

Allow to add content at the top and bottom of the page.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • All templates data.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -

  • plugin_start_zone: before displaying the template content.

    • -

  • plugin_end_zone: after displaying the template content.

    • -
-

For each tag, the following placeholder can be used:

-
    -
  • tag_plugin: after each tag
    • -
-

plugin_start_end_zone_example

-

render_taglist

-

Triggered when taglist is displayed.

-

Allow to add content at the top and bottom of the page.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • All templates data.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -

  • plugin_start_zone: before displaying the template content.

    • -

  • plugin_end_zone: after displaying the template content.

    • -
-

For each tag, the following placeholder can be used:

-
    -
  • tag_plugin: after each tag
    • -
-

render_daily

-

Triggered when tagcloud is displayed.

-

Allow to add content at the top and bottom of the page, the bottom of each link and to alter data.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • All templates data, including links.
    • -
-
Template placeholders
-

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • link_plugin: used at bottom of each link.
    • -
-

link_plugin_example

-
    -

  • plugin_start_zone: before displaying the template content.

    • -

  • plugin_end_zone: after displaying the template content.

    • -
-

render_feed

-

Triggered when the ATOM or RSS feed is displayed.

-

Allow to add tags in the feed, either in the header or for each items. Items (links) can also be altered before being rendered.

-
Data
-

$data is an array containing:

-
    -
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • -
  • _PAGE_: containing either rss or atom.
    • -
  • All templates data, including links.
    • -
-
Template placeholders
-

Tags can be added in feeds by adding an entry in $data['<placeholder>'] array.

-

List of placeholders:

-
    -
  • feed_plugins_header: used as a header tag in the feed.
    • -
-

For each links:

-
    -
  • feed_plugins: additional tag for every link entry.
    • -
- -

Triggered when a link is save (new link or edit).

-

Allow to alter the link being saved in the datastore.

-
Data
-

$data is an array containing the link being saved:

-
    -
  • id
    • -
  • title
    • -
  • url
    • -
  • shorturl
    • -
  • description
    • -
  • private
    • -
  • tags
    • -
  • created
    • -
  • updated
    • -
- -

Triggered when a link is deleted.

-

Allow to execute any action before the link is actually removed from the datastore

-
Data
-

$data is an array containing the link being saved:

-
    -
  • id
    • -
  • title
    • -
  • url
    • -
  • shorturl
    • -
  • description
    • -
  • private
    • -
  • tags
    • -
  • created
    • -
  • updated
    • -
-

Guide for template designer

-

Plugin administration

-

Your theme must include a plugin administration page: pluginsadmin.html.

-
-

Note: repo's template link needs to be added when the PR is merged.

-
-

Use the default one as an example.

-

Aside from classic RainTPL loops, plugins order is handle by JavaScript. You can just include plugin_admin.js, only if:

-
    -
  • you're using a table.
    • -
  • you call orderUp() and orderUp() onclick on arrows.
    • -
  • you add data-line and data-order to your rows.
    • -
-

Otherwise, you can use your own JS as long as this field is send by the form:

-

-

Placeholder system

-

In order to make plugins work with every custom themes, you need to add variable placeholder in your templates.

-

It's a RainTPL loop like this:

-
{loop="$plugin_variable"}
-    {$value}
-{/loop}
-

You should enable demo_plugin for testing purpose, since it uses every placeholder available.

-

List of placeholders

-

page.header.html

-

At the end of the menu:

-
{loop="$plugins_header.buttons_toolbar"}
-    {$value}
-{/loop}
-

At the end of file, before clearing floating blocks:

-
{if="!empty($plugin_errors) && isLoggedIn()"}
-    <ul class="errors">
-        {loop="plugin_errors"}
-            <li>{$value}</li>
-        {/loop}
-    </ul>
-{/if}
-

includes.html

-

At the end of the file:

-
{loop="$plugins_includes.css_files"}
-<link type="text/css" rel="stylesheet" href="{$value}#"/>
-{/loop}
-

page.footer.html

-

At the end of your footer notes:

-
{loop="$plugins_footer.text"}
-     {$value}
-{/loop}
-

At the end of file:

-
{loop="$plugins_footer.js_files"}
-     <script src="{$value}#"></script>
-{/loop}
-

linklist.html

-

After search fields:

-
{loop="$plugins_header.fields_toolbar"}
-     {$value}
-{/loop}
-

Before displaying the link list (after paging):

-
{loop="$plugin_start_zone"}
-     {$value}
-{/loop}
-

For every links (icons):

-
{loop="$value.link_plugin"}
-    <span>{$value}</span>
-{/loop}
-

Before end paging:

-
{loop="$plugin_end_zone"}
-     {$value}
-{/loop}
-

linklist.paging.html

-

After the "private only" icon:

-
{loop="$action_plugin"}
-     {$value}
-{/loop}
-

editlink.html

-

After tags field:

-
{loop="$edit_link_plugin"}
-     {$value}
-{/loop}
-

tools.html

-

After the last tool:

-
{loop="$tools_plugin"}
-     {$value}
-{/loop}
-

picwall.html

-

Top:

-
<div id="plugin_zone_start_picwall" class="plugin_zone">
-    {loop="$plugin_start_zone"}
-        {$value}
-    {/loop}
-</div>
-

Bottom:

-
<div id="plugin_zone_end_picwall" class="plugin_zone">
-    {loop="$plugin_end_zone"}
-        {$value}
-    {/loop}
-</div>
-

tagcloud.html

-

Top:

-
   <div id="plugin_zone_start_tagcloud" class="plugin_zone">
-        {loop="$plugin_start_zone"}
-            {$value}
-        {/loop}
-    </div>
-

Bottom:

-
    <div id="plugin_zone_end_tagcloud" class="plugin_zone">
-        {loop="$plugin_end_zone"}
-            {$value}
-        {/loop}
-    </div>
-

daily.html

-

Top:

-
<div id="plugin_zone_start_picwall" class="plugin_zone">
-     {loop="$plugin_start_zone"}
-         {$value}
-     {/loop}
-</div>
-

After every link:

-
<div class="dailyEntryFooter">
-     {loop="$link.link_plugin"}
-          {$value}
-     {/loop}
-</div>
-

Bottom:

-
<div id="plugin_zone_end_picwall" class="plugin_zone">
-    {loop="$plugin_end_zone"}
-        {$value}
-    {/loop}
-</div>
-

feed.atom.xml and feed.rss.xml:

-

In headers tags section:

-
{loop="$feed_plugins_header"}
-  {$value}
-{/loop}
-

After each entry:

-
{loop="$value.feed_plugins"}
-  {$value}
-{/loop}
- - diff --git a/doc/Plugins.html b/doc/Plugins.html deleted file mode 100644 index 08ce8a86..00000000 --- a/doc/Plugins.html +++ /dev/null @@ -1,155 +0,0 @@ - - - - - - - Shaarli – Plugins - - - - - - - -

Plugins

-

Plugin installation

-

There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.

-

If you want to install a third party plugin:

-
    -
  • Download it.
    • -
  • Put it in the plugins directory in Shaarli's installation folder.
    • -
  • Make sure you put it correctly:
    • -
-
| index.php
-| plugins/
-|---| custom_plugin/
-|   |---| custom_plugin.php
-|   |---| ...
-
-
    -
  • Make sure your webserver can read and write the files in your plugin folder.
    • -
-

Plugin configuration

-

In Shaarli's administration page (Tools link), go to Plugin administration.

-

Here you can enable and disable all plugins available, and configure them.

-

administration screenshot

-

Plugin order

-

In the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first.

-

This is important in case plugins are depending on each other. Read plugins README details for more information.

-

Use case: The (non existent) plugin shaares_footer adds a footer to every shaare in Markdown syntax. It needs to be processed before (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.

-

File mode

-

Enabled plugin are stored in your config.php parameters file, under the array:

-
$GLOBALS['config'['ENABLED_PLUGINS']]('ENABLED_PLUGINS'].html)
-

You can edit them manually here.
-Example:

-
$GLOBALS['config'['ENABLED_PLUGINS'] = array(]('ENABLED_PLUGINS']-=-array(.html)
-    'qrcode', 
-    'archiveorg',
-    'wallabag',
-    'markdown',
-);
-

Plugin usage

-

Official plugins

-

Usage of each plugin is documented in it's README file:

-
    -
  • addlink-toolbar: Adds the addlink input on the linklist page
    • -
  • archiveorg: For each link, add an Archive.org icon
    • -
  • markdown: Render shaare description with Markdown syntax.
    • -
  • playvideos: Add a button in the toolbar allowing to watch all videos.
    • -
  • qrcode: For each link, add a QRCode icon.
    • -
  • wallabag: For each link, add a Wallabag icon to save it in your instance.
    • -
-

Third party plugins

-

See Community & related software

- - diff --git a/doc/REST-API.html b/doc/REST-API.html deleted file mode 100644 index d14c98c9..00000000 --- a/doc/REST-API.html +++ /dev/null @@ -1,169 +0,0 @@ - - - - - - - Shaarli – REST API - - - - - - - -

REST API

-

Usage

-

See the REST API documentation.

-

Authentication

-

All requests to Shaarli's API must include a JWT token to verify their authenticity.

-

This token has to be included as an HTTP header called Authentication: Bearer <jwt token>.

-

JWT resources :

- -

Shaarli JWT Token

-

JWT tokens are composed by three parts, separated by a dot . and encoded in base64:

-
[header].[payload].[signature][](.html)
- -

Shaarli only allow one hash algorithm, so the header will always be the same:

-
{
-    "typ": "JWT",
-    "alg": "HS512"
-}
-

Encoded in base64, it gives:

-
ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==
-

Payload

-

Validity duration

-

To avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key iat (issued at). This token will be accepted during 9 minutes.

-
{
-    "iat": 1468663519
-}
-

See RFC reference.

-

Signature

-

The signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot ., hashed in SHA512 with the API secret available in Shaarli administration page.

-

Signature example with PHP:

-
$content = base64_encode($header) . '.' . base64_encode($payload);
-$signature = hash_hmac('sha512', $content, $secret);
-

Complete example

-

PHP

-
function generateToken($secret) {
-    $header = base64_encode('{
-        "typ": "JWT",
-        "alg": "HS512"
-    }');
-    $payload = base64_encode('{
-        "iat": '. time() .'
-    }');
-    $signature = hash_hmac('sha512', $header .'.'. $payload , $secret);
-    return $header .'.'. $payload .'.'. $signature;
-}
-
-$secret = 'mysecret';
-$token = generateToken($secret);
-echo $token;
-
-

ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68

-
-
$options = [[](.html)
-    'http' => [[](.html)
-        'method' => 'GET',
-        'jwt' => $token,
-    ],
-];
-$context = stream_context_create($options);
-file_get_contents($apiEndpoint, false, $context);
- - diff --git a/doc/RSS-feeds.html b/doc/RSS-feeds.html deleted file mode 100644 index 0ebfecc6..00000000 --- a/doc/RSS-feeds.html +++ /dev/null @@ -1,99 +0,0 @@ - - - - - - - Shaarli – RSS feeds - - - - - - -

RSS feeds

-

Feeds options

-

Feeds are available in ATOM with ?do=atom and RSS with do=RSS.

-

Options:

-
    -
  • You can use permalinks in the feed URL to get permalink to Shaares instead of direct link to shaared URL. -
      -
    • E.G. https://my.shaarli.domain/?do=atom&permalinks.
      • -
    • -
  • You can use nb parameter in the feed URL to specify the number of Shaares you want in a feed (default if not specified: 50). The keyword all is available if you want everything. -
      -
    • https://my.shaarli.domain/?do=atom&permalinks&nb=42
      • -
    • https://my.shaarli.domain/?do=atom&permalinks&nb=all
      • -
    • -
-

RSS Feeds or Picture Wall for a specific search/tag

-

It is possible to filter RSS/ATOM feeds and Picture Wall on a Shaarli to only display results of a specific search, or for a specific tag.

-

For example, if you want to subscribe only to links tagged photography:

-
    -
  • Go to the desired Shaarli instance.
    • -
  • Search for the photography tag in the Filter by tag box. Links tagged photography are displayed.
    • -
  • Click on the RSS Feed button.
    • -
  • You are presented with an RSS feed showing only these links. Subscribe to it to receive only updates with this tag.
    • -
  • The same method also works for a full-text search (Search box) and for the Picture Wall (want to only see pictures about nature?)
    • -
  • You can also build the URLs manually: -
      -
    • https://my.shaarli.domain/?do=rss&searchtags=nature
      • -
    • https://my.shaarli.domain/links/?do=picwall&searchterm=poney
      • -
    • -
-

(images/rss-filter-2.png)

- - diff --git a/doc/Release-Shaarli.html b/doc/Release-Shaarli.html deleted file mode 100644 index fa690c7c..00000000 --- a/doc/Release-Shaarli.html +++ /dev/null @@ -1,224 +0,0 @@ - - - - - - - Shaarli – Release Shaarli - - - - - - - -

Release Shaarli

-

See Git - Maintaining a project - Tagging your [](.html)
-releases.

-

Prerequisites

-

This guide assumes that you have:

-
    -
  • a GPG key matching your GitHub authentication credentials -
      -
    • i.e., the email address identified by the GPG key is the same as the one in your ~/.gitconfig
      • -
    • -
  • a GitHub fork of Shaarli
    • -
  • a local clone of your Shaarli fork, with the following remotes: -
      -
    • origin pointing to your GitHub fork
      • -
    • upstream pointing to the main Shaarli repository
      • -
    • -
  • maintainer permissions on the main Shaarli repository, to: -
      -
    • push the signed tag
      • -
    • create a new release
      • -
    • -
  • Composer and Pandoc need to be installed
    • -
-

GitHub release draft and CHANGELOG.md

-

See http://keepachangelog.com/en/0.3.0/ for changelog formatting.

-

GitHub release draft

-

GitHub allows drafting the release note for the upcoming release, from the Releases page. This way, the release note can be drafted while contributions are merged to master.

-

CHANGELOG.md

-

This file should contain the same information as the release note draft for the upcoming version.

-

Update it to:

-
    -
  • add new entries (additions, fixes, etc.)
    • -
  • mark the current version as released by setting its date and link
    • -
  • add a new section for the future unreleased version
    • -
-
$ cd /path/to/shaarli
-
-$ nano CHANGELOG.md
-
-[...][](.html)
-## vA.B.C - UNRELEASED
-TBA
-
-## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD[](.html)
-[...][](.html)
-

Increment the version code, create and push a signed tag

-

Bump Shaarli's version

-
$ cd /path/to/shaarli
-
-# create a new branch
-$ git fetch upstream
-$ git checkout upstream/master -b v0.5.0
-
-# bump the version number
-$ vim index.php shaarli_version.php
-
-# rebuild the documentation from the wiki
-$ make htmldoc
-
-# commit the changes
-$ git add index.php shaarli_version.php doc
-$ git commit -s -m "Bump version to v0.5.0"
-
-# push the commit on your GitHub fork
-$ git push origin v0.5.0
-

Create and merge a Pull Request

-

This one is pretty straightforward ;-)

-

Create and push a signed tag

-
# update your local copy
-$ git checkout master
-$ git fetch upstream
-$ git pull upstream master
-
-# create a signed tag
-$ git tag -s -m "Release v0.5.0" v0.5.0
-
-# push it to "upstream"
-$ git push --tags upstream
-

Verify a signed tag

-

v0.5.0 is the first GPG-signed tag pushed on the Community Shaarli.

-

Let's have a look at its signature!

-
$ cd /path/to/shaarli
-$ git fetch upstream
-
-# get the SHA1 reference of the tag
-$ git show-ref tags/v0.5.0
-f7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0
-
-# verify the tag signature information
-$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1
-gpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F
-gpg: Good signature from "VirtualTam <virtualtam@flibidi.net>" [ultimate][](.html)
-

Publish the GitHub release

-

Update release badges

-

Update README.md so version badges display and point to the newly released Shaarli version(s).

-

Create a GitHub release from a Git tag

-

From the previously drafted release:

-
    -
  • edit the release notes (if needed)
    • -
  • specify the appropriate Git tag
    • -
  • publish the release
    • -
  • profit!
    • -
-

Generate and upload all-in-one release archives

-

Users with a shared hosting may have:

-
    -
  • no SSH access
    • -
  • no possibility to install PHP packages or server extensions
    • -
  • no possibility to run scripts
    • -
-

To ease Shaarli installations, it is possible to generate and upload additional release archives,
-that will contain Shaarli code plus all required third-party libraries:

-
$ make release_archive
-

This will create the following archives:

-
    -
  • shaarli-vX.Y.Z-full.tar
    • -
  • shaarli-vX.Y.Z-full.zip
    • -
-

The archives need to be manually uploaded on the previously created GitHub release.

- - diff --git a/doc/Security.html b/doc/Security.html deleted file mode 100644 index 12b46fa9..00000000 --- a/doc/Security.html +++ /dev/null @@ -1,135 +0,0 @@ - - - - - - - Shaarli – Security - - - - - - - -

Security

-

Client browser

-
    -
  • Shaarli relies on HTTP_REFERER for some functions (like redirects and clicking on tags). If you have disabled or masqueraded HTTP_REFERER in your browser, some features of Shaarli may not work
    • -
-

PHP

-
    -
  • magic_quotes is an horrible option of PHP which is often activated on servers. No serious developer should rely on this horror to secure their code against SQL injections. You should disable it (and Shaarli expects this option to be disabled). Nevertheless, I have added code to cope with magic_quotes on, so you should not be bothered even on crappy hosts.
    • -
-

Server and sessions

-
    -
  • Directories are protected using .htaccess files
    • -
  • Forms are protected against XSRF (Cross-site requests forgery):
    • -
  • Forms which act on data (save,delete…) contain a token generated by the server.
    • -
  • Any posted form which does not contain a valid token is rejected.
    • -
  • Any token can only be used once.
    • -
  • Tokens are attached to the session and cannot be reused in another session.
    • -
  • Sessions automatically expire after 60 minutes.
    • -
  • Sessions are protected against hijacking: the session ID cannot be used from a different IP address.
    • -
-

Shaarli datastore and configuration

-
    -
  • The password is salted, hashed and stored in the data subdirectory, in a PHP file, and protected by htaccess. Even if the webserver does not support htaccess, the hash is not readable by URL. Even if the .php file is stolen, the password cannot deduced from the hash. The salt prevents rainbow-tables attacks.
    • -
  • Links are stored as an associative array which is serialized, compressed (with deflate), base64-encoded and saved as a comment in a .php file.
    • -
  • Even if the server does not support .htaccess files, the data file will still not be readable by URL.
    • -

  • The database looks like this:

    -
    <?php /* zP1ZjxxJtiYIvvevEPJ2lDOaLrZv7o...
-...ka7gaco/Z+TFXM2i7BlfMf8qxpaSSYfKlvqv/x8= */ ?>
    • -

  • Small hashes are used to make a link to an entry in Shaarli. They are unique. In fact, the date of the items (eg. 20110923_150523) is hashed with CRC32, then converted to base64 and some characters are replaced. They are always 6 characters longs and use only A-Z a-z 0-9 - _ and @.

    • -
- - diff --git a/doc/Server-configuration.html b/doc/Server-configuration.html deleted file mode 100644 index 0e6b220a..00000000 --- a/doc/Server-configuration.html +++ /dev/null @@ -1,459 +0,0 @@ - - - - - - - Shaarli – Server configuration - - - - - - - -

Server configuration

-

Example virtual host configurations for popular web servers

- -

Prerequisites

-

Shaarli

-
    -
  • Shaarli is installed in a directory readable/writeable by the user
    • -
  • the correct read/write permissions have been granted to the web server user and/or group
    • -
  • for HTTPS / SSL:
    • -
  • a key pair (public, private) and a certificate have been generated
    • -
  • the appropriate server SSL extension is installed and active
    • -
-

HTTPS, TLS and self-signed certificates

-

Related guides:

- -

Proxies

-

If Shaarli is served behind a proxy (i.e. there is a proxy server between clients and the web server hosting Shaarli), please refer to the proxy server documentation for proper configuration. In particular, you have to ensure that the following server variables are properly set:

-
    -
  • X-Forwarded-Proto;
    • -
  • X-Forwarded-Host;
    • -
  • X-Forwarded-For.
    • -
-

See also proxy-related issues.

-

Apache

-

Minimal

-
<VirtualHost *:80>
-    ServerName   shaarli.my-domain.org
-    DocumentRoot /absolute/path/to/shaarli/
-</VirtualHost>
-

Debug - Log all the things!

-

This configuration will log both Apache and PHP errors, which may prove useful to identify server configuration errors.

-

See:

- -
<VirtualHost *:80>
-    ServerName   shaarli.my-domain.org
-    DocumentRoot /absolute/path/to/shaarli/
-
-    LogLevel  warn
-    ErrorLog  /var/log/apache2/shaarli-error.log
-    CustomLog /var/log/apache2/shaarli-access.log combined
-
-    php_flag  log_errors on
-    php_flag  display_errors on
-    php_value error_reporting 2147483647
-    php_value error_log /var/log/apache2/shaarli-php-error.log
-</VirtualHost>
-

Standard - Keep access and error logs

-
<VirtualHost *:80>
-    ServerName   shaarli.my-domain.org
-    DocumentRoot /absolute/path/to/shaarli/
-
-    LogLevel  warn
-    ErrorLog  /var/log/apache2/shaarli-error.log
-    CustomLog /var/log/apache2/shaarli-access.log combined
-</VirtualHost>
-

Paranoid - Redirect HTTP (:80) to HTTPS (:443)

-

See Server-side TLS (Mozilla).

-
<VirtualHost *:443>
-    ServerName   shaarli.my-domain.org
-    DocumentRoot /absolute/path/to/shaarli/
-
-    SSLEngine             on
-    SSLCertificateFile    /absolute/path/to/the/website/certificate.pem
-    SSLCertificateKeyFile /absolute/path/to/the/website/key.key
-
-    <Directory /absolute/path/to/shaarli/>
-        AllowOverride All
-        Options Indexes FollowSymLinks MultiViews
-        Order allow,deny
-        allow from all
-    </Directory>
-
-    LogLevel  warn
-    ErrorLog  /var/log/apache2/shaarli-error.log
-    CustomLog /var/log/apache2/shaarli-access.log combined
-</VirtualHost>
-<VirtualHost *:80>
-    ServerName   shaarli.my-domain.org
-    Redirect 301 / https://shaarli.my-domain.org
-
-    LogLevel  warn
-    ErrorLog  /var/log/apache2/shaarli-error.log
-    CustomLog /var/log/apache2/shaarli-access.log combined
-</VirtualHost>
-

.htaccess

-

Shaarli use .htaccess Apache files to deny access to files that shouldn't be directly accessed (datastore, config, etc.). You need the directive AllowOverride All in your virtual host configuration for them to work.

-

Warning: If you use Apache 2.2 or lower, you need mod_version to be installed and enabled.

-

Apache module mod_rewrite must be enabled to use the REST API. URL rewriting rules for the Slim microframework are stated in the root .htaccess file.

-

LightHttpd

-

Nginx

-

Foreword

-

Nginx does not natively interpret PHP scripts; to this effect, we will run a FastCGI service, to which Nginx's FastCGI module will proxy all requests to PHP resources.

-

Required packages:

- -

Official documentation:

- -

Community resources:

- -

Common setup

-

Once Nginx and PHP-FPM are installed, we need to ensure:

-
    -
  • Nginx and PHP-FPM are running using the same user and group
    • -
  • both these user and group have -
      -
    • read permissions for Shaarli resources
      • -
    • execute permissions for Shaarli directories AND their parent directories
      • -
    • -
-

On a production server:

-
    -
  • user:group will likely be http:http, www:www or www-data:www-data
    • -
  • files will be located under /var/www, /var/http or /usr/share/nginx
    • -
-

On a development server:

-
    -
  • files may be located in a user's home directory
    • -
  • in this case, make sure both Nginx and PHP-FPM are running as the local user/group!
    • -
-

For all following configuration examples, this user/group pair will be used:

-
    -
  • user:group = john:users,
    • -
-

which corresponds to the following service configuration:

-
; /etc/php/php-fpm.conf
-user = john
-group = users
-
-[...][](.html)
-listen.owner = john
-listen.group = users
-
# /etc/nginx/nginx.conf
-user john users;
-
-http {
-    [...][](.html)
-}
-

(Optional) Increase the maximum file upload size

-

Some bookmark dumps generated by web browsers can be huge due to the presence of Base64-encoded images and favicons, as well as extra verbosity when nesting links in (sub-)folders.

-

To increase upload size, you will need to modify both nginx and PHP configuration:

-
# /etc/nginx/nginx.conf
-
-http {
-    [...][](.html)
-
-    client_max_body_size 10m;
-
-    [...][](.html)
-}
-
# /etc/php5/fpm/php.ini
-
-[...][](.html)
-post_max_size = 10M
-[...][](.html)
-upload_max_filesize = 10M
-

Minimal

-

WARNING: Use for development only!

-
user john users;
-worker_processes  1;
-events {
-    worker_connections  1024;
-}
-
-http {
-    include            mime.types;
-    default_type       application/octet-stream;
-    keepalive_timeout  20;
-
-    index index.html index.php;
-
-    server {
-        listen       80;
-        server_name  localhost;
-        root         /home/john/web;
-
-        access_log  /var/log/nginx/access.log;
-        error_log   /var/log/nginx/error.log;
-
-        location /shaarli/ {
-            try_files $uri /shaarli/index.php$is_args$args;
-            access_log  /var/log/nginx/shaarli.access.log;
-            error_log   /var/log/nginx/shaarli.error.log;
-        }
-
-        location ~ (index)\.php$ {
-            try_files $uri =404;
-            fastcgi_split_path_info ^(.+\.php)(/.+)$;
-            fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
-            fastcgi_index  index.php;
-            include        fastcgi.conf;
-        }
-    }
-}
-

Modular

-

The previous setup is sufficient for development purposes, but has several major caveats:

-
    -
  • every content that does not match the PHP rule will be sent to client browsers: -
      -
    • dotfiles - in our case, .htaccess
      • -
    • temporary files, e.g. Vim or Emacs files: index.php~
      • -
    • -
  • asset / static resource caching is not optimized
    • -
  • if serving several PHP sites, there will be a lot of duplication: location /shaarli/, location /mysite/, etc.
    • -
-

To solve this, we will split Nginx configuration in several parts, that will be included when needed:

-
# /etc/nginx/deny.conf
-location ~ /\. {
-    # deny access to dotfiles
-    access_log off;
-    log_not_found off;
-    deny all;
-}
-
-location ~ ~$ {
-    # deny access to temp editor files, e.g. "script.php~"
-    access_log off;
-    log_not_found off;
-    deny all;
-}
-
# /etc/nginx/php.conf
-location ~ (index)\.php$ {
-    # Slim - split URL path into (script_filename, path_info)
-    try_files $uri =404;
-    fastcgi_split_path_info ^(.+\.php)(/.+)$;
-
-    # filter and proxy PHP requests to PHP-FPM
-    fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
-    fastcgi_index  index.php;
-    include        fastcgi.conf;
-}
-
-location ~ \.php$ {
-    # deny access to all other PHP scripts
-    deny all;
-}
-
# /etc/nginx/static_assets.conf
-location ~* \.(?:ico|css|js|gif|jpe?g|png)$ {
-    expires    max;
-    add_header Pragma public;
-    add_header Cache-Control "public, must-revalidate, proxy-revalidate";
-}
-
# /etc/nginx/nginx.conf
-[...][](.html)
-
-http {
-    [...][](.html)
-
-    root        /home/john/web;
-    access_log  /var/log/nginx/access.log;
-    error_log   /var/log/nginx/error.log;
-
-    server {
-        # virtual host for a first domain
-        listen       80;
-        server_name  my.first.domain.org;
-
-        location /shaarli/ {
-            # Slim - rewrite URLs
-            try_files $uri /shaarli/index.php$is_args$args;
-
-            access_log  /var/log/nginx/shaarli.access.log;
-            error_log   /var/log/nginx/shaarli.error.log;
-        }
-
-        location = /shaarli/favicon.ico {
-            # serve the Shaarli favicon from its custom location
-            alias /var/www/shaarli/images/favicon.ico;
-        }
-
-        include deny.conf;
-        include static_assets.conf;
-        include php.conf;
-    }
-
-    server {
-        # virtual host for a second domain
-        listen       80;
-        server_name  second.domain.com;
-
-        location /minigal/ {
-            access_log  /var/log/nginx/minigal.access.log;
-            error_log   /var/log/nginx/minigal.error.log;
-        }
-
-        include deny.conf;
-        include static_assets.conf;
-        include php.conf;
-    }
-}
-

Redirect HTTP to HTTPS

-

Assuming you have generated a (self-signed) key and certificate, and they are located under /home/john/ssl/localhost.{key,crt}, it is pretty straightforward to set an HTTP (:80) to HTTPS (:443) redirection to force SSL/TLS usage.

-
# /etc/nginx/nginx.conf
-[...][](.html)
-
-http {
-    [...][](.html)
-
-    index index.html index.php;
-
-    root        /home/john/web;
-    access_log  /var/log/nginx/access.log;
-    error_log   /var/log/nginx/error.log;
-
-    server {
-        listen       80;
-        server_name  localhost;
-
-        return 301 https://localhost$request_uri;
-    }
-
-    server {
-        listen       443 ssl;
-        server_name  localhost;
-
-        ssl_certificate      /home/john/ssl/localhost.crt;
-        ssl_certificate_key  /home/john/ssl/localhost.key;
-
-        location /shaarli/ {
-            # Slim - rewrite URLs
-            try_files $uri /index.php$is_args$args;
-
-            access_log  /var/log/nginx/shaarli.access.log;
-            error_log   /var/log/nginx/shaarli.error.log;
-        }
-
-        location = /shaarli/favicon.ico {
-            # serve the Shaarli favicon from its custom location
-            alias /var/www/shaarli/images/favicon.ico;
-        }
-
-        include deny.conf;
-        include static_assets.conf;
-        include php.conf;
-    }
-}
- - diff --git a/doc/Server-requirements.html b/doc/Server-requirements.html deleted file mode 100644 index 79d74118..00000000 --- a/doc/Server-requirements.html +++ /dev/null @@ -1,195 +0,0 @@ - - - - - - - Shaarli – Server requirements - - - - - - -

Server requirements

-

PHP

-

Release information

- -

Supported versions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
VersionStatusShaarli compatibility
7.1Supported (v0.9.x)✅
7.0Supported✅
5.6Supported✅
5.5EOL: 2016-07-10✅
5.4EOL: 2015-09-14✅ (up to Shaarli 0.8.x)
5.3EOL: 2014-08-14✅ (up to Shaarli 0.8.x)
-

See also:

- -

Dependency management

-

Starting with Shaarli v0.8.x, Composer is used to resolve,
-download and install third-party PHP dependencies.

- - - - - - - - - - - - - - - - - - - - - - - - - -
LibraryRequired?Usage
shaarli/netscape-bookmark-parserAllImport bookmarks from Netscape files
erusev/parsedownAllParse MarkDown syntax for the MarkDown plugin
slim/slimAllHandle routes and middleware for the REST API
-

Extensions

- ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ExtensionRequired?Usage
opensslAllOpenSSL, HTTPS
php-mbstringCentOS, Fedora, RHEL, Windowsmultibyte (Unicode) string support
php-gdoptionalthumbnail resizing
php-intloptionallocalized text sorting (e.g. e->è->f)
php-curloptionalusing cURL for fetching webpages and thumbnails in a more robust way
- - diff --git a/doc/Server-security.html b/doc/Server-security.html deleted file mode 100644 index 4f7ff468..00000000 --- a/doc/Server-security.html +++ /dev/null @@ -1,175 +0,0 @@ - - - - - - - Shaarli – Server security - - - - - - - -

Server security

-

php.ini

-

PHP settings are defined in:

-
    -
  • a main configuration file, usually found under /etc/php5/php.ini; some distributions provide different configuration environments, e.g. -
      -
    • /etc/php5/php.ini - used when running console scripts
      • -
    • /etc/php5/apache2/php.ini - used when a client requests PHP resources from Apache
      • -
    • /etc/php5/php-fpm.conf - used when PHP requests are proxied to PHP-FPM
      • -
    • -
  • additional configuration files/entries, depending on the installed/enabled extensions: -
      -
    • /etc/php/conf.d/xdebug.ini
      • -
    • -
-

Locate .ini files

-

Console environment

-
$ php --ini
-Configuration File (php.ini) Path: /etc/php
-Loaded Configuration File:         /etc/php/php.ini
-Scan for additional .ini files in: /etc/php/conf.d
-Additional .ini files parsed:      /etc/php/conf.d/xdebug.ini
-

Server environment

-
    -
  • create a phpinfo.php script located in a path supported by the web server, e.g. -
      -
    • Apache (with user dirs enabled): /home/myself/public_html/phpinfo.php
      • -
    • /var/www/test/phpinfo.php
      • -
    • -
  • make sure the script is readable by the web server user/group (usually, www, www-data or httpd)
    • -
  • access the script from a web browser
    • -

  • look at the Loaded Configuration File and Scan this dir for additional .ini files entries

    -
    <?php phpinfo(); ?>
    • -
-

fail2ban

-

fail2ban is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses iptables profiles to block brute-force attempts:

- -

Read Shaarli logs to ban IPs

-

Example configuration:

-
    -
  • allow 3 login attempts per IP address
    • -
  • after 3 failures, permanently ban the corresponding IP adddress
    • -
-

/etc/fail2ban/jail.local

-
[shaarli-auth][](.html)
-enabled  = true
-port     = https,http
-filter   = shaarli-auth
-logpath  = /var/www/path/to/shaarli/data/log.txt
-maxretry = 3
-bantime = -1
-

/etc/fail2ban/filter.d/shaarli-auth.conf

-
[INCLUDES][](.html)
-before = common.conf
-[Definition][](.html)
-failregex = \s-\s<HOST>\s-\sLogin failed for user.*$
-ignoreregex =
-

Robots - Restricting search engines and web crawler traffic

-

Creating a robots.txt with the following contents at the root of your Shaarli installation will prevent honest web crawlers from indexing each and every link and Daily page from a Shaarli instance, thus getting rid of a certain amount of unsollicited network traffic.

-
User-agent: *
-Disallow: /
-

See:

- - - diff --git a/doc/Shaarli-configuration.html b/doc/Shaarli-configuration.html deleted file mode 100644 index c696c97c..00000000 --- a/doc/Shaarli-configuration.html +++ /dev/null @@ -1,298 +0,0 @@ - - - - - - - Shaarli – Shaarli configuration - - - - - - - -

Shaarli configuration

-

Shaarli configuration

-

Foreword

-

Do not edit configuration options in index.php! Your changes would be lost.

-

Once your Shaarli instance is installed, the file data/config.json.php is generated:

-
    -
  • it contains all settings in JSON format, and can be edited to customize values
    • -
  • it defines which plugins are enabled(.html)
    • -
  • its values override those defined in index.php
    • -
  • it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration
    • -
-

File and directory permissions

-

The server process running Shaarli must have:

-
    -
  • read access to the following resources: -
      -
    • PHP scripts: index.php, application/*.php, plugins/*.php
      • -
    • 3rd party PHP and Javascript libraries: inc/*.php, inc/*.js
      • -
    • static assets: -
        -
      • CSS stylesheets: inc/*.css
        • -
      • images/*
        • -
      • -
    • RainTPL templates: tpl/*.html
      • -
    • -
  • read, write and execution access to the following directories: -
      -
    • cache - thumbnail cache
      • -
    • data - link data store, configuration options
      • -
    • pagecache - Atom/RSS feed cache
      • -
    • tmp - RainTPL page cache
      • -
    • -
-

On a Linux distribution:

-
    -
  • the web server user will likely be www or http (for Apache2)
    • -
  • it will be a member of a group of the same name: www:www, http:http
    • -
  • to give it access to Shaarli, either: -
      -
    • unzip Shaarli in the default web server location (usually /var/www/) and set the web server user as the owner
      • -
    • put users in the same group as the web server, and set the appropriate access rights
      • -
    • -
  • if you have a domain / subdomain to serve Shaarli, configure the server accordingly(.html)
    • -
-

Configuration

-

In data/config.json.php.

-

See also Plugin System.

-

Credentials

-
-

You shouldn't edit those.

-
-

login: Login username.
-hash: Generated password hash.
-salt: Password salt.

-

General

-

title: Shaarli's instance title.
-header_link: Link to the homepage.
-links_per_page: Number of shaares displayed per page.
-timezone: See the list of supported timezones.
-enabled_plugins: List of enabled plugins.

-

Security

-

session_protection_disabled: Disable session cookie hijacking protection (not recommended).
-It might be useful if your IP adress often changes.
-ban_after: Failed login attempts before being IP banned.
-ban_duration: IP ban duration in seconds.
-open_shaarli: Anyone can add a new link while logged out if enabled.
-trusted_proxies: List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy.

-

Resources

-

data_dir: Data directory.
-datastore: Shaarli's links database file path.
-history: Shaarli's operation history file path.
-updates: File path for the ran updates file.
-log: Log file path.
-update_check: Last update check file path.
-raintpl_tpl: Templates directory.
-raintpl_tmp: Template engine cache directory.
-thumbnails_cache: Thumbnails cache directory.
-page_cache: Shaarli's internal cache directory.
-ban_file: Banned IP file path.

-

Updates

-

check_updates: Enable or disable update check to the git repository.
-check_updates_branch: Git branch used to check updates (e.g. stable or master).
-check_updates_interval: Look for new version every N seconds (default: every day).

-

Privacy

-

default_private_links: Check the private checkbox by default for every new link.
-hide_public_links: All links are hidden while logged out.
-hide_timestamps: Timestamps are hidden.

-

Feed

-

rss_permalinks: Enable this to redirect RSS links to Shaarli's permalinks instead of shaared URL.
-show_atom: Display ATOM feed button.

-

Thumbnail

-

enable_thumbnails: Enable or disable thumbnail display.
-enable_localcache: Enable or disable local cache.

-

Redirector

-

url: Redirector URL, such as anonym.to.
-encode_url: Enable this if the redirector needs encoded URL to work properly.

-

Configuration file example

-
<?php /*
-{
-    "credentials": {
-        "login": "<login>",
-        "hash": "<password hash>",
-        "salt": "<password salt>"
-    },
-    "security": {
-        "ban_after": 4,
-        "session_protection_disabled": false,
-        "ban_duration": 1800,
-        "trusted_proxies": [[](.html)
-            "1.2.3.4",
-            "5.6.7.8"
-        ]
-    },
-    "resources": {
-        "data_dir": "data",
-        "config": "data\/config.php",
-        "datastore": "data\/datastore.php",
-        "ban_file": "data\/ipbans.php",
-        "updates": "data\/updates.txt",
-        "log": "data\/log.txt",
-        "update_check": "data\/lastupdatecheck.txt",
-        "raintpl_tmp": "tmp\/",
-        "raintpl_tpl": "tpl\/",
-        "thumbnails_cache": "cache",
-        "page_cache": "pagecache"
-    },
-    "general": {
-        "check_updates": true,
-        "rss_permalinks": true,
-        "links_per_page": 20,
-        "default_private_links": true,
-        "enable_thumbnails": true,
-        "enable_localcache": true,
-        "check_updates_branch": "stable",
-        "check_updates_interval": 86400,
-        "enabled_plugins": [[](.html)
-            "markdown",
-            "wallabag",
-            "archiveorg"
-        ],
-        "timezone": "Europe\/Paris",
-        "title": "My Shaarli",
-        "header_link": "?"
-    },
-    "extras": {
-        "show_atom": false,
-        "hide_public_links": false,
-        "hide_timestamps": false,
-        "open_shaarli": false,
-        "redirector": "http://anonym.to/?",
-        "redirector_encode_url": false
-    },
-    "general": {
-        "header_link": "?",
-        "links_per_page": 20,
-        "enabled_plugins": [[](.html)
-            "markdown",
-            "wallabag"
-        ],
-        "timezone": "Europe\/Paris",
-        "title": "My Shaarli"
-    },
-    "updates": {
-        "check_updates": true,
-        "check_updates_branch": "stable",
-        "check_updates_interval": 86400
-    },
-    "feed": {
-        "rss_permalinks": true,
-        "show_atom": false
-    },
-    "privacy": {
-        "default_private_links": true,
-        "hide_public_links": false,
-        "hide_timestamps": false
-    },
-    "thumbnail": {
-        "enable_thumbnails": true,
-        "enable_localcache": true
-    },
-    "redirector": {
-        "url": "http://anonym.to/?",
-        "encode_url": false
-    },
-    "plugins": {
-        "WALLABAG_URL": "http://demo.wallabag.org",
-        "WALLABAG_VERSION": "1"
-    }
-} ?>
-

Additional configuration

-

The playvideos plugin may require that you adapt your server's
-Content Security Policy
-configuration to work properly.(.html)

- - diff --git a/doc/Sharing-button.html b/doc/Sharing-button.html deleted file mode 100644 index f3682f8c..00000000 --- a/doc/Sharing-button.html +++ /dev/null @@ -1,94 +0,0 @@ - - - - - - - Shaarli – Sharing button - - - - - - -

Sharing button

-

Add the sharing button (bookmarklet) to your browser

-
    -
  • Open your Shaarli and Login
    • -
  • Click the Tools button in the top bar
    • -
  • Drag the ✚Shaare link button, and drop it to your browser's bookmarks bar.
    • -
-

This bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar.

-

- -
    -
  • When you are visiting a webpage you would like to share with Shaarli, click the bookmarklet you just added.
    • -
  • A window opens.
    • -
  • You can freely edit title, description, tags... to find it later using the text search or tag filtering.
    • -
  • You will be able to edit this link later using the
    • -
  • You can also check the “Private” box so that the link is saved but only visible to you.
    • -
  • Click Save.Voilà! Your link is now shared.
    • -
-

Troubleshooting: The bookmarklet doesn't work with a few website (e.g. Github.com)

-

Websites which enforce Content Security Policy (CSP), such as github.com, disallow usage of bookmarklets. Unfortunatly, there is nothing Shaarli can do about it.

-

See #196.

-

There is an open bug for both Firefox and Chromium:

- - - diff --git a/doc/Static-analysis.html b/doc/Static-analysis.html deleted file mode 100644 index a95d195e..00000000 --- a/doc/Static-analysis.html +++ /dev/null @@ -1,82 +0,0 @@ - - - - - - - Shaarli – Static analysis - - - - - - -

Static analysis

-

WIP

-

This topic is currently being discussed here:

- -

Usage

-

Static analysis tools can be installed with Composer, and used through Shaarli's Makefile.

-

For an overview of the available features, see:

- - - diff --git a/doc/Theming.html b/doc/Theming.html deleted file mode 100644 index 6b5dac35..00000000 --- a/doc/Theming.html +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - Shaarli – Theming - - - - - - - -

Theming

-

Foreword

-

There are two ways of customizing how Shaarli looks:

-
    -
  1. by using a custom CSS to override Shaarli's CSS
    2. -
  2. by using a full theme that provides its own RainTPL templates, CSS and Javascript resources
    3. -
-

Custom CSS

-

Shaarli's appearance can be modified by adding CSS rules to:

-
    -
  • Shaarli < v0.9.0: inc/user.css
    • -
  • Shaarli >= v0.9.0: data/user.css
    • -
-

This file allows overriding rules defined in the template CSS files (only add changed rules), or define a whole new theme.

-

Note: Do not edit tpl/default/css/shaarli.css! Your changes would be overridden when updating Shaarli.

-

See also Download CSS styles from an OPML list

-

Themes

-

WARNING - This feature is currently being worked on and will be improved in the next releases. Experimental.

-

Installation:

-
    -
  • find a theme you'd like to install
    • -
  • copy or clone the theme folder under tpl/<a_sweet_theme>
    • -
  • enable the theme: -
      -
    • Shaarli < v0.9.0: edit data/config.json.php and set the value of raintpl_tpl to the new theme name:
      -"raintpl_tpl": "tpl\/my-template\/"
      • -
    • Shaarli >= v0.9.0: select the theme through the Tools page
      • -
    • -
-

Community CSS & themes

-

Custom CSS

- -

Themes

- -

Shaarli forks

- -

Example installation: AlbinoMouse theme

-

With the following configuration:

-
    -
  • Apache 2 / PHP 5.6
    • -
  • user sites are enabled, e.g. /home/user/public_html/somedir is served as http://localhost/~user/somedir
    • -
  • http is the name of the Apache user
    • -
-
$ cd ~/public_html
-
-# clone repositories
-$ git clone https://github.com/shaarli/Shaarli.git shaarli
-$ pushd shaarli/tpl
-$ git clone https://github.com/alexisju/albinomouse-template.git
-$ popd
-
-# set access rights for Apache
-$ chgrp -R http shaarli
-$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp
-

Get config written:

-
    -
  • go to the freshly installed site
    • -
  • fill the install form
    • -
  • log in to Shaarli
    • -
-

Edit Shaarli's configuration|Shaarli configuration:

-
# the file should be owned by Apache, thus not writeable => sudo
-$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php
- - diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html deleted file mode 100644 index f43e6ed3..00000000 --- a/doc/Troubleshooting.html +++ /dev/null @@ -1,202 +0,0 @@ - - - - - - - Shaarli – Troubleshooting - - - - - - - -

Troubleshooting

-

Browser

-

Redirection issues (HTTP Referer)

-

Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.

-

See:

- -

Firefox HTTP Referer options

-

HTTP settings are available by browsing about:config, here are the available settings and their values.

-

network.http.sendRefererHeader - determines when to send the Referer HTTP header

-
    -
  • 0: Never send the referring URL -
      -
    • not recommended, may break some sites
      • -
    • -
  • 1: Send only on clicked links
    • -
  • 2 (default): Send for links and images
    • -
-

network.http.referer.XOriginPolicy - Cross-domain origin policy

-
    -
  • 0 (default): Always send
    • -
  • 1: Send if base domains match
    • -
  • 2: Send if hosts match
    • -
-

network.http.referer.spoofSource - Referer spoofing (~faking)

-
    -
  • false (default): real referer
    • -
  • true: spoof referer (use target URI as referer)
    • -
  • known to break some functionality in Shaarli
    • -
-

network.http.referer.trimmingPolicy - trim the URI not to send a full Referer

-
    -
  • 0 (default): send full URI
    • -
  • 1: scheme+host+port+path
    • -
  • 2: scheme+host+port
    • -
-

Firefox, localhost and redirections

-

localhost is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly.

-

To solve this, assign a local domain to your host, e.g.

-
127.0.0.1 localhost desktop localhost.lan
-::1       localhost desktop localhost.lan
-

and browse Shaarli at http://localhost.lan/.

-

Related threads:

- -

Login

-

I forgot my password!

-

Delete the file data/config.php and display the page again. You will be asked for a new login/password.

-

I'm locked out - Login bruteforce protection

-

Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links.

-

To remove the current IP bans, delete the file data/ipbans.php

-

List of all login attempts

-

The file data/log.txt shows all logins (successful or failed) and bans/lifted bans.
-Search for failed in this file to look for unauthorized login attempts.

-

Hosting problems

-

Old PHP versions

-
    -
  • On free.fr : free.fr now support php 5.6.x(link)and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a sessions directory and a .htaccess file containing:
    • -
-
<IfDefine Free>
-php56 1
-</IfDefine>
-
    -
  • If you have an error such as: Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx, it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to .php5
    • -
  • On 1and1 : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).
    • -
  • If you have the error Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /…/index.php on line xxx, it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines:
    • -
-
//list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.
-// FIXME: Decode charset according to charset specified in either 1) HTTP response headers or 2) <head> in html 
-//if (strpos($status,'200 OK')) $title=html_extract_title($data);
-
    -
  • On hosts which forbid outgoing HTTP requests (such as free.fr), some thumbnails will not work.
    • -
  • On lost-oasis, RSS doesn't work correctly, because of this message at the begining of the RSS/ATOM feed : <? // tout ce qui est charge ici (generalement des includes et require) est charge en permanence. ?>. To fix this, remove this message from php-include/prepend.php
    • -
-

Dates are not properly formatted

-

Shaarli tries to sniff the language of the browser (using HTTP_ACCEPT_LANGUAGE headers) and choose a date format accordingly. But Shaarli can only use the date formats (and more generaly speaking, the locales) provided by the webserver. So even if you have a browser in French, you may end up with dates in US format (it's the case on sebsauvage.net :-( )

-

Problems on CentOS servers

-

On CentOS/RedHat derivatives, you may need to install the php-mbstring package.

-

My session expires! I can't stay logged in

-

This can be caused by several things:

-
    -
  • Your php installation may not have a proper directory setup for session files. (eg. on Free.fr you need to create a session directory on the root of your website.) You may need to create the session directory of set it up.
    • -
  • Most hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the sessions subdirectory and add ini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions');. Make sure this directory is not browsable !)
    • -
  • If your IP address changes during surfing, Shaarli will force expire your session for security reasons (to prevent session cookie hijacking). This can happen when surfing from WiFi or 3G (you may have switched WiFi/3G access point), or in some corporate/university proxies which use load balancing (and may have proxies with several external IP addresses).
    • -
  • Some browser addons may interfer with HTTP headers (ipfuck/ipflood/GreaseMonkey…). Try disabling those.
    • -
  • You may be using OperaTurbo or OperaMini, which use their own proxies which may change from time to time.
    • -
  • If you have another application on the same webserver where Shaarli is installed, these application may forcefully expire php sessions.
    • -
-

Sessions do not seem to work correctly on your server

-

Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have no dots in the hostname (e.g. localhost or http://my-webserver/shaarli/), some browsers will not store cookies at all (this respects the HTTP cookie specification).

-

pubsubhubbub support

-

Download publisher.php at the root of your Shaarli installation and set $GLOBALS['config'['PUBSUBHUB_URL'] in your config.php]('PUBSUBHUB_URL']-in-your-config.php`.html)

- - diff --git a/doc/Unit-tests.html b/doc/Unit-tests.html deleted file mode 100644 index 09611463..00000000 --- a/doc/Unit-tests.html +++ /dev/null @@ -1,226 +0,0 @@ - - - - - - - Shaarli – Unit tests - - - - - - - -

Unit tests

-

Setup your environment for tests

-

The framework used is PHPUnit; it can be installed with Composer, which is a dependency management tool.

-

Regarding Composer, you can either use:

-
    -
  • a system-wide version, e.g. installed through your distro's package manager
    • -
  • a local version, downloadable here
    • -
-

Sample usage

-
# system-wide version
-$ composer install
-$ composer update
-
-# local version
-$ php composer.phar self-update
-$ php composer.phar install
-$ php composer.phar update
-

Install Shaarli dev dependencies

-
$ cd /path/to/shaarli
-$ composer update
-

Install and enable Xdebug to generate PHPUnit coverage reports

-

For Debian-based distros:

-
$ aptitude install php5-xdebug
-

For ArchLinux:

-
$ pacman -S xdebug
-

Then add the following line to /etc/php/php.ini:

-
zend_extension=xdebug.so
-

Run unit tests

-

Successful test suite:

-
$ make test
-
--------
-PHPUNIT
--------
-PHPUnit 4.6.9 by Sebastian Bergmann and contributors.
-
-Configuration read from /home/virtualtam/public_html/shaarli/phpunit.xml
-
-....................................
-
-Time: 759 ms, Memory: 8.25Mb
-
-OK (36 tests, 65 assertions)
-

Test suite with failures and errors:

-
$ make test
--------
-PHPUNIT
--------
-PHPUnit 4.6.9 by Sebastian Bergmann and contributors.
-
-Configuration read from /home/virtualtam/public_html/shaarli/phpunit.xml
-
-E..FF...............................
-
-Time: 802 ms, Memory: 8.25Mb
-
-There was 1 error:
-
-1) LinkDBTest::testConstructLoggedIn
-Missing argument 2 for LinkDB::__construct(), called in /home/virtualtam/public_html/shaarli/tests/Link\
-DBTest.php on line 79 and defined
-
-/home/virtualtam/public_html/shaarli/application/LinkDB.php:58
-/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:79
-
---
-
-There were 2 failures:
-
-1) LinkDBTest::testCheckDBNew
-Failed asserting that two strings are equal.
---- Expected
-+++ Actual
-@@ @@
--'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'
-+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'
-
-/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:121
-
-2) LinkDBTest::testCheckDBLoad
-Failed asserting that two strings are equal.
---- Expected
-+++ Actual
-@@ @@
--'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'
-+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'
-
-/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:133
-
-FAILURES!
-Tests: 36, Assertions: 63, Errors: 1, Failures: 2.
-

Test results and coverage

-

By default, PHPUnit will run all suitable tests found under the tests directory.

-

Each test has 3 possible outcomes:

-
    -
  • . - success
    • -
  • F - failure: the test was run but its results are invalid
    • -
  • the code does not behave as expected
    • -
  • dependencies to external elements: globals, session, cache...
    • -
  • E - error: something went wrong and the tested code has crashed
    • -
  • typos in the code, or in the test code
    • -
  • dependencies to missing external elements
    • -
-

If Xdebug has been installed and activated, two coverage reports will be generated:

-
    -
  • a summary in the console
    • -
  • a detailed HTML report with metrics for tested code
    • -
  • to open it in a web browser: firefox coverage/index.html &
    • -
-

Executing specific tests

-

Add a @group annotation in a test class or method comment:

-
/**
- * Netscape bookmark import
- * @group WIP
- */
-class BookmarkImportTest extends PHPUnit_Framework_TestCase
-{
-   [...][](.html)
-}
-

To run all tests annotated with @group WIP:

-
$ vendor/bin/phpunit --group WIP tests/
- - diff --git a/doc/Upgrade-and-migration.html b/doc/Upgrade-and-migration.html deleted file mode 100644 index 667215ab..00000000 --- a/doc/Upgrade-and-migration.html +++ /dev/null @@ -1,259 +0,0 @@ - - - - - - - Shaarli – Upgrade and migration - - - - - - - -

Upgrade and migration

-

Preparation

-

Note your current version

-

If anything goes wrong, it's important for us to know which version you're upgrading from.
-The current version is present in the version.php file.

-

Backup your data

-

Shaarli stores all user data under the data directory:

-
    -
  • data/config.php - main configuration file
    • -
  • data/datastore.php - bookmarked links
    • -
  • data/ipbans.php - banned IP addresses
    • -
  • data/updates.txt - contains all automatic update to the configuration and datastore files already run
    • -
-

See Shaarli configuration for more information about Shaarli resources.

-

It is recommended to backup this repository before starting updating/upgrading Shaarli:

-
    -
  • users with SSH access: copy or archive the directory to a temporary location
    • -
  • users with FTP access: download a local copy of your Shaarli installation using your favourite client
    • -
-

Migrating data from a previous installation

-

As all user data is kept under data, this is the only directory you need to worry about when migrating to a new installation, which corresponds to the following steps:

-
    -
  • backup the data directory
    • -
  • install or update Shaarli: -
    • -
  • check or restore the data directory
    • -
- -

All tagged revisions can be downloaded as tarballs or ZIP archives from the releases page.

-

We recommend that you use the latest release tarball with the -full suffix. It contains the dependencies, please read Download and installation for git complete instructions.

-

Once downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the data directory!

-

After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to data/config.json.php (see Shaarli configuration for more details).

-

Upgrading with Git

-

Updating a community Shaarli

-

If you have installed Shaarli from the community Git repository, simply pull new changes from your local clone:

-
$ cd /path/to/shaarli
-$ git pull
-
-From github.com:shaarli/Shaarli
- * branch            master     -> FETCH_HEAD
-Updating ebd67c6..521f0e6
-Fast-forward
- application/Url.php   | 1 +
- shaarli_version.php   | 2 +-
- tests/Url/UrlTest.php | 1 +
- 3 files changed, 3 insertions(+), 1 deletion(-)
-

Shaarli >= v0.8.x: install/update third-party PHP dependencies using Composer:

-
$ composer install --no-dev
-
-Loading composer repositories with package information
-Updating dependencies
-  - Installing shaarli/netscape-bookmark-parser (v1.0.1)
-    Downloading: 100%
-

Migrating and upgrading from Sebsauvage's repository

-

If you have installed Shaarli from Sebsauvage's original Git repository, you can use Git remotes to update your working copy.

-

The following guide assumes that:

-
    -
  • you have a basic knowledge of Git branching and remote repositories
    • -
  • the default remote is named origin and points to Sebsauvage's repository
    • -
  • the current branch is master -
      -
    • if you have personal branches containing customizations, you will need to rebase them after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break
      • -
    • -
  • the working copy is clean: -
      -
    • no versioned file has been locally modified
      • -
    • no untracked files are present
      • -
    • -
-

Step 0: show repository information

-
$ cd /path/to/shaarli
-
-$ git remote -v
-origin  https://github.com/sebsauvage/Shaarli (fetch)
-origin  https://github.com/sebsauvage/Shaarli (push)
-
-$ git branch -vv
-* master 029f75f [origin/master] Update README.md[](.html)
-
-$ git status
-On branch master
-Your branch is up-to-date with 'origin/master'.
-nothing to commit, working directory clean
-

Step 1: update Git remotes

-
$ git remote rename origin sebsauvage
-$ git remote -v
-sebsauvage  https://github.com/sebsauvage/Shaarli (fetch)
-sebsauvage  https://github.com/sebsauvage/Shaarli (push)
-
-$ git remote add origin https://github.com/shaarli/Shaarli
-$ git fetch origin
-
-remote: Counting objects: 3015, done.
-remote: Compressing objects: 100% (19/19), done.
-remote: Total 3015 (delta 446), reused 457 (delta 446), pack-reused 2550
-Receiving objects: 100% (3015/3015), 2.59 MiB | 918.00 KiB/s, done.
-Resolving deltas: 100% (1899/1899), completed with 48 local objects.
-From https://github.com/shaarli/Shaarli
- * [new branch]      master     -> origin/master[](.html)
- * [new branch]      stable     -> origin/stable[](.html)
-[...][](.html)
- * [new tag]         v0.6.4     -> v0.6.4[](.html)
- * [new tag]         v0.7.0     -> v0.7.0[](.html)
-

Step 2: use the stable community branch

-
$ git checkout origin/stable -b stable
-Branch stable set up to track remote branch stable from origin.
-Switched to a new branch 'stable'
-
-$ git branch -vv
-  master 029f75f [sebsauvage/master] Update README.md[](.html)
-* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5[](.html)
-

Shaarli >= v0.8.x: install/update third-party PHP dependencies using Composer:

-
$ composer install --no-dev
-
-Loading composer repositories with package information
-Updating dependencies
-  - Installing shaarli/netscape-bookmark-parser (v1.0.1)
-    Downloading: 100%
-

Optionally, you can delete information related to the legacy version:

-
$ git branch -D master
-Deleted branch master (was 029f75f).
-
-$ git remote remove sebsauvage
-
-$ git remote -v
-origin  https://github.com/shaarli/Shaarli (fetch)
-origin  https://github.com/shaarli/Shaarli (push)
-
-$ git gc
-Counting objects: 3317, done.
-Delta compression using up to 8 threads.
-Compressing objects: 100% (1237/1237), done.
-Writing objects: 100% (3317/3317), done.
-Total 3317 (delta 2050), reused 3301 (delta 2034)to
-

Step 3: configuration

-

After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to data/config.php (see Shaarli configuration for more details).

-

Troubleshooting

-

If the solutions provided here doesn't work, please open an issue specifying which version you're upgrading from and to.

-

You must specify an integer as a key

-

In v0.8.1 we changed how link keys are handled (from timestamps to incremental integers).
-Take a look at data/updates.txt content.

-

updates.txt contains updateMethodDatastoreIds

-

Try to delete it and refresh your page while being logged in.

-

updates.txt doesn't exists or doesn't contain updateMethodDatastoreIds

-
    -
  1. Create data/updates.txt if it doesn't exist.
    2. -
  2. Paste this string in the update file ;updateMethodRenameDashTags;
    3. -
  3. Login to Shaarli.
    4. -
  4. Delete the update file.
    5. -
  5. Refresh.
    6. -
- - diff --git a/doc/Usage.html b/doc/Usage.html deleted file mode 100644 index b5855881..00000000 --- a/doc/Usage.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - - - - Shaarli – Usage - - - - - - -

Usage

-

Main features

-

Shaarli is intended:

-
    -
  • to share, comment and save interesting links and news
    • -
  • to bookmark useful/frequent personal links (as private links) and share them between computers
    • -
  • as a minimal blog/microblog/writing platform (no character limit)
    • -
  • as a read-it-later list (for example items tagged readlater)
    • -
  • to draft and save articles/ideas
    • -
  • to keep code snippets
    • -
  • to keep notes and documentation
    • -
  • as a shared clipboard between machines
    • -
  • as a todo list
    • -
  • to store playlists (e.g. with the music or video tags)
    • -
  • to keep extracts/comments from webpages that may disappear
    • -
  • to keep track of ongoing discussions (for example items tagged discussion)
    • -
  • to feed RSS aggregators (planets) with specific tags
    • -
  • to feed other social networks, blogs... using RSS feeds and external services (dlvr.it, ifttt.com ...)
    • -
-

Using Shaarli as a blog, notepad, pastebin...

-
    -
  • Go to your Shaarli setup and log in
    • -
  • Click the Add Link button
    • -
  • To share text only, do not enter any URL in the corresponding input field and click Add Link
    • -
  • Pick a title and enter your article, or note, in the description field; add a few tags; optionally check Private then click Save
    • -
  • Voilà! Your article is now published (privately if you selected that option) and accessible using its permalink.
    • -
- - diff --git a/doc/Versioning-and-Branches.html b/doc/Versioning-and-Branches.html deleted file mode 100644 index 4dfe4a91..00000000 --- a/doc/Versioning-and-Branches.html +++ /dev/null @@ -1,156 +0,0 @@ - - - - - - - Shaarli – Versioning and Branches - - - - - - - -

Versioning and Branches

-

[WORK IN PROGRESS][](.html)

-

It's important to understand how Shaarli branches work, especially if you're maintaining a 3rd party tools for Shaarli (theme, plugin, etc.), to be sure stay compatible.

-

master branch

-

The master branch is the development branch. Any new change MUST go through this branch using Pull Requests.

-

Remarks:

-
    -
  • This branch shouldn't be used for production as it isn't necessary stable.
    • -
  • 3rd party aren't required to be compatible with the latest changes.
    • -
  • Official plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch.
    • -
  • The version in this branch is always dev.
    • -
-

v0.x branch

-

This v0.x branch, points to the latest v0.x.y release.

-

Explanation:

-

When a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli.

-

In this case, the issue is fixed in the master branch, and the fix is backported the to the v0.x branch. Then a new release is made from the v0.x branch.

-

This workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon.

-

latest branch

-

This branch point the latest release. It recommended to use it to get the latest tested changes.

-

stable branch

-

The stable branch doesn't contain any major bug, and is one major digit version behind the latest release.

-

For example, the current latest release is v0.8.3, the stable branch is an alias to the latest v0.7.x release. When the v0.9.0 version will be released, the stable will move to the latest v0.8.x release.

-

Remarks:

-
    -
  • Shaarli release pace isn't fast, and the stable branch might be a few months behind the latest release.
    • -
-

Releases

-

Releases are always made from the latest v0.x branch.

-

Note that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step.

-

Advices on 3rd party git repos workflow

-

Versioning

-

Any time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the changelog (Draft means not released yet) and the commit log (like tpl folder for themes)). You can either:

-
    -
  • use the Shaarli version number, with your repo version. For example, if Shaarli v0.8.3 is released, publish a v0.8.3-1 release, where v0.8.3 states Shaarli compatibility and -1 is your own version digit for the current Shaarli version.
    • -
  • use your own versioning scheme, and state Shaarli compatibility in the release description.
    • -
-

Using this, any user will be able to pick the release matching his own Shaarli version.

-

Major bugfix backport releases

-

To be able to support backported fixes, it recommended to use our workflow:

-
# In master, fix the major bug
-git commit -m "Katastrophe"
-git push origin master
-# Get your commit hash
-git log --format="%H" -n 1
-# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name)
-git checkout -b katastrophe v0.8.2-1
-# Backport the fix commit to your brand new branch
-git cherry-pick <fix commit hash>
-git push origin katastrophe
-# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1`
- - diff --git a/doc/_Footer.html b/doc/_Footer.html deleted file mode 100644 index 09473a38..00000000 --- a/doc/_Footer.html +++ /dev/null @@ -1,70 +0,0 @@ - - - - - - - Shaarli – _Footer - - - - - - -

_Footer
-Shaarli, the personal, minimalist, super-fast, database-free bookmarking service

- - diff --git a/doc/_Sidebar.html b/doc/_Sidebar.html deleted file mode 100644 index d3f94560..00000000 --- a/doc/_Sidebar.html +++ /dev/null @@ -1,119 +0,0 @@ - - - - - - - Shaarli – _Sidebar - - - - - - -

_Sidebar

- - - diff --git a/doc/html/3rd-party-libraries/index.html b/doc/html/3rd-party-libraries/index.html new file mode 100644 index 00000000..c54c45f5 --- /dev/null +++ b/doc/html/3rd-party-libraries/index.html @@ -0,0 +1,369 @@ + + + + + + + + + + + 3rd party libraries - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

CSS

+
    +
  • Yahoo UI CSS Reset
      +
    • resets default CSS properties for all HTML elements (overriding browsers' default values)
      • +
    • ensures custom CSS stylessheets will provide the same results on all browsers
      • +
    +
    • +
+

Javascript

+ +

PHP

+ + +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Backup,-restore,-import-and-export/index.html b/doc/html/Backup,-restore,-import-and-export/index.html new file mode 100644 index 00000000..ceb80170 --- /dev/null +++ b/doc/html/Backup,-restore,-import-and-export/index.html @@ -0,0 +1,411 @@ + + + + + + + + + + + Backup, restore, import and export - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+
    +
  • Docs »
    • + + + +
  • How To »
    • + + + +
  • Backup, restore, import and export
    • +
  • + + Edit on GitHub + +
    • +
+
+
+
+
+ + +
+

Backup and restore the datastore file

+

Backup the file data/datastore.php (by FTP or SSH). Restore by putting the file back in place.

+

Example command:

+
rsync -avzP my.server.com:/var/www/shaarli/data/datastore.php datastore-$(date +%Y-%m-%d_%H%M).php
+
+ + +

To export links as an HTML file, under Tools > Export, choose: +- Export all to export both public and private links +- Export public to export public links only +- Export private to export private links only

+

Restore by using the Import feature. +* This can be done using the shaarchiver tool.

+

Example command:

+
./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all
+
+ + +

Diigo

+

If you export your bookmark from Diigo, make sure you use the Delicious export, not the Netscape export. (Their Netscape export is broken, and they don't seem to be interested in fixing it.)

+

Mister Wong

+

See this issue for import tweaks.

+

SemanticScuttle

+

To correctly import the tags from a SemanticScuttle HTML export, edit the HTML file before importing and replace all occurences of tags= (lowercase) to TAGS= (uppercase).

+

Scuttle

+

Shaarli cannot import data directly from Scuttle. However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer.

+ +
    +
  • Export your Shaarli links as described above.
    • +
  • For compatibility reasons, check Prepend note permalinks with this Shaarli instance's URL (useful to import bookmarks in a web browser)
    • +
  • In Firefox, open the bookmark manager (not the sidebar! Bookmarks menu > Show all bookmarks or Ctrl+Shift+B)
    • +
  • Select Import and Backup > Import bookmarks in HTML format
    • +
+

Your bookmarks will be imported in Firefox, ready to use, with tags and descriptions retained. "Self" (notes) shaares will still point to the Shaarli instance you exported them from, but the note text can be viewed directly in the bookmark properties inside your browser. Depending on the number of bookmarks, the import can take some time.

+

You may be interested in these Firefox addons to manage links imported from Shaarli

+ + +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Bookmarklet/index.html b/doc/html/Bookmarklet/index.html new file mode 100644 index 00000000..e7a370b6 --- /dev/null +++ b/doc/html/Bookmarklet/index.html @@ -0,0 +1,375 @@ + + + + + + + + + + + Bookmarklet - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Add the sharing button (bookmarklet) to your browser

+
    +
  • Open your Shaarli and Login
    • +
  • Click the Tools button in the top bar
    • +
  • Drag the ✚Shaare link button, and drop it to your browser's bookmarks bar.
    • +
+

This bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar.

+

+ +
    +
  • When you are visiting a webpage you would like to share with Shaarli, click the bookmarklet you just added.
    • +
  • A window opens.
    • +
  • You can freely edit title, description, tags... to find it later using the text search or tag filtering.
    • +
  • You will be able to edit this link later using the edit button.
    • +
  • You can also check the “Private” box so that the link is saved but only visible to you.
    • +
  • Click Save.Voilà! Your link is now shared.
    • +
+

Troubleshooting: The bookmarklet doesn't work with a few website (e.g. Github.com)

+

Websites which enforce Content Security Policy (CSP), such as github.com, disallow usage of bookmarklets. Unfortunatly, there is nothing Shaarli can do about it.

+

See #196.

+

There is an open bug for both Firefox and Chromium:

+
    +
  • https://bugzilla.mozilla.org/show_bug.cgi?id=866522
    • +
  • https://code.google.com/p/chromium/issues/detail?id=233903
    • +
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Browsing-and-searching/index.html b/doc/html/Browsing-and-searching/index.html new file mode 100644 index 00000000..459f07c7 --- /dev/null +++ b/doc/html/Browsing-and-searching/index.html @@ -0,0 +1,362 @@ + + + + + + + + + + + Browsing and searching - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Plain text search

+

Use the Search text field to search in any of the fields of all links (Title, URL, Description...)

+

Exclude text/tags: Use the - operator before a word or tag (example -uninteresting) to prevent entries containing (or tagged) uninteresting from showing up in the search results.

+

Exact text search: Use double-quotes (example "exact search") to search for the exact expression.

+

Both exclude patterns and exact searches can be combined with normal searches (example "exact search" term otherterm -notthis "very exact" stuff -notagain)

+ +

Use the Filter by tags field to restrict displayed links to entries tagged with one or multiple tags (use space to separate tags).

+

Hidden tags: Tags starting with a dot . (example .secret) are private. They can only be seen and searched when logged in.

+

Alternatively you can use the Tag cloud to discover all tags and click on any of them to display related links.

+

To search for links that are not tagged, enter "" in the tag search field.

+

Filtering RSS feeds/Picture wall

+

RSS feeds can also be restricted to only return items matching a text/tag search: see RSS feeds.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Coding-guidelines/index.html b/doc/html/Coding-guidelines/index.html new file mode 100644 index 00000000..be2bf7e8 --- /dev/null +++ b/doc/html/Coding-guidelines/index.html @@ -0,0 +1,348 @@ + + + + + + + + + + + Coding guidelines - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

WIP

+

This topic is currently being discussed here: +- Fix coding style (static analysis) (#95) +- Continuous Integration tools & features (#130)

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Community-&-Related-software/index.html b/doc/html/Community-&-Related-software/index.html new file mode 100644 index 00000000..1de704a3 --- /dev/null +++ b/doc/html/Community-&-Related-software/index.html @@ -0,0 +1,419 @@ + + + + + + + + + + + Community & Related software - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Unofficial but related work on Shaarli. If you maintain one of these, please get in touch with us to help us find a way to adapt your work to our fork.

+

TODO: contact repos owners to see if they'd like to standardize their work with the community fork.

+

Community

+ +

Articles and social media discussions

+ +

Third party plugins

+ +

Themes

+

See Theming for the list of community-contributed themes, and an installation guide.

+

Server apps

+
    +
  • shaarchiver - Archive your Shaarli bookmarks and their content
    • +
  • shaarli-river - An aggregator for shaarlis with many features
    • +
  • Shaarlo - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: shaarli.fr)
    • +
  • Shaarlimages - An image-oriented aggregator for Shaarlis
    • +
  • mknexen/shaarli-api - A REST API for Shaarli
    • +
  • Self dead link - Detect dead links on shaarli. This version use the database of shaarli. Another version, can be used for other shaarli instances (but is more resource consuming).
    • +
  • Bookmark Archiver - Save an archived copy of all websites starred using browser bookmarks/Shaarli/Delicious/Instapaper/Unmark.it/Pocket/Pinboard. Outputs browseable html.
    • +
+

Mobile Apps

+ +

Integration with other platforms

+ +

Alternatives to Shaarli

+

See the bookmarks & link sharing section on awesome-selfhosted.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + +
+ + + + diff --git a/doc/html/Continuous-integration-tools/index.html b/doc/html/Continuous-integration-tools/index.html new file mode 100644 index 00000000..c889a963 --- /dev/null +++ b/doc/html/Continuous-integration-tools/index.html @@ -0,0 +1,367 @@ + + + + + + + + + + + Continuous integration tools - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+
    +
  • Docs »
    • + + + +
  • Development »
    • + + + +
  • Continuous integration tools
    • +
  • + + Edit on GitHub + +
    • +
+
+
+
+
+ +

Local development

+

A Makefile is available to perform project-related operations: +- Documentation - generate a local HTML copy of the GitHub wiki +- Static analysis - check that the code is compliant to PHP conventions +- Unit tests - ensure there are no regressions introduced by new commits

+

Automatic builds

+

Travis CI is a Continuous Integration build server, that runs a build: +- each time a commit is merged to the mainline (master branch) +- each time a Pull Request is submitted or updated

+

A build is composed of several jobs: one for each supported PHP version (see Server requirements).

+

Each build job: +- updates Composer +- installs 3rd-party test dependencies with Composer +- runs Unit tests

+

After all jobs have finished, Travis returns the results to GitHub: +- a status icon represents the result for the master branch: +- Pull Requests are updated with the Travis result + - Green: all tests have passed + - Red: some tests failed + - Orange: tests are pending

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html b/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html new file mode 100644 index 00000000..4aea480d --- /dev/null +++ b/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html @@ -0,0 +1,403 @@ + + + + + + + + + + + Copy an existing installation over SSH and serve it locally - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+
    +
  • Docs »
    • + + + +
  • How To »
    • + + + +
  • Copy an existing installation over SSH and serve it locally
    • +
  • + + Edit on GitHub + +
    • +
+
+
+
+
+ +

Example bash script:

+
#!/bin/bash
+#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli
+#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally.
+#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli
+#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed
+#Usage: ./local-shaarli.sh
+#Author: nodiscc (nodiscc@gmail.com)
+#License: MIT (http://opensource.org/licenses/MIT)
+set -o errexit
+set -o nounset
+
+##### CONFIG #################
+#The port used by php's local server
+php_local_port=7431
+
+#Name of the SSH server and path where Shaarli is installed
+#TODO: pass these as command-line arguments
+remotehost="my.ssh.server"
+remote_shaarli_dir="/var/www/shaarli"
+
+
+###### FUNCTIONS #############
+_main() {
+    _CBSyncShaarli
+    _CBServeShaarli
+}
+
+_CBSyncShaarli() {
+    remote_temp_dir=$(ssh $remotehost mktemp -d)
+    remote_ssh_user=$(ssh $remotehost whoami)
+    ssh -t "$remotehost" sudo cp -r "$remote_shaarli_dir" "$remote_temp_dir"
+    ssh -t "$remotehost" sudo chown -R "$remote_ssh_user":"$remote_ssh_user" "$remote_temp_dir"
+    scp -rq "$remotehost":"$remote_temp_dir" local-shaarli
+    ssh "$remotehost" rm -r "$remote_temp_dir"
+}
+
+_CBServeShaarli() {
+    #TODO: allow serving a previously downloaded Shaarli
+    #TODO: ask before overwriting local copy, if it exists
+    cd local-shaarli/
+    php -S localhost:${php_local_port}
+    echo "Please go to http://localhost:${php_local_port}"
+}
+
+
+##### MAIN #################
+
+_main
+
+ +

This outputs:

+
$ ./local-shaarli.sh
+PHP 5.6.0RC4 Development Server started at Mon Sep  1 21:56:19 2014
+Listening on http://localhost:7431
+Document root is /home/user/local-shaarli/shaarli
+Press Ctrl-C to quit.
+
+[Mon Sep  1 21:56:27 2014] ::1:57868 [200]: /
+[Mon Sep  1 21:56:27 2014] ::1:57869 [200]: /index.html
+[Mon Sep  1 21:56:37 2014] ::1:57881 [200]: /...
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html b/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html new file mode 100644 index 00000000..98d8992e --- /dev/null +++ b/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html @@ -0,0 +1,396 @@ + + + + + + + + + + + Create and serve multiple Shaarlis (farm) - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+
    +
  • Docs »
    • + + + +
  • How To »
    • + + + +
  • Create and serve multiple Shaarlis (farm)
    • +
  • + + Edit on GitHub + +
    • +
+
+
+
+
+ +

Example bash script (creates multiple shaarli instances and generates an HTML index of them)

+
#!/bin/bash
+set -o errexit
+set -o nounset
+
+#config
+shaarli_base_dir='/var/www/shaarli'
+accounts='bob john whatever username'
+shaarli_repo_url='https://github.com/shaarli/Shaarli'
+ref="master"
+
+#clone multiple shaarli instances
+if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi
+
+for account in $accounts; do
+    if [ -d "$shaarli_base_dir/$account" ];
+    then echo "[info] account $account already exists, skipping";
+    else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi
+done
+
+#generate html index of shaarlis
+htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
+<html lang="en">
+    <head>
+        <meta http-equiv="content-type" content="text/html; charset=utf-8">
+        <title>My Shaarli farm</title>
+        <style>body {font-family: "Open Sans"}</style>
+    </head>
+    <body>
+    <div>
+    <h1>My Shaarli farm</h1>
+    <ul style="list-style-type: none;">'
+
+accountlinks=''
+
+htmlfooter='
+    </ul>
+    </div>
+    </body>
+</html>'    
+
+
+
+for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
+if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi
+echo "[info] generating new index of shaarlis"
+echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
+echo '[info] done.'
+echo "[info] list of accounts: $accounts"
+echo "[info] contents of $shaarli_base_dir:"
+tree -a -L 1 "$shaarli_base_dir"
+
+ +

This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like Ansible

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Datastore-hacks/index.html b/doc/html/Datastore-hacks/index.html new file mode 100644 index 00000000..b3d8d97e --- /dev/null +++ b/doc/html/Datastore-hacks/index.html @@ -0,0 +1,369 @@ + + + + + + + + + + + Datastore hacks - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Decode datastore content

+

To display the array representing the data saved in data/datastore.php, use the following snippet:

+
$data = "tZNdb9MwFIb... <Commented content inside datastore.php>";
+$out = unserialize(gzinflate(base64_decode($data)));
+echo "<pre>"; // Pretty printing is love, pretty printing is life
+print_r($out);
+echo "</pre>";
+exit;
+
+ +

This will output the internal representation of the datastore, "unobfuscated" (if this can really be considered obfuscation).

+

Alternatively, you can transform to JSON format (and pretty-print if you have jq installed):

+
php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace("!.*/\* (.+) \*/.*!", "$1", file_get_contents("data/datastore.php")))))));' | jq .
+
+ + +
    +
  • Look for <input type="hidden" name="lf_linkdate" value="{$link.linkdate}"> in tpl/editlink.tpl (line 14)
    • +
  • Replace type="hidden" with type="text" from this line
    • +
  • A new date/time field becomes available in the edit/new link dialog.
    • +
  • You can set the timestamp manually by entering it in the format YYYMMDD_HHMMS.
    • +
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Development-guidelines/index.html b/doc/html/Development-guidelines/index.html new file mode 100644 index 00000000..747d53a8 --- /dev/null +++ b/doc/html/Development-guidelines/index.html @@ -0,0 +1,352 @@ + + + + + + + + + + + Development guidelines - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Development guidelines

+

Please have a look at the following pages: +- Contributing to Shaarli +- Static analysis - patches should try to stick to the PHP Standard Recommendations (PSR), especially: + - PSR-1 - Basic Coding Standard + - PSR-2 - Coding Style Guide +- Unit tests +- GnuPG signature for tags/releases

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Directory-structure/index.html b/doc/html/Directory-structure/index.html new file mode 100644 index 00000000..82979774 --- /dev/null +++ b/doc/html/Directory-structure/index.html @@ -0,0 +1,371 @@ + + + + + + + + + + + Directory structure - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Here is the directory structure of Shaarli and the purpose of the different files:

+
    index.php        # Main program
+    application/     # Shaarli classes
+        ├── LinkDB.php
+        └── Utils.php
+    tests/       # Shaarli unitary & functional tests
+        ├── LinkDBTest.php
+        ├── utils  # utilities to ease testing
+        │   └── ReferenceLinkDB.php
+        └── UtilsTest.php
+    COPYING          # Shaarli license
+    inc/             # static assets and 3rd party libraries
+        ├── awesomplete.*          # tags autocompletion library
+        ├── blazy.*                # picture wall lazy image loading library
+        ├── shaarli.css, reset.css # Shaarli stylesheet.
+        ├── qr.*                   # qr code generation library
+        └──rain.tpl.class.php      # RainTPL templating library
+    tpl/             # RainTPL templates for Shaarli. They are used to build the pages.
+    images/          # Images and icons used in Shaarli
+    data/            # data storage: bookmark database, configuration, logs, banlist…
+        ├── config.php             # Shaarli configuration (login, password, timezone, title…)
+        ├── datastore.php          # Your link database (compressed).
+        ├── ipban.php              # IP address ban system data
+        ├── lastupdatecheck.txt    # Update check timestamp file
+        └──log.txt                 # login/IPban log.
+    cache/           # thumbnails cache
+                     # This directory is automatically created. You can erase it anytime you want.
+    tmp/             # Temporary directory for compiled RainTPL templates.
+                     # This directory is automatically created. You can erase it anytime you want.
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Docker-101/index.html b/doc/html/Docker-101/index.html new file mode 100644 index 00000000..5b4f645c --- /dev/null +++ b/doc/html/Docker-101/index.html @@ -0,0 +1,410 @@ + + + + + + + + + + + Docker 101 - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Basics

+

Install Docker, by following the instructions relevant +to your OS / distribution, and start the service.

+

Search an image on DockerHub

+
$ docker search debian
+
+NAME            DESCRIPTION                                     STARS   OFFICIAL   AUTOMATED
+ubuntu          Ubuntu is a Debian-based Linux operating s...   2065    [OK]
+debian          Debian is a Linux distribution that's comp...   603     [OK]
+google/debian                                                   47                 [OK]
+
+ +

Show available tags for a repository

+
$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool
+
+% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
+Dload  Upload   Total   Spent    Left  Speed
+100  1283    0  1283    0     0    433      0 --:--:--  0:00:02 --:--:--   433
+
+ +

Sample output:

+
[
+    {
+        "layer": "85a02782",
+        "name": "stretch"
+    },
+    {
+        "layer": "59abecbc",
+        "name": "testing"
+    },
+    {
+        "layer": "bf0fd686",
+        "name": "unstable"
+    },
+    {
+        "layer": "60c52dbe",
+        "name": "wheezy"
+    },
+    {
+        "layer": "c5b806fe",
+        "name": "wheezy-backports"
+    }
+]
+
+
+ +

Pull an image from DockerHub

+
$ docker pull repository[:tag]
+
+$ docker pull debian:wheezy
+wheezy: Pulling from debian
+4c8cbfd2973e: Pull complete
+60c52dbe9d91: Pull complete
+Digest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe
+Status: Downloaded newer image for debian:wheezy
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Docker-resources/index.html b/doc/html/Docker-resources/index.html new file mode 100644 index 00000000..7bd7067d --- /dev/null +++ b/doc/html/Docker-resources/index.html @@ -0,0 +1,370 @@ + + + + + + + + + + + Docker resources - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+ + + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Download-CSS-styles-from-an-OPML-list/index.html b/doc/html/Download-CSS-styles-from-an-OPML-list/index.html new file mode 100644 index 00000000..e697b39d --- /dev/null +++ b/doc/html/Download-CSS-styles-from-an-OPML-list/index.html @@ -0,0 +1,496 @@ + + + + + + + + + + + Download CSS styles from an OPML list - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+
    +
  • Docs »
    • + + + +
  • How To »
    • + + + +
  • Download CSS styles from an OPML list
    • +
  • + + Edit on GitHub + +
    • +
+
+
+
+
+ +

Download CSS styles for shaarlis listed in an opml file

+

Example php script:

+
<!---- ?php -->
+<!---- Copyright (c) 2014 Nicolas Delsaux (https://github.com/Riduidel) -->
+<!---- License: zlib (http://www.gzip.org/zlib/zlib_license.html) -->
+
+/**
+ * Source: https://github.com/Riduidel
+ * Download css styles for shaarlis listed in an opml file
+ */
+define("SHAARLI_RSS_OPML", "https://www.ecirtam.net/shaarlirss/custom/people.opml");
+
+define("THEMES_TEMP_FOLDER", "new_themes");
+
+if(!file_exists(THEMES_TEMP_FOLDER)) {
+    mkdir(THEMES_TEMP_FOLDER);
+}
+
+function siteUrl($pathInSite) {
+    $indexPos = strpos($pathInSite, "index.php");
+    if(!$indexPos) {
+        return $pathInSite;
+    } else {
+        return substr($pathInSite, 0, $indexPos);
+    }
+}
+
+function createShaarliHashFromOPMLL($opmlFile) {
+    $result = array();
+    $opml = file_get_contents($opmlFile);
+    $opmlXml = simplexml_load_string($opml);
+    $outlineElements = $opmlXml->xpath("body/outline");
+    foreach($outlineElements as $site) {
+        $siteUrl = siteUrl((string) $site['htmlUrl']);
+        $result[$siteUrl]=((string) $site['text']);
+    }
+    return $result;
+}
+
+function getSiteFolder($url) {
+    $domain = parse_url($url,  PHP_URL_HOST);
+    return THEMES_TEMP_FOLDER."/".str_replace(".", "_", $domain);
+}
+
+function get_http_response_code($theURL) {
+     $headers = get_headers($theURL);
+     return substr($headers[0], 9, 3);
+}
+
+/**
+ * This makes the code PHP-5 only (particularly the call to "get_headers")
+ */
+function copyUserStyleFrom($url, $name, $knownStyles) {
+    $userStyle = $url."inc/user.css";
+    if(in_array($url, $knownStyles)) {
+        // TODO add log message
+    } else {
+        $statusCode = get_http_response_code($userStyle);
+        if(intval($statusCode)<300) {
+            $styleSheet = file_get_contents($userStyle);
+            $siteFolder = getSiteFolder($url);
+            if(!file_exists($siteFolder)) {
+                mkdir($siteFolder);
+            }
+            if(!file_exists($siteFolder.'/user.css')) {
+                // Copy stylesheet
+                file_put_contents($siteFolder.'/user.css', $styleSheet);
+            }
+            if(!file_exists($siteFolder.'/README.md')) {
+                // Then write a readme.md file
+                file_put_contents($siteFolder.'/README.md', 
+                    "User style from ".$name."\n"
+                    ."============================="
+                    ."\n\n"
+                    ."This stylesheet was downloaded from ".$userStyle." on ".date(DATE_RFC822)
+                    );
+            }
+            if(!file_exists($siteFolder.'/config.ini')) {
+                // Write a config file containing useful informations
+                file_put_contents($siteFolder.'/config.ini', 
+                    "site_url=".$url."\n"
+                    ."site_name=".$name."\n"
+                    );
+            }
+            if(!file_exists($siteFolder.'/home.png')) {
+                // And finally copy generated thumbnail
+                $homeThumb = $siteFolder.'/home.png';
+                file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));
+            }
+            echo 'Theme have been downloaded from  <a href="'.$url.'">'.$url.'</a> into '.$siteFolder
+                .'. It looks like <img src="'.$homeThumb.'"><br/>';
+        }
+    }
+}
+
+function getThumbnailUrl($url) {
+    return 'http://api.webthumbnail.org/?url='.$url;
+}
+
+function copyUserStylesFrom($urlToNames, $knownStyles) {
+    foreach($urlToNames as $url => $name) {
+        copyUserStyleFrom($url, $name, $knownStyles);
+    }
+}
+
+/**
+ * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/
+ * @param directory the directory we want to list files of
+ * @return a simple array containing the list of absolute file paths. Notice that current file (".") and parent one("..")
+ * are not listed here
+ */
+function getDirectoryList ($directory)  {
+    $realPath = realpath($directory);
+    // create an array to hold directory list
+    $results = array();
+    // create a handler for the directory
+    $handler = opendir($directory);
+    // open directory and walk through the filenames
+    while ($file = readdir($handler)) {
+        // if file isn't this directory or its parent, add it to the results
+        if ($file != "." && $file != "..") {
+            $results[] = realpath($realPath . "/" . $file);
+        }
+    }
+    // tidy up: close the handler
+    closedir($handler);
+    // done!
+    return $results;
+}
+
+/**
+ * Start in themes folder and look in all subfolders for config.ini files. 
+ * These config.ini files allow us not to download styles again and again
+ */
+function findKnownStyles() {
+    $result = array();
+    $subFolders = getDirectoryList("themes");
+    foreach($subFolders as $folder) {
+        $configFile = $folder."/config.ini";
+        if(file_exists($configFile)) {
+            $iniParameters = parse_ini_file($configFile);
+            array_push($result, $iniParameters['site_url']);
+        }
+    }
+    return $result;
+}
+
+$knownStyles = findKnownStyles();
+copyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);
+
+<!--- ? ---->
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Download-and-Installation/index.html b/doc/html/Download-and-Installation/index.html new file mode 100644 index 00000000..1ede1d68 --- /dev/null +++ b/doc/html/Download-and-Installation/index.html @@ -0,0 +1,444 @@ + + + + + + + + + + + Download and Installation - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your server is properly configured.

+

Several releases are available:

+
+ +

Download as an archive

+

Get the latest released version from the releases page.

+

Download our shaarli-full archive to include dependencies.

+

The current latest released version is v0.8.4

+

Or in command lines:

+
$ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip
+$ unzip shaarli-v0.8.4-full.zip
+$ mv Shaarli /path/to/shaarli/
+
+ + + + + + + + + +
!In most cases, download Shaarli from the releases page. Cloning using git or downloading Github branches as zip files requires additional steps (see below).
+

Using git

+
mkdir -p /path/to/shaarli && cd /path/to/shaarli/
+git clone -b v0.8 https://github.com/shaarli/Shaarli.git .
+composer install --no-dev
+
+ +
+

Stable version

+

The stable version has been experienced by Shaarli users, and will receive security updates.

+

Download as an archive

+

As a .zip archive:

+
$ wget https://github.com/shaarli/Shaarli/archive/stable.zip
+$ unzip stable.zip
+$ mv Shaarli-stable /path/to/shaarli/
+
+ +

As a .tar.gz archive :

+
$ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz
+$ tar xvf stable.tar.gz
+$ mv Shaarli-stable /path/to/shaarli/
+
+ +

Clone with Git

+

Composer is required to build a functional Shaarli installation when pulling from git.

+
$ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/
+# install/update third-party dependencies
+$ cd /path/to/shaarli/
+$ composer install --no-dev
+
+ +
+

Development version (mainline)

+

Use at your own risk!

+

To get the latest changes from the master branch:

+
# clone the repository  
+$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/
+# install/update third-party dependencies
+$ cd /path/to/shaarli
+$ composer install --no-dev
+
+ +
+

Finish Installation

+

Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.

+

install screenshot

+

Setup your Shaarli installation, and it's ready to use!

+
+

Updating Shaarli

+

See Upgrade and Migration

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/FAQ/index.html b/doc/html/FAQ/index.html new file mode 100644 index 00000000..c48e11f8 --- /dev/null +++ b/doc/html/FAQ/index.html @@ -0,0 +1,388 @@ + + + + + + + + + + + FAQ - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Why did you create Shaarli ?

+

I was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And… oh… their Firefox addon sends to Diigo every single URL you visit (Don't believe me ? Use Tamper Data and open any page).

+

Enough is enough. Saving simple links should not be a complicated heavy thing. I ditched them all and wrote my own: Shaarli. It's simple, but it does the job and does it well. And my data is not hosted on a foreign server, but on my server.

+

Why use Shaarli and not Delicious/Diigo ?

+

With Shaarli:

+
    +
  • The data is yours: It's hosted on your server.
    • +
  • Never fear of having your data locked-in.
    • +
  • Never fear to have your data sold to third party.
    • +
  • Your private links are not hosted on a third party server.
    • +
  • You are not tracked by browser addons (like Diigo does)
    • +
  • You can change the look and feel of the pages if you want.
    • +
  • You can change the behaviour of the program.
    • +
  • It's magnitude faster than most bookmarking services.
    • +
+

What does Shaarli mean?

+

Shaarli is for shaaring your links.

+

My Shaarli is broken!

+

First of all, ensure that both the web server and Shaarli are correctly configured, and that your installation is supported.

+

If everything looks right but the issue(s) remain(s), please: +- take a look at the troubleshooting section +- come chat with us on Gitter, we'll be happy to help ;-) +- browse active issues and Pull Requests + - if you find one that is related to the issue, feel free to comment and provide additional details (host/Shaarli setup) + - else, open a new issue, and provide information about the problem: + - what happens? - display glitches, invalid data, security flaws... + - what is your configuration? - OS, server version, activated extensions, web browser... + - is it reproducible?

+

Why not use a real database? Files are slow!

+

Does browsing this page feel slow? Try browsing older pages, too.

+

It's not slow at all, is it? And don't forget the database contains more than 16000 links, and it's on a shared host, with 32000 visitors/day for my website alone. And it's still damn fast. Why?

+

The data file is only 3.7 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Features/index.html b/doc/html/Features/index.html new file mode 100644 index 00000000..453f189a --- /dev/null +++ b/doc/html/Features/index.html @@ -0,0 +1,371 @@ + + + + + + + + + + + Features - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Main features

+

Shaarli is intended: + * to share, comment and save interesting links and news + * to bookmark useful/frequent personal links (as private links) and share them between computers + * as a minimal blog/microblog/writing platform (no character limit) + * as a read-it-later list (for example items tagged readlater) + * to draft and save articles/ideas + * to keep code snippets + * to keep notes and documentation + * as a shared clipboard between machines + * as a todo list + * to store playlists (e.g. with the music or video tags) + * to keep extracts/comments from webpages that may disappear + * to keep track of ongoing discussions (for example items tagged discussion) + * to feed RSS aggregators (planets) with specific tags + * to feed other social networks, blogs... using RSS feeds and external services (dlvr.it, ifttt.com ...)

+

Using Shaarli as a blog, notepad, pastebin...

+
    +
  • Go to your Shaarli setup and log in
    • +
  • Click the Add Link button
    • +
  • To share text only, do not enter any URL in the corresponding input field and click Add Link
    • +
  • Pick a title and enter your article, or note, in the description field; add a few tags; optionally check Private then click Save
    • +
  • Voilà! Your article is now published (privately if you selected that option) and accessible using its permalink.
    • +
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Firefox-share/index.html b/doc/html/Firefox-share/index.html new file mode 100644 index 00000000..c0aaf4bd --- /dev/null +++ b/doc/html/Firefox-share/index.html @@ -0,0 +1,368 @@ + + + + + + + + + + + Firefox share - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Add Shaarli as a sharing service to Firefox

+
    +
  • Open your Shaarli and Login
    • +
  • Click the Tools button in the top bar
    • +
  • Click the ✚Add to Firefox social button and accept the activation.
    • +
+ +
    +
  • Add the sharing service as described above
    • +
  • When you are visiting a webpage you would like to share with Shaarli, click the Firefox Share button images/firefoxshare.png
    • +
  • You can edit your link before and after saving, just like the bookmarklet above.
    • +
+ + + + + + + + +
Your Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections.
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/GnuPG-signature/index.html b/doc/html/GnuPG-signature/index.html new file mode 100644 index 00000000..781ccd2d --- /dev/null +++ b/doc/html/GnuPG-signature/index.html @@ -0,0 +1,439 @@ + + + + + + + + + + + GnuPG signature - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Introduction

+

PGP and GPG

+

Gnu Privacy Guard (GnuPG) is an Open Source implementation of the Pretty Good +Privacy (OpenPGP) specification. Its main purposes are digital authentication, +signature and encryption.

+

It is often used by the FLOSS community to verify: +- Linux package signatures: Debian SecureApt, ArchLinux Master +Keys +- SCM releases & maintainer identity

+

Trust

+

To quote Phil Pennock (the author of the SKS key server - http://sks.spodhuis.org/):

+
+

You MUST understand that presence of data in the keyserver (pools) in no way connotes trust. Anyone can generate a key, with any name or email address, and upload it. All security and trust comes from evaluating security at the “object level”, via PGP Web-Of-Trust signatures. This keyserver makes it possible to retrieve keys, looking them up via various indices, but the collection of keys in this public pool is KNOWN to contain malicious and fraudulent keys. It is the common expectation of server operators that users understand this and use software which, like all known common OpenPGP implementations, evaluates trust accordingly. This expectation is so common that it is not normally explicitly stated.

+
+

Trust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during key signing parties, see: +- The Keysigning party HOWTO +- Web of trust

+

Generate a GPG key

+ +

gpg - provide identity information

+
$ gpg --gen-key
+
+gpg (GnuPG) 2.1.6; Copyright (C) 2015 Free Software Foundation, Inc.
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+
+Note: Use "gpg2 --full-gen-key" for a full featured key generation dialog.
+
+GnuPG needs to construct a user ID to identify your key.
+
+Real name: Marvin the Paranoid Android
+Email address: marvin@h2g2.net
+You selected this USER-ID:
+    "Marvin the Paranoid Android <marvin@h2g2.net>"
+
+Change (N)ame, (E)mail, or (O)kay/(Q)uit? o
+We need to generate a lot of random bytes. It is a good idea to perform
+some other action (type on the keyboard, move the mouse, utilize the
+disks) during the prime generation; this gives the random number
+generator a better chance to gain enough entropy.
+
+ +

gpg - entropy interlude

+

At this point, you will: +- be prompted for a secure password to protect your key (the input method will depend on your Desktop Environment and configuration) +- be asked to use your machine's input devices (mouse, keyboard, etc.) to generate random entropy; this step may take some time

+

gpg - key creation confirmation

+
gpg: key A9D53A3E marked as ultimately trusted
+public and secret key created and signed.
+
+gpg: checking the trustdb
+gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model
+gpg: depth: 0  valid:   2  signed:   0  trust: 0-, 0q, 0n, 0m, 0f, 2u
+pub   rsa2048/A9D53A3E 2015-07-31
+      Key fingerprint = AF2A 5381 E54B 2FD2 14C4  A9A3 0E35 ACA4 A9D5 3A3E
+uid       [ultimate] Marvin the Paranoid Android <marvin@h2g2.net>
+sub   rsa2048/8C0EACF1 2015-07-31
+
+ +

gpg - submit your public key to a PGP server (Optional)

+
$ gpg --keyserver pgp.mit.edu --send-keys A9D53A3E
+gpg: sending key A9D53A3E to hkp server pgp.mit.edu
+
+ +

Create and push a GPG-signed tag

+

See Release Shaarli.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Plugin-System/index.html b/doc/html/Plugin-System/index.html new file mode 100644 index 00000000..5ee0f6c1 --- /dev/null +++ b/doc/html/Plugin-System/index.html @@ -0,0 +1,968 @@ + + + + + + + + + + + Plugin System - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

I am a developer. Developer API.

+

I am a template designer. Guide for template designer.

+

Developer API

+

What can I do with plugins?

+

The plugin system let you:

+
    +
  • insert content into specific places across templates.
    • +
  • alter data before templates rendering.
    • +
  • alter data before saving new links.
    • +
+

How can I create a plugin for Shaarli?

+

First, chose a plugin name, such as demo_plugin.

+

Under plugin folder, create a folder named with your plugin name. Then create a .php file in that folder.

+

You should have the following tree view:

+
| index.php
+| plugins/
+|---| demo_plugin/
+|   |---| demo_plugin.php
+
+ +

Plugin initialization

+

At the beginning of Shaarli execution, all enabled plugins are loaded. At this point, the plugin system looks for an init() function to execute and run it if it exists. This function must be named this way, and takes the ConfigManager as parameter.

+
<plugin_name>_init($conf)
+
+

This function can be used to create initial data, load default settings, etc. But also to set plugin errors. If the initialization function returns an array of strings, they will be understand as errors, and displayed in the header to logged in users.

+

Understanding hooks

+

A plugin is a set of functions. Each function will be triggered by the plugin system at certain point in Shaarli execution.

+

These functions need to be named with this pattern:

+
hook_<plugin_name>_<hook_name>($data, $conf)
+
+ +

Parameters:

+ +

For exemple, if my plugin want to add data to the header, this function is needed:

+
hook_demo_plugin_render_header
+
+

If this function is declared, and the plugin enabled, it will be called every time Shaarli is rendering the header.

+

Plugin's data

+

Parameters

+

Every hook function has a $data parameter. Its content differs for each hooks.

+

This parameter needs to be returned every time, otherwise data is lost.

+
return $data;
+
+

Filling templates placeholder

+

Template placeholders are displayed in template in specific places.

+

RainTPL displays every element contained in the placeholder's array. These element can be added by plugins.

+

For example, let's add a value in the placeholder top_placeholder which is displayed at the top of my page:

+
$data['top_placeholder'][] = 'My content';
+# OR
+array_push($data['top_placeholder'], 'My', 'content');
+
+return $data;
+
+ +

Data manipulation

+

When a page is displayed, every variable send to the template engine is passed to plugins before that in $data.

+

The data contained by this array can be altered before template rendering.

+

For exemple, in linklist, it is possible to alter every title:

+
// mind the reference if you want $data to be altered
+foreach ($data['links'] as &$value) {
+    // String reverse every title.
+    $value['title'] = strrev($value['title']);
+}
+
+return $data;
+
+ +

Metadata

+

Every plugin needs a <plugin_name>.meta file, which is in fact an .ini file (KEY="VALUE"), to be listed in plugin administration.

+

Each file contain two keys:

+
    +
  • description: plugin description
    • +
  • parameters: user parameter names, separated by a ;.
    • +
  • parameter.<PARAMETER_NAME>: add a text description the specified parameter.
    • +
+
+

Note: In PHP, parse_ini_file() seems to want strings to be between by quotes " in the ini file.

+
+

It's not working!

+

Use demo_plugin as a functional example. It covers most of the plugin system features.

+

If it's still not working, please open an issue.

+

Hooks

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HooksDescription
render_headerAllow plugin to add content in page headers.
render_includesAllow plugin to include their own CSS files.
render_footerAllow plugin to add content in page footer and include their own JS files.
render_linklistIt allows to add content at the begining and end of the page, after every link displayed and to alter link data.
render_editlinkAllow to add fields in the form, or display elements.
render_toolsAllow to add content at the end of the page.
render_picwallAllow to add content at the top and bottom of the page.
render_tagcloudAllow to add content at the top and bottom of the page, and after all tags.
render_taglistAllow to add content at the top and bottom of the page, and after all tags.
render_dailyAllow to add content at the top and bottom of the page, the bottom of each link and to alter data.
render_feedAllow to do add tags in RSS and ATOM feeds.
save_linkAllow to alter the link being saved in the datastore.
delete_linkAllow to do an action before a link is deleted from the datastore.
+

render_header

+

Triggered on every page.

+

Allow plugin to add content in page headers.

+
Data
+

$data is an array containing:

+
    +
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • buttons_toolbar: after the list of buttons in the header.
    • +
+

buttons_toolbar_example

+
    +
  • fields_toolbar: after search fields in the header.
    • +
+
+

Note: This will only be called in linklist.

+
+

fields_toolbar_example

+

render_includes

+

Triggered on every page.

+

Allow plugin to include their own CSS files.

+
Data
+

$data is an array containing:

+
    +
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • css_files: called after loading default CSS.
    • +
+
+

Note: only add the path of the CSS file. E.g: plugins/demo_plugin/custom_demo.css.

+
+ +

Triggered on every page.

+

Allow plugin to add content in page footer and include their own JS files.

+
Data
+

$data is an array containing:

+
    +
  • _PAGE_: current target page (eg: linklist, picwall, etc.).
    • +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • text: called after the end of the footer text.
    • +
  • endofpage: called at the end of the page.
    • +
+

text_example

+
    +
  • js_files: called at the end of the page, to include custom JS scripts.
    • +
+
+

Note: only add the path of the JS file. E.g: plugins/demo_plugin/custom_demo.js.

+
+ +

Triggered when linklist is displayed (list of links, permalink, search, tag filtered, etc.).

+

It allows to add content at the begining and end of the page, after every link displayed and to alter link data.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • All templates data, including links.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • action_plugin: next to the button "private only" at the top and bottom of the page.
    • +
+

action_plugin_example

+
    +
  • link_plugin: for every link, between permalink and link URL.
    • +
+

link_plugin_example

+
    +
  • plugin_start_zone: before displaying the template content.
    • +
+

plugin_start_zone_example

+
    +
  • plugin_end_zone: after displaying the template content.
    • +
+

plugin_end_zone_example

+ +

Triggered when the link edition form is displayed.

+

Allow to add fields in the form, or display elements.

+
Data
+

$data is an array containing:

+
    +
  • All templates data.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • edit_link_plugin: after tags field.
    • +
+

edit_link_plugin_example

+

render_tools

+

Triggered when the "tools" page is displayed.

+

Allow to add content at the end of the page.

+
Data
+

$data is an array containing:

+
    +
  • All templates data.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • tools_plugin: at the end of the page.
    • +
+

tools_plugin_example

+

render_picwall

+

Triggered when picwall is displayed.

+

Allow to add content at the top and bottom of the page.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • All templates data.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • +

    plugin_start_zone: before displaying the template content.

    +
    • +
  • +

    plugin_end_zone: after displaying the template content.

    +
    • +
+

plugin_start_end_zone_example

+

render_tagcloud

+

Triggered when tagcloud is displayed.

+

Allow to add content at the top and bottom of the page.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • All templates data.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • +

    plugin_start_zone: before displaying the template content.

    +
    • +
  • +

    plugin_end_zone: after displaying the template content.

    +
    • +
+

For each tag, the following placeholder can be used:

+
    +
  • tag_plugin: after each tag
    • +
+

plugin_start_end_zone_example

+

render_taglist

+

Triggered when taglist is displayed.

+

Allow to add content at the top and bottom of the page.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • All templates data.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • +

    plugin_start_zone: before displaying the template content.

    +
    • +
  • +

    plugin_end_zone: after displaying the template content.

    +
    • +
+

For each tag, the following placeholder can be used:

+
    +
  • tag_plugin: after each tag
    • +
+

render_daily

+

Triggered when tagcloud is displayed.

+

Allow to add content at the top and bottom of the page, the bottom of each link and to alter data.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • All templates data, including links.
    • +
+
Template placeholders
+

Items can be displayed in templates by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • link_plugin: used at bottom of each link.
    • +
+

link_plugin_example

+
    +
  • +

    plugin_start_zone: before displaying the template content.

    +
    • +
  • +

    plugin_end_zone: after displaying the template content.

    +
    • +
+

render_feed

+

Triggered when the ATOM or RSS feed is displayed.

+

Allow to add tags in the feed, either in the header or for each items. Items (links) can also be altered before being rendered.

+
Data
+

$data is an array containing:

+
    +
  • _LOGGEDIN_: true if user is logged in, false otherwise.
    • +
  • _PAGE_: containing either rss or atom.
    • +
  • All templates data, including links.
    • +
+
Template placeholders
+

Tags can be added in feeds by adding an entry in $data['<placeholder>'] array.

+

List of placeholders:

+
    +
  • feed_plugins_header: used as a header tag in the feed.
    • +
+

For each links:

+
    +
  • feed_plugins: additional tag for every link entry.
    • +
+ +

Triggered when a link is save (new link or edit).

+

Allow to alter the link being saved in the datastore.

+
Data
+

$data is an array containing the link being saved:

+
    +
  • id
    • +
  • title
    • +
  • url
    • +
  • shorturl
    • +
  • description
    • +
  • private
    • +
  • tags
    • +
  • created
    • +
  • updated
    • +
+ +

Triggered when a link is deleted.

+

Allow to execute any action before the link is actually removed from the datastore

+
Data
+

$data is an array containing the link being saved:

+
    +
  • id
    • +
  • title
    • +
  • url
    • +
  • shorturl
    • +
  • description
    • +
  • private
    • +
  • tags
    • +
  • created
    • +
  • updated
    • +
+

Guide for template designer

+

Plugin administration

+

Your theme must include a plugin administration page: pluginsadmin.html.

+
+

Note: repo's template link needs to be added when the PR is merged.

+
+

Use the default one as an example.

+

Aside from classic RainTPL loops, plugins order is handle by JavaScript. You can just include plugin_admin.js, only if:

+
    +
  • you're using a table.
    • +
  • you call orderUp() and orderUp() onclick on arrows.
    • +
  • you add data-line and data-order to your rows.
    • +
+

Otherwise, you can use your own JS as long as this field is send by the form:

+

+

Placeholder system

+

In order to make plugins work with every custom themes, you need to add variable placeholder in your templates.

+

It's a RainTPL loop like this:

+
{loop="$plugin_variable"}
+    {$value}
+{/loop}
+
+

You should enable demo_plugin for testing purpose, since it uses every placeholder available.

+

List of placeholders

+

page.header.html

+

At the end of the menu:

+
{loop="$plugins_header.buttons_toolbar"}
+    {$value}
+{/loop}
+
+

At the end of file, before clearing floating blocks:

+
{if="!empty($plugin_errors) && isLoggedIn()"}
+    <ul class="errors">
+        {loop="plugin_errors"}
+            <li>{$value}</li>
+        {/loop}
+    </ul>
+{/if}
+
+

includes.html

+

At the end of the file:

+
{loop="$plugins_includes.css_files"}
+<link type="text/css" rel="stylesheet" href="{$value}#"/>
+{/loop}
+
+ +

page.footer.html

+

At the end of your footer notes:

+
{loop="$plugins_footer.text"}
+     {$value}
+{/loop}
+
+ +

At the end of file:

+
{loop="$plugins_footer.js_files"}
+     <script src="{$value}#"></script>
+{/loop}
+
+ +

linklist.html

+

After search fields:

+
{loop="$plugins_header.fields_toolbar"}
+     {$value}
+{/loop}
+
+ +

Before displaying the link list (after paging):

+
{loop="$plugin_start_zone"}
+     {$value}
+{/loop}
+
+ +

For every links (icons):

+
{loop="$value.link_plugin"}
+    <span>{$value}</span>
+{/loop}
+
+ +

Before end paging:

+
{loop="$plugin_end_zone"}
+     {$value}
+{/loop}
+
+ +

linklist.paging.html

+

After the "private only" icon:

+
{loop="$action_plugin"}
+     {$value}
+{/loop}
+
+ +

editlink.html

+

After tags field:

+
{loop="$edit_link_plugin"}
+     {$value}
+{/loop}
+
+ +

tools.html

+

After the last tool:

+
{loop="$tools_plugin"}
+     {$value}
+{/loop}
+
+ +

picwall.html

+

Top:

+
<div id="plugin_zone_start_picwall" class="plugin_zone">
+    {loop="$plugin_start_zone"}
+        {$value}
+    {/loop}
+</div>
+
+ +

Bottom:

+
<div id="plugin_zone_end_picwall" class="plugin_zone">
+    {loop="$plugin_end_zone"}
+        {$value}
+    {/loop}
+</div>
+
+ +

tagcloud.html

+

Top:

+
   <div id="plugin_zone_start_tagcloud" class="plugin_zone">
+        {loop="$plugin_start_zone"}
+            {$value}
+        {/loop}
+    </div>
+
+ +

Bottom:

+
    <div id="plugin_zone_end_tagcloud" class="plugin_zone">
+        {loop="$plugin_end_zone"}
+            {$value}
+        {/loop}
+    </div>
+
+ +

daily.html

+

Top:

+
<div id="plugin_zone_start_picwall" class="plugin_zone">
+     {loop="$plugin_start_zone"}
+         {$value}
+     {/loop}
+</div>
+
+ +

After every link:

+
<div class="dailyEntryFooter">
+     {loop="$link.link_plugin"}
+          {$value}
+     {/loop}
+</div>
+
+ +

Bottom:

+
<div id="plugin_zone_end_picwall" class="plugin_zone">
+    {loop="$plugin_end_zone"}
+        {$value}
+    {/loop}
+</div>
+
+ +

feed.atom.xml and feed.rss.xml:

+

In headers tags section:

+
{loop="$feed_plugins_header"}
+  {$value}
+{/loop}
+
+ +

After each entry:

+
{loop="$value.feed_plugins"}
+  {$value}
+{/loop}
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Plugins/index.html b/doc/html/Plugins/index.html new file mode 100644 index 00000000..3a30e93c --- /dev/null +++ b/doc/html/Plugins/index.html @@ -0,0 +1,414 @@ + + + + + + + + + + + Plugins - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Plugin installation

+

There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.

+

If you want to install a third party plugin:

+
    +
  • Download it.
    • +
  • Put it in the plugins directory in Shaarli's installation folder.
    • +
  • Make sure you put it correctly:
    • +
+
| index.php
+| plugins/
+|---| custom_plugin/
+|   |---| custom_plugin.php
+|   |---| ...
+
+
+ +
    +
  • Make sure your webserver can read and write the files in your plugin folder.
    • +
+

Plugin configuration

+

In Shaarli's administration page (Tools link), go to Plugin administration.

+

Here you can enable and disable all plugins available, and configure them.

+

administration screenshot

+

Plugin order

+

In the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first.

+

This is important in case plugins are depending on each other. Read plugins README details for more information.

+

Use case: The (non existent) plugin shaares_footer adds a footer to every shaare in Markdown syntax. It needs to be processed before (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.

+

File mode

+

Enabled plugin are stored in your config.php parameters file, under the array:

+
$GLOBALS['config']['ENABLED_PLUGINS']
+
+ +

You can edit them manually here. +Example:

+
$GLOBALS['config']['ENABLED_PLUGINS'] = array(
+    'qrcode', 
+    'archiveorg',
+    'wallabag',
+    'markdown',
+);
+
+ +

Plugin usage

+

Official plugins

+

Usage of each plugin is documented in it's README file:

+
    +
  • addlink-toolbar: Adds the addlink input on the linklist page
    • +
  • archiveorg: For each link, add an Archive.org icon
    • +
  • markdown: Render shaare description with Markdown syntax.
    • +
  • playvideos: Add a button in the toolbar allowing to watch all videos.
    • +
  • qrcode: For each link, add a QRCode icon.
    • +
  • wallabag: For each link, add a Wallabag icon to save it in your instance.
    • +
+

Third party plugins

+

See Community & related software

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/REST-API/index.html b/doc/html/REST-API/index.html new file mode 100644 index 00000000..2c244bca --- /dev/null +++ b/doc/html/REST-API/index.html @@ -0,0 +1,431 @@ + + + + + + + + + + + REST API - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Usage

+

See the REST API documentation.

+

Authentication

+

All requests to Shaarli's API must include a JWT token to verify their authenticity.

+

This token has to be included as an HTTP header called Authentication: Bearer <jwt token>.

+

JWT resources :

+
    +
  • jwt.io (including a list of client per language).
    • +
  • RFC : https://tools.ietf.org/html/rfc7519
    • +
  • https://float-middle.com/json-web-tokens-jwt-vs-sessions/
    • +
  • HackerNews thread: https://news.ycombinator.com/item?id=11929267
    • +
+

Shaarli JWT Token

+

JWT tokens are composed by three parts, separated by a dot . and encoded in base64:

+
[header].[payload].[signature]
+
+ + +

Shaarli only allow one hash algorithm, so the header will always be the same:

+
{
+    "typ": "JWT",
+    "alg": "HS512"
+}
+
+ +

Encoded in base64, it gives:

+
ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==
+
+ +

Payload

+

Validity duration

+

To avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key iat (issued at). This token will be accepted during 9 minutes.

+
{
+    "iat": 1468663519
+}
+
+ +

See RFC reference.

+

Signature

+

The signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot ., hashed in SHA512 with the API secret available in Shaarli administration page.

+

Signature example with PHP:

+
$content = base64_encode($header) . '.' . base64_encode($payload);
+$signature = hash_hmac('sha512', $content, $secret);
+
+ +

Complete example

+

PHP

+
function generateToken($secret) {
+    $header = base64_encode('{
+        "typ": "JWT",
+        "alg": "HS512"
+    }');
+    $payload = base64_encode('{
+        "iat": '. time() .'
+    }');
+    $signature = hash_hmac('sha512', $header .'.'. $payload , $secret);
+    return $header .'.'. $payload .'.'. $signature;
+}
+
+$secret = 'mysecret';
+$token = generateToken($secret);
+echo $token;
+
+ +
+

ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68

+
+
$options = [
+    'http' => [
+        'method' => 'GET',
+        'jwt' => $token,
+    ],
+];
+$context = stream_context_create($options);
+file_get_contents($apiEndpoint, false, $context);
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/RSS-feeds/index.html b/doc/html/RSS-feeds/index.html new file mode 100644 index 00000000..bb6e412c --- /dev/null +++ b/doc/html/RSS-feeds/index.html @@ -0,0 +1,367 @@ + + + + + + + + + + + RSS feeds - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Feeds options

+

Feeds are available in ATOM with ?do=atom and RSS with do=RSS.

+

Options: +- You can use permalinks in the feed URL to get permalink to Shaares instead of direct link to shaared URL. + - E.G. https://my.shaarli.domain/?do=atom&permalinks. +- You can use nb parameter in the feed URL to specify the number of Shaares you want in a feed (default if not specified: 50). The keyword all is available if you want everything. + - https://my.shaarli.domain/?do=atom&permalinks&nb=42 + - https://my.shaarli.domain/?do=atom&permalinks&nb=all

+

RSS Feeds or Picture Wall for a specific search/tag

+

It is possible to filter RSS/ATOM feeds and Picture Wall on a Shaarli to only display results of a specific search, or for a specific tag.

+

For example, if you want to subscribe only to links tagged photography: +- Go to the desired Shaarli instance. +- Search for the photography tag in the Filter by tag box. Links tagged photography are displayed. +- Click on the RSS Feed button. +- You are presented with an RSS feed showing only these links. Subscribe to it to receive only updates with this tag. +- The same method also works for a full-text search (Search box) and for the Picture Wall (want to only see pictures about nature?) +- You can also build the URLs manually: + - https://my.shaarli.domain/?do=rss&searchtags=nature + - https://my.shaarli.domain/links/?do=picwall&searchterm=poney

+

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Release-Shaarli/index.html b/doc/html/Release-Shaarli/index.html new file mode 100644 index 00000000..cf5fcee8 --- /dev/null +++ b/doc/html/Release-Shaarli/index.html @@ -0,0 +1,529 @@ + + + + + + + + + + + Release Shaarli - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

See Git - Maintaining a project - Tagging your +releases.

+

Prerequisites

+

This guide assumes that you have: +- a GPG key matching your GitHub authentication credentials + - i.e., the email address identified by the GPG key is the same as the one in your ~/.gitconfig +- a GitHub fork of Shaarli +- a local clone of your Shaarli fork, with the following remotes: + - origin pointing to your GitHub fork + - upstream pointing to the main Shaarli repository +- maintainer permissions on the main Shaarli repository, to: + - push the signed tag + - create a new release +- Composer and Pandoc need to be installed

+

GitHub release draft and CHANGELOG.md

+

See http://keepachangelog.com/en/0.3.0/ for changelog formatting.

+

GitHub release draft

+

GitHub allows drafting the release note for the upcoming release, from the Releases page. This way, the release note can be drafted while contributions are merged to master.

+

CHANGELOG.md

+

This file should contain the same information as the release note draft for the upcoming version.

+

Update it to: +- add new entries (additions, fixes, etc.) +- mark the current version as released by setting its date and link +- add a new section for the future unreleased version

+
$ cd /path/to/shaarli
+
+$ nano CHANGELOG.md
+
+[...]
+## vA.B.C - UNRELEASED
+TBA
+
+## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD
+[...]
+
+ +

Increment the version code, updated docs, create and push a signed tag

+

Generate documentation

+
$ cd /path/to/shaarli
+
+# create a new branch
+$ git fetch upstream
+$ git checkout upstream/master -b v0.5.0
+
+# rebuild the documentation from the wiki
+$ make htmldoc
+
+# commit the changes
+$ git add doc
+$ git commit -s -m "Generate documentation for v0.5.0"
+
+# push the commit on your GitHub fork
+$ git push origin v0.5.0
+
+ +

Create and merge a Pull Request

+

This one is pretty straightforward ;-)

+

Bump Shaarli version to v0.x branch

+
$ git checkout master
+$ git fetch upstream
+$ git pull upstream master
+
+# IF the branch doesn't exists
+$ git checkout -b v0.5
+# OR if the branch already exists
+$ git checkout v0.5
+$ git rebase upstream/master
+
+# Bump shaarli version from dev to 0.5.0, **without the `v`**
+$ vim shaarli_version.php
+$ git add shaarli_version
+$ git commit -s -m "Bump Shaarli version to v0.5.0"
+$ git push upstream v0.5
+
+ +

Create and push a signed tag

+
# update your local copy
+$ git checkout v0.5
+$ git fetch upstream
+$ git pull upstream v0.5
+
+# create a signed tag
+$ git tag -s -m "Release v0.5.0" v0.5.0
+
+# push it to "upstream"
+$ git push --tags upstream
+
+ +

Verify a signed tag

+

v0.5.0 is the first GPG-signed tag pushed on the Community Shaarli.

+

Let's have a look at its signature!

+
$ cd /path/to/shaarli
+$ git fetch upstream
+
+# get the SHA1 reference of the tag
+$ git show-ref tags/v0.5.0
+f7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0
+
+# verify the tag signature information
+$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1
+gpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F
+gpg: Good signature from "VirtualTam <virtualtam@flibidi.net>" [ultimate]
+
+ +

Publish the GitHub release

+

Update release badges

+

Update README.md so version badges display and point to the newly released Shaarli version(s), in the master branch.

+

Create a GitHub release from a Git tag

+

From the previously drafted release: +- edit the release notes (if needed) +- specify the appropriate Git tag +- publish the release +- profit!

+

Generate and upload all-in-one release archives

+

Users with a shared hosting may have: +- no SSH access +- no possibility to install PHP packages or server extensions +- no possibility to run scripts

+

To ease Shaarli installations, it is possible to generate and upload additional release archives, +that will contain Shaarli code plus all required third-party libraries.

+

From the v0.5 branch:

+
$ make release_archive
+
+ +

This will create the following archives: +- shaarli-vX.Y.Z-full.tar +- shaarli-vX.Y.Z-full.zip

+

The archives need to be manually uploaded on the previously created GitHub release.

+

Update stable and latest branches

+
$ git checkout latest
+# latest release
+$ git merge v0.5.0
+# fix eventual conflicts
+$ make test
+$ git push upstream latest
+$ git checkout stable
+# latest previous major
+$ git merge v0.4.5 
+# fix eventual conflicts
+$ make test
+$ git push upstream stable
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Reverse-proxy-configuration/index.html b/doc/html/Reverse-proxy-configuration/index.html new file mode 100644 index 00000000..bebd663f --- /dev/null +++ b/doc/html/Reverse-proxy-configuration/index.html @@ -0,0 +1,350 @@ + + + + + + + + + + + Reverse proxy configuration - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

TODO, see https://github.com/shaarli/Shaarli/issues/888

+

HAProxy

+

Nginx

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Security/index.html b/doc/html/Security/index.html new file mode 100644 index 00000000..19b569e6 --- /dev/null +++ b/doc/html/Security/index.html @@ -0,0 +1,386 @@ + + + + + + + + + + + Security - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Client browser

+
    +
  • Shaarli relies on HTTP_REFERER for some functions (like redirects and clicking on tags). If you have disabled or masqueraded HTTP_REFERER in your browser, some features of Shaarli may not work
    • +
+

PHP

+
    +
  • magic_quotes is an horrible option of PHP which is often activated on servers. No serious developer should rely on this horror to secure their code against SQL injections. You should disable it (and Shaarli expects this option to be disabled). Nevertheless, I have added code to cope with magic_quotes on, so you should not be bothered even on crappy hosts.
    • +
+

Server and sessions

+
    +
  • Directories are protected using .htaccess files
    • +
  • Forms are protected against XSRF (Cross-site requests forgery):
    • +
  • Forms which act on data (save,delete…) contain a token generated by the server.
    • +
  • Any posted form which does not contain a valid token is rejected.
    • +
  • Any token can only be used once.
    • +
  • Tokens are attached to the session and cannot be reused in another session.
    • +
  • Sessions automatically expire after 60 minutes.
    • +
  • Sessions are protected against hijacking: the session ID cannot be used from a different IP address.
    • +
+

Shaarli datastore and configuration

+
    +
  • The password is salted, hashed and stored in the data subdirectory, in a PHP file, and protected by htaccess. Even if the webserver does not support htaccess, the hash is not readable by URL. Even if the .php file is stolen, the password cannot deduced from the hash. The salt prevents rainbow-tables attacks.
    • +
  • Links are stored as an associative array which is serialized, compressed (with deflate), base64-encoded and saved as a comment in a .php file.
    • +
  • Even if the server does not support .htaccess files, the data file will still not be readable by URL.
    • +
  • The database looks like this:
    • +
+
<?php /* zP1ZjxxJtiYIvvevEPJ2lDOaLrZv7o...
+...ka7gaco/Z+TFXM2i7BlfMf8qxpaSSYfKlvqv/x8= */ ?>
+
+ +
    +
  • Small hashes are used to make a link to an entry in Shaarli. They are unique. In fact, the date of the items (eg. 20110923_150523) is hashed with CRC32, then converted to base64 and some characters are replaced. They are always 6 characters longs and use only A-Z a-z 0-9 - _ and @.
    • +
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Server-configuration/index.html b/doc/html/Server-configuration/index.html new file mode 100644 index 00000000..beb8cd08 --- /dev/null +++ b/doc/html/Server-configuration/index.html @@ -0,0 +1,747 @@ + + + + + + + + + + + Server configuration - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Example virtual host configurations for popular web servers

+ +

Prerequisites

+

Shaarli

+
    +
  • Shaarli is installed in a directory readable/writeable by the user
    • +
  • the correct read/write permissions have been granted to the web server user and/or group
    • +
  • for HTTPS / SSL:
    • +
  • a key pair (public, private) and a certificate have been generated
    • +
  • the appropriate server SSL extension is installed and active
    • +
+

HTTPS, TLS and self-signed certificates

+

Related guides: + How to Create Self-Signed SSL Certificates with OpenSSL + How do I create my own Certificate Authority? +* Generate a self-signed certificate (will trigger browser warnings) with apache2: make-ssl-cert generate-default-snakeoil --force-overwrite will create /etc/ssl/certs/ssl-cert-snakeoil.pem and /etc/ssl/private/ssl-cert-snakeoil.key

+

Proxies

+

If Shaarli is served behind a proxy (i.e. there is a proxy server between clients and the web server hosting Shaarli), please refer to the proxy server documentation for proper configuration. In particular, you have to ensure that the following server variables are properly set: +- X-Forwarded-Proto; +- X-Forwarded-Host; +- X-Forwarded-For.

+

See also proxy-related issues.

+

Apache

+

Minimal

+
<VirtualHost *:80>
+    ServerName   shaarli.my-domain.org
+    DocumentRoot /absolute/path/to/shaarli/
+</VirtualHost>
+
+ +

Debug - Log all the things!

+

This configuration will log both Apache and PHP errors, which may prove useful to identify server configuration errors.

+

See: + Apache/PHP - error log per VirtualHost (StackOverflow) + PHP: php_value vs php_admin_value and the use of php_flag explained

+
<VirtualHost *:80>
+    ServerName   shaarli.my-domain.org
+    DocumentRoot /absolute/path/to/shaarli/
+
+    LogLevel  warn
+    ErrorLog  /var/log/apache2/shaarli-error.log
+    CustomLog /var/log/apache2/shaarli-access.log combined
+
+    php_flag  log_errors on
+    php_flag  display_errors on
+    php_value error_reporting 2147483647
+    php_value error_log /var/log/apache2/shaarli-php-error.log
+</VirtualHost>
+
+ +

Standard - Keep access and error logs

+
<VirtualHost *:80>
+    ServerName   shaarli.my-domain.org
+    DocumentRoot /absolute/path/to/shaarli/
+
+    LogLevel  warn
+    ErrorLog  /var/log/apache2/shaarli-error.log
+    CustomLog /var/log/apache2/shaarli-access.log combined
+</VirtualHost>
+
+ +

Paranoid - Redirect HTTP (:80) to HTTPS (:443)

+

See Server-side TLS (Mozilla).

+
<VirtualHost *:443>
+    ServerName   shaarli.my-domain.org
+    DocumentRoot /absolute/path/to/shaarli/
+
+    SSLEngine             on
+    SSLCertificateFile    /absolute/path/to/the/website/certificate.pem
+    SSLCertificateKeyFile /absolute/path/to/the/website/key.key
+
+    <Directory /absolute/path/to/shaarli/>
+        AllowOverride All
+        Options Indexes FollowSymLinks MultiViews
+        Order allow,deny
+        allow from all
+    </Directory>
+
+    LogLevel  warn
+    ErrorLog  /var/log/apache2/shaarli-error.log
+    CustomLog /var/log/apache2/shaarli-access.log combined
+</VirtualHost>
+<VirtualHost *:80>
+    ServerName   shaarli.my-domain.org
+    Redirect 301 / https://shaarli.my-domain.org
+
+    LogLevel  warn
+    ErrorLog  /var/log/apache2/shaarli-error.log
+    CustomLog /var/log/apache2/shaarli-access.log combined
+</VirtualHost>
+
+ +

.htaccess

+

Shaarli use .htaccess Apache files to deny access to files that shouldn't be directly accessed (datastore, config, etc.). You need the directive AllowOverride All in your virtual host configuration for them to work.

+

Warning: If you use Apache 2.2 or lower, you need mod_version to be installed and enabled.

+

Apache module mod_rewrite must be enabled to use the REST API. URL rewriting rules for the Slim microframework are stated in the root .htaccess file.

+

LightHttpd

+

Nginx

+

Foreword

+

Nginx does not natively interpret PHP scripts; to this effect, we will run a FastCGI service, to which Nginx's FastCGI module will proxy all requests to PHP resources.

+

Required packages: +- nginx +- php-fpm - PHP FastCGI Process Manager

+

Official documentation: +- Beginner's guide +- ngx_http_fastcgi_module +- Pitfalls

+

Community resources: +- Server-side TLS (Nginx) (Mozilla) +- PHP configuration examples (Karl Blessing)

+

Common setup

+

Once Nginx and PHP-FPM are installed, we need to ensure: +- Nginx and PHP-FPM are running using the same user and group +- both these user and group have + - read permissions for Shaarli resources + - execute permissions for Shaarli directories AND their parent directories

+

On a production server: +- user:group will likely be http:http, www:www or www-data:www-data +- files will be located under /var/www, /var/http or /usr/share/nginx

+

On a development server: +- files may be located in a user's home directory +- in this case, make sure both Nginx and PHP-FPM are running as the local user/group!

+

For all following configuration examples, this user/group pair will be used: +- user:group = john:users,

+

which corresponds to the following service configuration:

+
; /etc/php/php-fpm.conf
+user = john
+group = users
+
+[...]
+listen.owner = john
+listen.group = users
+
+ +
# /etc/nginx/nginx.conf
+user john users;
+
+http {
+    [...]
+}
+
+ +

(Optional) Increase the maximum file upload size

+

Some bookmark dumps generated by web browsers can be huge due to the presence of Base64-encoded images and favicons, as well as extra verbosity when nesting links in (sub-)folders.

+

To increase upload size, you will need to modify both nginx and PHP configuration:

+
# /etc/nginx/nginx.conf
+
+http {
+    [...]
+
+    client_max_body_size 10m;
+
+    [...]
+}
+
+ +
# /etc/php5/fpm/php.ini
+
+[...]
+post_max_size = 10M
+[...]
+upload_max_filesize = 10M
+
+ +

Minimal

+

WARNING: Use for development only!

+
user john users;
+worker_processes  1;
+events {
+    worker_connections  1024;
+}
+
+http {
+    include            mime.types;
+    default_type       application/octet-stream;
+    keepalive_timeout  20;
+
+    index index.html index.php;
+
+    server {
+        listen       80;
+        server_name  localhost;
+        root         /home/john/web;
+
+        access_log  /var/log/nginx/access.log;
+        error_log   /var/log/nginx/error.log;
+
+        location /shaarli/ {
+            try_files $uri /shaarli/index.php$is_args$args;
+            access_log  /var/log/nginx/shaarli.access.log;
+            error_log   /var/log/nginx/shaarli.error.log;
+        }
+
+        location ~ (index)\.php$ {
+            try_files $uri =404;
+            fastcgi_split_path_info ^(.+\.php)(/.+)$;
+            fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
+            fastcgi_index  index.php;
+            include        fastcgi.conf;
+        }
+    }
+}
+
+ +

Modular

+

The previous setup is sufficient for development purposes, but has several major caveats: +- every content that does not match the PHP rule will be sent to client browsers: + - dotfiles - in our case, .htaccess + - temporary files, e.g. Vim or Emacs files: index.php~ +- asset / static resource caching is not optimized +- if serving several PHP sites, there will be a lot of duplication: location /shaarli/, location /mysite/, etc.

+

To solve this, we will split Nginx configuration in several parts, that will be included when needed:

+
# /etc/nginx/deny.conf
+location ~ /\. {
+    # deny access to dotfiles
+    access_log off;
+    log_not_found off;
+    deny all;
+}
+
+location ~ ~$ {
+    # deny access to temp editor files, e.g. "script.php~"
+    access_log off;
+    log_not_found off;
+    deny all;
+}
+
+ +
# /etc/nginx/php.conf
+location ~ (index)\.php$ {
+    # Slim - split URL path into (script_filename, path_info)
+    try_files $uri =404;
+    fastcgi_split_path_info ^(.+\.php)(/.+)$;
+
+    # filter and proxy PHP requests to PHP-FPM
+    fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
+    fastcgi_index  index.php;
+    include        fastcgi.conf;
+}
+
+location ~ \.php$ {
+    # deny access to all other PHP scripts
+    deny all;
+}
+
+ +
# /etc/nginx/static_assets.conf
+location ~* \.(?:ico|css|js|gif|jpe?g|png)$ {
+    expires    max;
+    add_header Pragma public;
+    add_header Cache-Control "public, must-revalidate, proxy-revalidate";
+}
+
+ +
# /etc/nginx/nginx.conf
+[...]
+
+http {
+    [...]
+
+    root        /home/john/web;
+    access_log  /var/log/nginx/access.log;
+    error_log   /var/log/nginx/error.log;
+
+    server {
+        # virtual host for a first domain
+        listen       80;
+        server_name  my.first.domain.org;
+
+        location /shaarli/ {
+            # Slim - rewrite URLs
+            try_files $uri /shaarli/index.php$is_args$args;
+
+            access_log  /var/log/nginx/shaarli.access.log;
+            error_log   /var/log/nginx/shaarli.error.log;
+        }
+
+        location = /shaarli/favicon.ico {
+            # serve the Shaarli favicon from its custom location
+            alias /var/www/shaarli/images/favicon.ico;
+        }
+
+        include deny.conf;
+        include static_assets.conf;
+        include php.conf;
+    }
+
+    server {
+        # virtual host for a second domain
+        listen       80;
+        server_name  second.domain.com;
+
+        location /minigal/ {
+            access_log  /var/log/nginx/minigal.access.log;
+            error_log   /var/log/nginx/minigal.error.log;
+        }
+
+        include deny.conf;
+        include static_assets.conf;
+        include php.conf;
+    }
+}
+
+ +

Redirect HTTP to HTTPS

+

Assuming you have generated a (self-signed) key and certificate, and they are located under /home/john/ssl/localhost.{key,crt}, it is pretty straightforward to set an HTTP (:80) to HTTPS (:443) redirection to force SSL/TLS usage.

+
# /etc/nginx/nginx.conf
+[...]
+
+http {
+    [...]
+
+    index index.html index.php;
+
+    root        /home/john/web;
+    access_log  /var/log/nginx/access.log;
+    error_log   /var/log/nginx/error.log;
+
+    server {
+        listen       80;
+        server_name  localhost;
+
+        return 301 https://localhost$request_uri;
+    }
+
+    server {
+        listen       443 ssl;
+        server_name  localhost;
+
+        ssl_certificate      /home/john/ssl/localhost.crt;
+        ssl_certificate_key  /home/john/ssl/localhost.key;
+
+        location /shaarli/ {
+            # Slim - rewrite URLs
+            try_files $uri /index.php$is_args$args;
+
+            access_log  /var/log/nginx/shaarli.access.log;
+            error_log   /var/log/nginx/shaarli.error.log;
+        }
+
+        location = /shaarli/favicon.ico {
+            # serve the Shaarli favicon from its custom location
+            alias /var/www/shaarli/images/favicon.ico;
+        }
+
+        include deny.conf;
+        include static_assets.conf;
+        include php.conf;
+    }
+}
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Server-requirements/index.html b/doc/html/Server-requirements/index.html new file mode 100644 index 00000000..ab1b0d35 --- /dev/null +++ b/doc/html/Server-requirements/index.html @@ -0,0 +1,475 @@ + + + + + + + + + + + Server requirements - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

PHP

+

Release information

+ +

Supported versions

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionStatusShaarli compatibility
7.1Supported (v0.9.x):white_check_mark:
7.0Supported:white_check_mark:
5.6Supported:white_check_mark:
5.5EOL: 2016-07-10:white_check_mark:
5.4EOL: 2015-09-14:white_check_mark: (up to Shaarli 0.8.x)
5.3EOL: 2014-08-14:white_check_mark: (up to Shaarli 0.8.x)
+

See also: +- Travis configuration

+

Dependency management

+

Starting with Shaarli v0.8.x, Composer is used to resolve, +download and install third-party PHP dependencies.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
LibraryRequired?Usage
shaarli/netscape-bookmark-parserAllImport bookmarks from Netscape files
erusev/parsedownAllParse MarkDown syntax for the MarkDown plugin
slim/slimAllHandle routes and middleware for the REST API
+

Extensions

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ExtensionRequired?Usage
opensslAllOpenSSL, HTTPS
php-mbstringCentOS, Fedora, RHEL, Windowsmultibyte (Unicode) string support
php-gdoptionalthumbnail resizing
php-intloptionallocalized text sorting (e.g. e->è->f)
php-curloptionalusing cURL for fetching webpages and thumbnails in a more robust way
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Server-security/index.html b/doc/html/Server-security/index.html new file mode 100644 index 00000000..dbe99515 --- /dev/null +++ b/doc/html/Server-security/index.html @@ -0,0 +1,429 @@ + + + + + + + + + + + Server security - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

php.ini

+

PHP settings are defined in: +- a main configuration file, usually found under /etc/php5/php.ini; some distributions provide different configuration environments, e.g. + - /etc/php5/php.ini - used when running console scripts + - /etc/php5/apache2/php.ini - used when a client requests PHP resources from Apache + - /etc/php5/php-fpm.conf - used when PHP requests are proxied to PHP-FPM +- additional configuration files/entries, depending on the installed/enabled extensions: + - /etc/php/conf.d/xdebug.ini

+

Locate .ini files

+

Console environment

+
$ php --ini
+Configuration File (php.ini) Path: /etc/php
+Loaded Configuration File:         /etc/php/php.ini
+Scan for additional .ini files in: /etc/php/conf.d
+Additional .ini files parsed:      /etc/php/conf.d/xdebug.ini
+
+ +

Server environment

+
    +
  • create a phpinfo.php script located in a path supported by the web server, e.g.
      +
    • Apache (with user dirs enabled): /home/myself/public_html/phpinfo.php
      • +
    • /var/www/test/phpinfo.php
      • +
    +
    • +
  • make sure the script is readable by the web server user/group (usually, www, www-data or httpd)
    • +
  • access the script from a web browser
    • +
  • look at the Loaded Configuration File and Scan this dir for additional .ini files entries
    • +
+
<?php phpinfo(); ?>
+
+ +

fail2ban

+

fail2ban is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses iptables profiles to block brute-force attempts: +- Official website +- Source code

+

Read Shaarli logs to ban IPs

+

Example configuration: +- allow 3 login attempts per IP address +- after 3 failures, permanently ban the corresponding IP adddress

+

/etc/fail2ban/jail.local

+
[shaarli-auth]
+enabled  = true
+port     = https,http
+filter   = shaarli-auth
+logpath  = /var/www/path/to/shaarli/data/log.txt
+maxretry = 3
+bantime = -1
+
+ +

/etc/fail2ban/filter.d/shaarli-auth.conf

+
[INCLUDES]
+before = common.conf
+[Definition]
+failregex = \s-\s<HOST>\s-\sLogin failed for user.*$
+ignoreregex = 
+
+ +

Robots - Restricting search engines and web crawler traffic

+

Creating a robots.txt with the following contents at the root of your Shaarli installation will prevent honest web crawlers from indexing each and every link and Daily page from a Shaarli instance, thus getting rid of a certain amount of unsollicited network traffic.

+
User-agent: *
+Disallow: /
+
+ +

See: +- http://www.robotstxt.org/ +- http://www.robotstxt.org/robotstxt.html +- http://www.robotstxt.org/meta.html

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Shaarli-configuration/index.html b/doc/html/Shaarli-configuration/index.html new file mode 100644 index 00000000..95a487d0 --- /dev/null +++ b/doc/html/Shaarli-configuration/index.html @@ -0,0 +1,563 @@ + + + + + + + + + + + Shaarli configuration - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Foreword

+

Do not edit configuration options in index.php! Your changes would be lost.

+

Once your Shaarli instance is installed, the file data/config.json.php is generated: + it contains all settings in JSON format, and can be edited to customize values + it defines which plugins are enabled + its values override those defined in index.php + it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration

+

File and directory permissions

+

The server process running Shaarli must have: +- read access to the following resources: + - PHP scripts: index.php, application/*.php, plugins/*.php + - 3rd party PHP and Javascript libraries: inc/*.php, inc/*.js + - static assets: + - CSS stylesheets: inc/*.css + - images/* + - RainTPL templates: tpl/*.html +- read, write and execution access to the following directories: + - cache - thumbnail cache + - data - link data store, configuration options + - pagecache - Atom/RSS feed cache + - tmp - RainTPL page cache

+

On a Linux distribution: +- the web server user will likely be www or http (for Apache2) +- it will be a member of a group of the same name: www:www, http:http +- to give it access to Shaarli, either: + - unzip Shaarli in the default web server location (usually /var/www/) and set the web server user as the owner + - put users in the same group as the web server, and set the appropriate access rights +- if you have a domain / subdomain to serve Shaarli, configure the server accordingly

+

Configuration

+

In data/config.json.php.

+

See also Plugin System.

+

Credentials

+
+

You shouldn't edit those.

+
+

login: Login username.
+hash: Generated password hash.
+salt: Password salt.

+

General

+

title: Shaarli's instance title.
+header_link: Link to the homepage.
+links_per_page: Number of shaares displayed per page.
+timezone: See the list of supported timezones.
+enabled_plugins: List of enabled plugins.

+

Security

+

session_protection_disabled: Disable session cookie hijacking protection (not recommended). +It might be useful if your IP adress often changes.
+ban_after: Failed login attempts before being IP banned.
+ban_duration: IP ban duration in seconds.
+open_shaarli: Anyone can add a new link while logged out if enabled.
+trusted_proxies: List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy.
+allowed_protocols: List of allowed protocols in shaare URLs or markdown-rendered descriptions. Useful if you want to store javascript: links (bookmarklets) in Shaarli (default: ["ftp", "ftps", "magnet"]).

+

Resources

+

data_dir: Data directory.
+datastore: Shaarli's links database file path.
+history: Shaarli's operation history file path. +updates: File path for the ran updates file.
+log: Log file path.
+update_check: Last update check file path.
+raintpl_tpl: Templates directory.
+raintpl_tmp: Template engine cache directory.
+thumbnails_cache: Thumbnails cache directory.
+page_cache: Shaarli's internal cache directory.
+ban_file: Banned IP file path.

+

Updates

+

check_updates: Enable or disable update check to the git repository.
+check_updates_branch: Git branch used to check updates (e.g. stable or master).
+check_updates_interval: Look for new version every N seconds (default: every day).

+

Privacy

+

default_private_links: Check the private checkbox by default for every new link.
+hide_public_links: All links are hidden while logged out.
+hide_timestamps: Timestamps are hidden.

+

Feed

+

rss_permalinks: Enable this to redirect RSS links to Shaarli's permalinks instead of shaared URL.
+show_atom: Display ATOM feed button.

+

Thumbnail

+

enable_thumbnails: Enable or disable thumbnail display.
+enable_localcache: Enable or disable local cache.

+

Redirector

+

url: Redirector URL, such as anonym.to.
+encode_url: Enable this if the redirector needs encoded URL to work properly.

+

Configuration file example

+
<?php /*
+{
+    "credentials": {
+        "login": "<login>",
+        "hash": "<password hash>",
+        "salt": "<password salt>"
+    },
+    "security": {
+        "ban_after": 4,
+        "session_protection_disabled": false,
+        "ban_duration": 1800,
+        "trusted_proxies": [
+            "1.2.3.4",
+            "5.6.7.8"
+        ],
+        "allowed_protocols": [
+            "ftp",
+            "ftps",
+            "magnet"
+        ]
+    },
+    "resources": {
+        "data_dir": "data",
+        "config": "data\/config.php",
+        "datastore": "data\/datastore.php",
+        "ban_file": "data\/ipbans.php",
+        "updates": "data\/updates.txt",
+        "log": "data\/log.txt",
+        "update_check": "data\/lastupdatecheck.txt",
+        "raintpl_tmp": "tmp\/",
+        "raintpl_tpl": "tpl\/",
+        "thumbnails_cache": "cache",
+        "page_cache": "pagecache"
+    },
+    "general": {
+        "check_updates": true,
+        "rss_permalinks": true,
+        "links_per_page": 20,
+        "default_private_links": true,
+        "enable_thumbnails": true,
+        "enable_localcache": true,
+        "check_updates_branch": "stable",
+        "check_updates_interval": 86400,
+        "enabled_plugins": [
+            "markdown",
+            "wallabag",
+            "archiveorg"
+        ],
+        "timezone": "Europe\/Paris",
+        "title": "My Shaarli",
+        "header_link": "?"
+    },
+    "extras": {
+        "show_atom": false,
+        "hide_public_links": false,
+        "hide_timestamps": false,
+        "open_shaarli": false,
+        "redirector": "http://anonym.to/?",
+        "redirector_encode_url": false
+    },
+    "general": {
+        "header_link": "?",
+        "links_per_page": 20,
+        "enabled_plugins": [
+            "markdown",
+            "wallabag"
+        ],
+        "timezone": "Europe\/Paris",
+        "title": "My Shaarli"
+    },
+    "updates": {
+        "check_updates": true,
+        "check_updates_branch": "stable",
+        "check_updates_interval": 86400
+    },
+    "feed": {
+        "rss_permalinks": true,
+        "show_atom": false
+    },
+    "privacy": {
+        "default_private_links": true,
+        "hide_public_links": false,
+        "hide_timestamps": false
+    },
+    "thumbnail": {
+        "enable_thumbnails": true,
+        "enable_localcache": true
+    },
+    "redirector": {
+        "url": "http://anonym.to/?",
+        "encode_url": false
+    },
+    "plugins": {
+        "WALLABAG_URL": "http://demo.wallabag.org",
+        "WALLABAG_VERSION": "1"
+    }
+} ?>
+
+ +

Additional configuration

+

The playvideos plugin may require that you adapt your server's +Content Security Policy +configuration to work properly.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Shaarli-images/index.html b/doc/html/Shaarli-images/index.html new file mode 100644 index 00000000..0fa93ca3 --- /dev/null +++ b/doc/html/Shaarli-images/index.html @@ -0,0 +1,425 @@ + + + + + + + + + + + Shaarli images - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Get and run a Shaarli image

+

DockerHub repository

+

The images can be found in the shaarli/shaarli +repository.

+

Available image tags

+
    +
  • latest: master branch (tarball release)
    • +
  • stable: stable branch (tarball release)
    • +
  • dev: master branch (Git clone)
    • +
+

All images rely on: +- Debian 8 Jessie +- PHP5-FPM +- Nginx

+

Download from DockerHub

+
$ docker pull shaarli/shaarli
+latest: Pulling from shaarli/shaarli
+32716d9fcddb: Pull complete
+84899d045435: Pull complete
+4b6ad7444763: Pull complete
+e0345ef7a3e0: Pull complete
+5c1dd344094f: Pull complete
+6422305a200b: Pull complete
+7d63f861dbef: Pull complete
+3eb97210645c: Pull complete
+869319d746ff: Already exists
+869319d746ff: Pulling fs layer
+902b87aaaec9: Already exists
+Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
+Status: Downloaded newer image for shaarli/shaarli:latest
+
+ +

Create and start a new container from the image

+
# map the host's :8000 port to the container's :80 port
+$ docker create -p 8000:80 shaarli/shaarli
+d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
+
+# launch the container in the background
+$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
+d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
+
+# list active containers
+$ docker ps
+CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
+d40b7af693d6  shaarli/shaarli  /usr/bin/supervisor  15 seconds ago  Up 4 seconds  0.0.0.0:8000->80/tcp  backstabbing_galileo
+
+ +

Stop and destroy a container

+
$ docker stop backstabbing_galileo  # those docker guys are really rude to physicists!
+backstabbing_galileo
+
+# check the container is stopped
+$ docker ps
+CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
+
+# list ALL containers
+$ docker ps -a
+CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                      PORTS               NAMES
+d40b7af693d6        shaarli/shaarli     /usr/bin/supervisor   5 minutes ago       Exited (0) 48 seconds ago                       backstabbing_galileo
+
+# destroy the container
+$ docker rm backstabbing_galileo  # let's put an end to these barbarian practices
+backstabbing_galileo
+
+$ docker ps -a
+CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Static-analysis/index.html b/doc/html/Static-analysis/index.html new file mode 100644 index 00000000..0dfb5519 --- /dev/null +++ b/doc/html/Static-analysis/index.html @@ -0,0 +1,359 @@ + + + + + + + + + + + Static analysis - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

WIP

+

This topic is currently being discussed here: +- Fix coding style (static analysis) (#95) +- Continuous Integration tools & features (#130)

+

Usage

+

Static analysis tools can be installed with Composer, and used through Shaarli's Makefile.

+

For an overview of the available features, see: +- Code quality: Makefile to run static code checkers (#124) +- Run PHPCS against different coding standards (#276)

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Theming/index.html b/doc/html/Theming/index.html new file mode 100644 index 00000000..70a36dd4 --- /dev/null +++ b/doc/html/Theming/index.html @@ -0,0 +1,435 @@ + + + + + + + + + + + Theming - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Foreword

+

There are two ways of customizing how Shaarli looks:

+
    +
  1. by using a custom CSS to override Shaarli's CSS
    2. +
  2. by using a full theme that provides its own RainTPL templates, CSS and Javascript resources
    3. +
+

Custom CSS

+

Shaarli's appearance can be modified by adding CSS rules to: +- Shaarli < v0.9.0: inc/user.css +- Shaarli >= v0.9.0: data/user.css

+

This file allows overriding rules defined in the template CSS files (only add changed rules), or define a whole new theme.

+

Note: Do not edit tpl/default/css/shaarli.css! Your changes would be overridden when updating Shaarli.

+

See also Download CSS styles from an OPML list

+

Themes

+

WARNING - This feature is currently being worked on and will be improved in the next releases. Experimental.

+

Installation: +- find a theme you'd like to install +- copy or clone the theme folder under tpl/<a_sweet_theme> +- enable the theme: + - Shaarli < v0.9.0: edit data/config.json.php and set the value of raintpl_tpl to the new theme name: + "raintpl_tpl": "tpl\/my-template\/" + - Shaarli >= v0.9.0: select the theme through the Tools page

+

Community CSS & themes

+

Custom CSS

+ +

Themes

+ +

Shaarli forks

+ +

Example installation: AlbinoMouse theme

+

With the following configuration: +- Apache 2 / PHP 5.6 +- user sites are enabled, e.g. /home/user/public_html/somedir is served as http://localhost/~user/somedir +- http is the name of the Apache user

+
$ cd ~/public_html
+
+# clone repositories
+$ git clone https://github.com/shaarli/Shaarli.git shaarli
+$ pushd shaarli/tpl
+$ git clone https://github.com/alexisju/albinomouse-template.git
+$ popd
+
+# set access rights for Apache
+$ chgrp -R http shaarli
+$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp
+
+ +

Get config written: +- go to the freshly installed site +- fill the install form +- log in to Shaarli

+

Edit Shaarli's configuration|Shaarli configuration:

+
# the file should be owned by Apache, thus not writeable => sudo
+$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Troubleshooting/index.html b/doc/html/Troubleshooting/index.html new file mode 100644 index 00000000..ed1c433d --- /dev/null +++ b/doc/html/Troubleshooting/index.html @@ -0,0 +1,441 @@ + + + + + + + + + + + Troubleshooting - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Troubleshooting

+

Browser

+

Redirection issues (HTTP Referer)

+

Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.

+

See: +- HTTP referer (Wikipedia) +- Improve online privacy by controlling referrer information +- Better security, privacy and anonymity in Firefox

+

Firefox HTTP Referer options

+

HTTP settings are available by browsing about:config, here are the available settings and their values.

+

network.http.sendRefererHeader - determines when to send the Referer HTTP header +- 0: Never send the referring URL + - not recommended, may break some sites +- 1: Send only on clicked links +- 2 (default): Send for links and images

+

network.http.referer.XOriginPolicy - Cross-domain origin policy +- 0 (default): Always send +- 1: Send if base domains match +- 2: Send if hosts match

+

network.http.referer.spoofSource - Referer spoofing (~faking) +- false (default): real referer +- true: spoof referer (use target URI as referer) + - known to break some functionality in Shaarli

+

network.http.referer.trimmingPolicy - trim the URI not to send a full Referer +- 0 (default): send full URI +- 1: scheme+host+port+path +- 2: scheme+host+port

+

Firefox, localhost and redirections

+

localhost is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly.

+

To solve this, assign a local domain to your host, e.g.

+
127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan
+
+ +

and browse Shaarli at http://localhost.lan/.

+

Related threads: +- What is localhost.localdomain for? +- Stop returning to the first page after editing a bookmark from another page

+

Login

+

I forgot my password!

+

Delete the file data/config.php and display the page again. You will be asked for a new login/password.

+

I'm locked out - Login bruteforce protection

+

Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links.

+

To remove the current IP bans, delete the file data/ipbans.php

+

List of all login attempts

+

The file data/log.txt shows all logins (successful or failed) and bans/lifted bans. +Search for failed in this file to look for unauthorized login attempts.

+

Hosting problems

+

Old PHP versions

+
    +
  • On free.fr : free.fr now support php 5.6.x(link)and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a sessions directory and a .htaccess file containing:
    • +
+
<IfDefine Free>
+php56 1
+</IfDefine>
+
+ +
    +
  • If you have an error such as: Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx, it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to .php5
    • +
  • On 1and1 : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).
    • +
  • If you have the error Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /…/index.php on line xxx, it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines:
    • +
+
//list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.
+// FIXME: Decode charset according to charset specified in either 1) HTTP response headers or 2) <head> in html 
+//if (strpos($status,'200 OK')) $title=html_extract_title($data);
+
+ +
    +
  • On hosts which forbid outgoing HTTP requests (such as free.fr), some thumbnails will not work.
    • +
  • On lost-oasis, RSS doesn't work correctly, because of this message at the begining of the RSS/ATOM feed : <? // tout ce qui est charge ici (generalement des includes et require) est charge en permanence. ?>. To fix this, remove this message from php-include/prepend.php
    • +
+

Dates are not properly formatted

+

Shaarli tries to sniff the language of the browser (using HTTP_ACCEPT_LANGUAGE headers) and choose a date format accordingly. But Shaarli can only use the date formats (and more generaly speaking, the locales) provided by the webserver. So even if you have a browser in French, you may end up with dates in US format (it's the case on sebsauvage.net :-( )

+

Problems on CentOS servers

+

On CentOS/RedHat derivatives, you may need to install the php-mbstring package.

+

My session expires! I can't stay logged in

+

This can be caused by several things:

+
    +
  • Your php installation may not have a proper directory setup for session files. (eg. on Free.fr you need to create a session directory on the root of your website.) You may need to create the session directory of set it up.
    • +
  • Most hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the sessions subdirectory and add ini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions');. Make sure this directory is not browsable !)
    • +
  • If your IP address changes during surfing, Shaarli will force expire your session for security reasons (to prevent session cookie hijacking). This can happen when surfing from WiFi or 3G (you may have switched WiFi/3G access point), or in some corporate/university proxies which use load balancing (and may have proxies with several external IP addresses).
    • +
  • Some browser addons may interfer with HTTP headers (ipfuck/ipflood/GreaseMonkey…). Try disabling those.
    • +
  • You may be using OperaTurbo or OperaMini, which use their own proxies which may change from time to time.
    • +
  • If you have another application on the same webserver where Shaarli is installed, these application may forcefully expire php sessions.
    • +
+

Sessions do not seem to work correctly on your server

+

Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have no dots in the hostname (e.g. localhost or http://my-webserver/shaarli/), some browsers will not store cookies at all (this respects the HTTP cookie specification).

+

pubsubhubbub support

+

Download publisher.php at the root of your Shaarli installation and set $GLOBALS['config']['PUBSUBHUB_URL'] in your config.php

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Unit-tests/index.html b/doc/html/Unit-tests/index.html new file mode 100644 index 00000000..84580db4 --- /dev/null +++ b/doc/html/Unit-tests/index.html @@ -0,0 +1,492 @@ + + + + + + + + + + + Unit tests - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Setup your environment for tests

+

The framework used is PHPUnit; it can be installed with Composer, which is a dependency management tool.

+

Regarding Composer, you can either use: + a system-wide version, e.g. installed through your distro's package manager + a local version, downloadable here

+

Sample usage

+
# system-wide version
+$ composer install
+$ composer update
+
+# local version
+$ php composer.phar self-update
+$ php composer.phar install
+$ php composer.phar update
+
+ +

Install Shaarli dev dependencies

+
$ cd /path/to/shaarli
+$ composer update
+
+ +

Install and enable Xdebug to generate PHPUnit coverage reports

+

For Debian-based distros:

+
$ aptitude install php5-xdebug
+
+ +

For ArchLinux:

+
$ pacman -S xdebug
+
+ +

Then add the following line to /etc/php/php.ini:

+
zend_extension=xdebug.so
+
+ +

Run unit tests

+

Successful test suite:

+
$ make test
+
+-------
+PHPUNIT
+-------
+PHPUnit 4.6.9 by Sebastian Bergmann and contributors.
+
+Configuration read from /home/virtualtam/public_html/shaarli/phpunit.xml
+
+....................................
+
+Time: 759 ms, Memory: 8.25Mb
+
+OK (36 tests, 65 assertions)
+
+ +

Test suite with failures and errors:

+
$ make test
+-------
+PHPUNIT
+-------
+PHPUnit 4.6.9 by Sebastian Bergmann and contributors.
+
+Configuration read from /home/virtualtam/public_html/shaarli/phpunit.xml
+
+E..FF...............................
+
+Time: 802 ms, Memory: 8.25Mb
+
+There was 1 error:
+
+1) LinkDBTest::testConstructLoggedIn
+Missing argument 2 for LinkDB::__construct(), called in /home/virtualtam/public_html/shaarli/tests/Link\
+DBTest.php on line 79 and defined
+
+/home/virtualtam/public_html/shaarli/application/LinkDB.php:58
+/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:79
+
+--
+
+There were 2 failures:
+
+1) LinkDBTest::testCheckDBNew
+Failed asserting that two strings are equal.
+--- Expected
++++ Actual
+@@ @@
+-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'
++'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'
+
+/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:121
+
+2) LinkDBTest::testCheckDBLoad
+Failed asserting that two strings are equal.
+--- Expected
++++ Actual
+@@ @@
+-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'
++'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'
+
+/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:133
+
+FAILURES!
+Tests: 36, Assertions: 63, Errors: 1, Failures: 2.
+
+ +

Test results and coverage

+

By default, PHPUnit will run all suitable tests found under the tests directory.

+

Each test has 3 possible outcomes: + . - success + F - failure: the test was run but its results are invalid + * the code does not behave as expected + * dependencies to external elements: globals, session, cache... +* E - error: something went wrong and the tested code has crashed + * typos in the code, or in the test code + * dependencies to missing external elements

+

If Xdebug has been installed and activated, two coverage reports will be generated: + a summary in the console + a detailed HTML report with metrics for tested code + * to open it in a web browser: firefox coverage/index.html &

+

Executing specific tests

+

Add a @group annotation in a test class or method comment:

+
/**
+ * Netscape bookmark import
+ * @group WIP
+ */
+class BookmarkImportTest extends PHPUnit_Framework_TestCase
+{
+   [...]
+}
+
+ +

To run all tests annotated with @group WIP:

+
$ vendor/bin/phpunit --group WIP tests/
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Upgrade-and-migration/index.html b/doc/html/Upgrade-and-migration/index.html new file mode 100644 index 00000000..642942bf --- /dev/null +++ b/doc/html/Upgrade-and-migration/index.html @@ -0,0 +1,534 @@ + + + + + + + + + + + Upgrade and migration - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Preparation

+

Note your current version

+

If anything goes wrong, it's important for us to know which version you're upgrading from.
+The current version is present in the version.php file.

+

Backup your data

+

Shaarli stores all user data under the data directory: +- data/config.php - main configuration file +- data/datastore.php - bookmarked links +- data/ipbans.php - banned IP addresses +- data/updates.txt - contains all automatic update to the configuration and datastore files already run

+

See Shaarli configuration for more information about Shaarli resources.

+

It is recommended to backup this repository before starting updating/upgrading Shaarli: +- users with SSH access: copy or archive the directory to a temporary location +- users with FTP access: download a local copy of your Shaarli installation using your favourite client

+

Migrating data from a previous installation

+

As all user data is kept under data, this is the only directory you need to worry about when migrating to a new installation, which corresponds to the following steps:

+
    +
  • backup the data directory
    • +
  • install or update Shaarli: +
    • +
  • check or restore the data directory
    • +
+ +

All tagged revisions can be downloaded as tarballs or ZIP archives from the releases page.

+

We recommend that you use the latest release tarball with the -full suffix. It contains the dependencies, please read Download and installation for git complete instructions.

+

Once downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the data directory!

+

After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to data/config.json.php (see Shaarli configuration for more details).

+

Upgrading with Git

+

Updating a community Shaarli

+

If you have installed Shaarli from the community Git repository, simply pull new changes from your local clone:

+
$ cd /path/to/shaarli
+$ git pull
+
+From github.com:shaarli/Shaarli
+ * branch            master     -> FETCH_HEAD
+Updating ebd67c6..521f0e6
+Fast-forward
+ application/Url.php   | 1 +
+ shaarli_version.php   | 2 +-
+ tests/Url/UrlTest.php | 1 +
+ 3 files changed, 3 insertions(+), 1 deletion(-)
+
+ +

Shaarli >= v0.8.x: install/update third-party PHP dependencies using Composer:

+
$ composer install --no-dev
+
+Loading composer repositories with package information
+Updating dependencies
+  - Installing shaarli/netscape-bookmark-parser (v1.0.1)
+    Downloading: 100%
+
+ +

Migrating and upgrading from Sebsauvage's repository

+

If you have installed Shaarli from Sebsauvage's original Git repository, you can use Git remotes to update your working copy.

+

The following guide assumes that: +- you have a basic knowledge of Git branching and remote repositories +- the default remote is named origin and points to Sebsauvage's repository +- the current branch is master + - if you have personal branches containing customizations, you will need to rebase them after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break! +- the working copy is clean: + - no versioned file has been locally modified + - no untracked files are present

+

Step 0: show repository information

+
$ cd /path/to/shaarli
+
+$ git remote -v
+origin  https://github.com/sebsauvage/Shaarli (fetch)
+origin  https://github.com/sebsauvage/Shaarli (push)
+
+$ git branch -vv
+* master 029f75f [origin/master] Update README.md
+
+$ git status
+On branch master
+Your branch is up-to-date with 'origin/master'.
+nothing to commit, working directory clean
+
+ +

Step 1: update Git remotes

+
$ git remote rename origin sebsauvage
+$ git remote -v
+sebsauvage  https://github.com/sebsauvage/Shaarli (fetch)
+sebsauvage  https://github.com/sebsauvage/Shaarli (push)
+
+$ git remote add origin https://github.com/shaarli/Shaarli
+$ git fetch origin
+
+remote: Counting objects: 3015, done.
+remote: Compressing objects: 100% (19/19), done.
+remote: Total 3015 (delta 446), reused 457 (delta 446), pack-reused 2550
+Receiving objects: 100% (3015/3015), 2.59 MiB | 918.00 KiB/s, done.
+Resolving deltas: 100% (1899/1899), completed with 48 local objects.
+From https://github.com/shaarli/Shaarli
+ * [new branch]      master     -> origin/master
+ * [new branch]      stable     -> origin/stable
+[...]
+ * [new tag]         v0.6.4     -> v0.6.4
+ * [new tag]         v0.7.0     -> v0.7.0
+
+ +

Step 2: use the stable community branch

+
$ git checkout origin/stable -b stable
+Branch stable set up to track remote branch stable from origin.
+Switched to a new branch 'stable'
+
+$ git branch -vv
+  master 029f75f [sebsauvage/master] Update README.md
+* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5
+
+ +

Shaarli >= v0.8.x: install/update third-party PHP dependencies using Composer:

+
$ composer install --no-dev
+
+Loading composer repositories with package information
+Updating dependencies
+  - Installing shaarli/netscape-bookmark-parser (v1.0.1)
+    Downloading: 100%
+
+ +

Optionally, you can delete information related to the legacy version:

+
$ git branch -D master
+Deleted branch master (was 029f75f).
+
+$ git remote remove sebsauvage
+
+$ git remote -v
+origin  https://github.com/shaarli/Shaarli (fetch)
+origin  https://github.com/shaarli/Shaarli (push)
+
+$ git gc
+Counting objects: 3317, done.
+Delta compression using up to 8 threads.
+Compressing objects: 100% (1237/1237), done.
+Writing objects: 100% (3317/3317), done.
+Total 3317 (delta 2050), reused 3301 (delta 2034)to
+
+ +

Step 3: configuration

+

After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to data/config.php (see Shaarli configuration for more details).

+

Troubleshooting

+

If the solutions provided here doesn't work, please open an issue specifying which version you're upgrading from and to.

+

You must specify an integer as a key

+

In v0.8.1 we changed how link keys are handled (from timestamps to incremental integers). +Take a look at data/updates.txt content.

+

updates.txt contains updateMethodDatastoreIds

+

Try to delete it and refresh your page while being logged in.

+

updates.txt doesn't exists or doesn't contain updateMethodDatastoreIds

+
    +
  1. Create data/updates.txt if it doesn't exist.
    2. +
  2. Paste this string in the update file ;updateMethodRenameDashTags;
    3. +
  3. Login to Shaarli.
    4. +
  4. Delete the update file.
    5. +
  5. Refresh.
    6. +
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/html/Versioning-and-Branches/index.html b/doc/html/Versioning-and-Branches/index.html new file mode 100644 index 00000000..406ad7f9 --- /dev/null +++ b/doc/html/Versioning-and-Branches/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + Versioning and Branches - Shaarli Documentation + + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

WORK IN PROGRESS

+

It's important to understand how Shaarli branches work, especially if you're maintaining a 3rd party tools for Shaarli (theme, plugin, etc.), to be sure stay compatible.

+

master branch

+

The master branch is the development branch. Any new change MUST go through this branch using Pull Requests.

+

Remarks:

+
    +
  • This branch shouldn't be used for production as it isn't necessary stable.
    • +
  • 3rd party aren't required to be compatible with the latest changes.
    • +
  • Official plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch.
    • +
  • The version in this branch is always dev.
    • +
+

v0.x branch

+

This v0.x branch, points to the latest v0.x.y release.

+

Explanation:

+

When a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli.

+

In this case, the issue is fixed in the master branch, and the fix is backported the to the v0.x branch. Then a new release is made from the v0.x branch.

+

This workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon.

+

latest branch

+

This branch point the latest release. It recommended to use it to get the latest tested changes.

+

stable branch

+

The stable branch doesn't contain any major bug, and is one major digit version behind the latest release.

+

For example, the current latest release is v0.8.3, the stable branch is an alias to the latest v0.7.x release. When the v0.9.0 version will be released, the stable will move to the latest v0.8.x release.

+

Remarks:

+
    +
  • Shaarli release pace isn't fast, and the stable branch might be a few months behind the latest release.
    • +
+

Releases

+

Releases are always made from the latest v0.x branch.

+

Note that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step.

+

Advices on 3rd party git repos workflow

+

Versioning

+

Any time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the changelog (Draft means not released yet) and the commit log (like tpl folder for themes)). You can either:

+
    +
  • use the Shaarli version number, with your repo version. For example, if Shaarli v0.8.3 is released, publish a v0.8.3-1 release, where v0.8.3 states Shaarli compatibility and -1 is your own version digit for the current Shaarli version.
    • +
  • use your own versioning scheme, and state Shaarli compatibility in the release description.
    • +
+

Using this, any user will be able to pick the release matching his own Shaarli version.

+

Major bugfix backport releases

+

To be able to support backported fixes, it recommended to use our workflow:

+
# In master, fix the major bug
+git commit -m "Katastrophe"
+git push origin master
+# Get your commit hash
+git log --format="%H" -n 1
+# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name)
+git checkout -b katastrophe v0.8.2-1
+# Backport the fix commit to your brand new branch
+git cherry-pick <fix commit hash>
+git push origin katastrophe
+# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1`
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + « Previous + + + Next » + + +
+ + + + diff --git a/doc/config.json b/doc/html/config.json similarity index 100% rename from doc/config.json rename to doc/html/config.json diff --git a/doc/html/css/highlight.css b/doc/html/css/highlight.css new file mode 100644 index 00000000..0ae40a72 --- /dev/null +++ b/doc/html/css/highlight.css @@ -0,0 +1,124 @@ +/* +This is the GitHub theme for highlight.js + +github.com style (c) Vasily Polovnyov + +*/ + +.hljs { + display: block; + overflow-x: auto; + color: #333; + -webkit-text-size-adjust: none; +} + +.hljs-comment, +.diff .hljs-header, +.hljs-javadoc { + color: #998; + font-style: italic; +} + +.hljs-keyword, +.css .rule .hljs-keyword, +.hljs-winutils, +.nginx .hljs-title, +.hljs-subst, +.hljs-request, +.hljs-status { + color: #333; + font-weight: bold; +} + +.hljs-number, +.hljs-hexcolor, +.ruby .hljs-constant { + color: #008080; +} + +.hljs-string, +.hljs-tag .hljs-value, +.hljs-phpdoc, +.hljs-dartdoc, +.tex .hljs-formula { + color: #d14; +} + +.hljs-title, +.hljs-id, +.scss .hljs-preprocessor { + color: #900; + font-weight: bold; +} + +.hljs-list .hljs-keyword, +.hljs-subst { + font-weight: normal; +} + +.hljs-class .hljs-title, +.hljs-type, +.vhdl .hljs-literal, +.tex .hljs-command { + color: #458; + font-weight: bold; +} + +.hljs-tag, +.hljs-tag .hljs-title, +.hljs-rule .hljs-property, +.django .hljs-tag .hljs-keyword { + color: #000080; + font-weight: normal; +} + +.hljs-attribute, +.hljs-variable, +.lisp .hljs-body, +.hljs-name { + color: #008080; +} + +.hljs-regexp { + color: #009926; +} + +.hljs-symbol, +.ruby .hljs-symbol .hljs-string, +.lisp .hljs-keyword, +.clojure .hljs-keyword, +.scheme .hljs-keyword, +.tex .hljs-special, +.hljs-prompt { + color: #990073; +} + +.hljs-built_in { + color: #0086b3; +} + +.hljs-preprocessor, +.hljs-pragma, +.hljs-pi, +.hljs-doctype, +.hljs-shebang, +.hljs-cdata { + color: #999; + font-weight: bold; +} + +.hljs-deletion { + background: #fdd; +} + +.hljs-addition { + background: #dfd; +} + +.diff .hljs-change { + background: #0086b3; +} + +.hljs-chunk { + color: #aaa; +} diff --git a/doc/html/css/theme.css b/doc/html/css/theme.css new file mode 100644 index 00000000..099a2d82 --- /dev/null +++ b/doc/html/css/theme.css @@ -0,0 +1,12 @@ +/* + * This file is copied from the upstream ReadTheDocs Sphinx + * theme. To aid upgradability this file should *not* be edited. + * modifications we need should be included in theme_extra.css. + * + * https://github.com/rtfd/readthedocs.org/blob/master/readthedocs/core/static/core/css/theme.css + */ + +*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}[hidden]{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:hover,a:active{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;color:#000;text-decoration:none}mark{background:#ff0;color:#000;font-style:italic;font-weight:bold}pre,code,.rst-content tt,kbd,samp{font-family:monospace,serif;_font-family:"courier new",monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:before,q:after{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}ul,ol,dl{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure{margin:0}form{margin:0}fieldset{border:0;margin:0;padding:0}label{cursor:pointer}legend{border:0;*margin-left:-7px;padding:0;white-space:normal}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0;*width:13px;*height:13px}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:0.2em 0;background:#ccc;color:#000;padding:0.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none !important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{html,body,section{background:none !important}*{box-shadow:none !important;text-shadow:none !important;filter:none !important;-ms-filter:none !important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:0.5cm}p,h2,h3{orphans:3;widows:3}h2,h3{page-break-after:avoid}}.fa:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.btn,input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}/*! + * Font Awesome 4.1.0 by @davegandy - http://fontawesome.io - @fontawesome + * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) + */@font-face{font-family:'FontAwesome';src:url("../fonts/fontawesome-webfont.eot?v=4.1.0");src:url("../fonts/fontawesome-webfont.eot?#iefix&v=4.1.0") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff?v=4.1.0") format("woff"),url("../fonts/fontawesome-webfont.ttf?v=4.1.0") format("truetype"),url("../fonts/fontawesome-webfont.svg?v=4.1.0#fontawesomeregular") format("svg");font-weight:normal;font-style:normal}.fa,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.icon{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:0.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:0.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:solid 0.08em #eee;border-radius:.1em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.pull-left.icon{margin-right:.3em}.fa.pull-right,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.pull-right.icon{margin-left:.3em}.fa-spin{-webkit-animation:spin 2s infinite linear;-moz-animation:spin 2s infinite linear;-o-animation:spin 2s infinite linear;animation:spin 2s infinite linear}@-moz-keyframes spin{0%{-moz-transform:rotate(0deg)}100%{-moz-transform:rotate(359deg)}}@-webkit-keyframes spin{0%{-webkit-transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg)}}@-o-keyframes spin{0%{-o-transform:rotate(0deg)}100%{-o-transform:rotate(359deg)}}@keyframes spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=1);-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=2);-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=3);-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=0);-webkit-transform:scale(-1, 1);-moz-transform:scale(-1, 1);-ms-transform:scale(-1, 1);-o-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=2);-webkit-transform:scale(1, -1);-moz-transform:scale(1, -1);-ms-transform:scale(1, -1);-o-transform:scale(1, -1);transform:scale(1, -1)}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-gear:before,.fa-cog:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-rotate-right:before,.fa-repeat:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-warning:before,.fa-exclamation-triangle:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-gears:before,.fa-cogs:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-save:before,.fa-floppy-o:before{content:""}.fa-square:before{content:""}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-unsorted:before,.fa-sort:before{content:""}.fa-sort-down:before,.fa-sort-desc:before{content:""}.fa-sort-up:before,.fa-sort-asc:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-legal:before,.fa-gavel:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-flash:before,.fa-bolt:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-paste:before,.fa-clipboard:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-unlink:before,.fa-chain-broken:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:""}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:""}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:""}.fa-euro:before,.fa-eur:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-rupee:before,.fa-inr:before{content:""}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:""}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:""}.fa-won:before,.fa-krw:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-turkish-lira:before,.fa-try:before{content:""}.fa-plus-square-o:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-institution:before,.fa-bank:before,.fa-university:before{content:""}.fa-mortar-board:before,.fa-graduation-cap:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-square:before,.fa-pied-piper:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:""}.fa-file-zip-o:before,.fa-file-archive-o:before{content:""}.fa-file-sound-o:before,.fa-file-audio-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before{content:""}.fa-ge:before,.fa-empire:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-send:before,.fa-paper-plane:before{content:""}.fa-send-o:before,.fa-paper-plane-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}.fa:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:"FontAwesome";display:inline-block;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .icon{display:inline-block;text-decoration:inherit}.btn .fa,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .icon,.nav .fa,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .icon{display:inline}.btn .fa.fa-large,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .fa-large.icon{line-height:0.9em}.btn .fa.fa-spin,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .fa-spin.icon{display:inline-block}.btn.fa:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.btn.icon:before{opacity:0.5;-webkit-transition:opacity 0.05s ease-in;-moz-transition:opacity 0.05s ease-in;transition:opacity 0.05s ease-in}.btn.fa:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.btn.icon:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .icon:before{font-size:14px;vertical-align:-15%}.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.wy-alert-title,.rst-content .admonition-title{color:#fff;font-weight:bold;display:block;color:#fff;background:#6ab0de;margin:-12px;padding:6px 12px;margin-bottom:12px}.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo{background:#fdf3f2}.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title{background:#f29f97}.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo{background:#ffedcc}.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title{background:#f0b37e}.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo{background:#e7f2fa}.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title{background:#6ab0de}.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo{background:#dbfaf4}.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title{background:#1abc9c}.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo{background:#f3f6f6}.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title{color:#404040;background:#e1e4e5}.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a{color:#2980B9}.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0px;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all 0.3s ease-in;-moz-transition:all 0.3s ease-in;transition:all 0.3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27AE60}.wy-tray-container li.wy-tray-item-info{background:#2980B9}.wy-tray-container li.wy-tray-item-warning{background:#E67E22}.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px 12px;color:#fff;border:1px solid rgba(0,0,0,0.1);background-color:#27AE60;text-decoration:none;font-weight:normal;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all 0.1s linear;-moz-transition:all 0.1s linear;transition:all 0.1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;padding:8px 12px 6px 12px}.btn:visited{color:#fff}.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn-disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980B9 !important}.btn-info:hover{background-color:#2e8ece !important}.btn-neutral{background-color:#f3f6f6 !important;color:#404040 !important}.btn-neutral:hover{background-color:#e5ebeb !important;color:#404040}.btn-neutral:visited{color:#404040 !important}.btn-success{background-color:#27AE60 !important}.btn-success:hover{background-color:#295 !important}.btn-danger{background-color:#E74C3C !important}.btn-danger:hover{background-color:#ea6153 !important}.btn-warning{background-color:#E67E22 !important}.btn-warning:hover{background-color:#e98b39 !important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f !important}.btn-link{background-color:transparent !important;color:#2980B9;box-shadow:none;border-color:transparent !important}.btn-link:hover{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:active{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:visited{color:#9B59B6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:before,.wy-btn-group:after{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:solid 1px #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980B9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type="search"]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980B9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{border:0;margin:0;padding:0}legend{display:block;width:100%;border:0;padding:0;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label{display:block;margin:0 0 0.3125em 0;color:#999;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;*zoom:1;max-width:68em;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#E74C3C}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full input[type="text"],.wy-control-group .wy-form-full input[type="password"],.wy-control-group .wy-form-full input[type="email"],.wy-control-group .wy-form-full input[type="url"],.wy-control-group .wy-form-full input[type="date"],.wy-control-group .wy-form-full input[type="month"],.wy-control-group .wy-form-full input[type="time"],.wy-control-group .wy-form-full input[type="datetime"],.wy-control-group .wy-form-full input[type="datetime-local"],.wy-control-group .wy-form-full input[type="week"],.wy-control-group .wy-form-full input[type="number"],.wy-control-group .wy-form-full input[type="search"],.wy-control-group .wy-form-full input[type="tel"],.wy-control-group .wy-form-full input[type="color"],.wy-control-group .wy-form-halves input[type="text"],.wy-control-group .wy-form-halves input[type="password"],.wy-control-group .wy-form-halves input[type="email"],.wy-control-group .wy-form-halves input[type="url"],.wy-control-group .wy-form-halves input[type="date"],.wy-control-group .wy-form-halves input[type="month"],.wy-control-group .wy-form-halves input[type="time"],.wy-control-group .wy-form-halves input[type="datetime"],.wy-control-group .wy-form-halves input[type="datetime-local"],.wy-control-group .wy-form-halves input[type="week"],.wy-control-group .wy-form-halves input[type="number"],.wy-control-group .wy-form-halves input[type="search"],.wy-control-group .wy-form-halves input[type="tel"],.wy-control-group .wy-form-halves input[type="color"],.wy-control-group .wy-form-thirds input[type="text"],.wy-control-group .wy-form-thirds input[type="password"],.wy-control-group .wy-form-thirds input[type="email"],.wy-control-group .wy-form-thirds input[type="url"],.wy-control-group .wy-form-thirds input[type="date"],.wy-control-group .wy-form-thirds input[type="month"],.wy-control-group .wy-form-thirds input[type="time"],.wy-control-group .wy-form-thirds input[type="datetime"],.wy-control-group .wy-form-thirds input[type="datetime-local"],.wy-control-group .wy-form-thirds input[type="week"],.wy-control-group .wy-form-thirds input[type="number"],.wy-control-group .wy-form-thirds input[type="search"],.wy-control-group .wy-form-thirds input[type="tel"],.wy-control-group .wy-form-thirds input[type="color"]{width:100%}.wy-control-group .wy-form-full{float:left;display:block;margin-right:2.35765%;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child{margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child{margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;font-size:90%}.wy-control-no-input{display:inline-block;margin:6px 0 0 0;font-size:90%}.wy-control-group.fluid-input input[type="text"],.wy-control-group.fluid-input input[type="password"],.wy-control-group.fluid-input input[type="email"],.wy-control-group.fluid-input input[type="url"],.wy-control-group.fluid-input input[type="date"],.wy-control-group.fluid-input input[type="month"],.wy-control-group.fluid-input input[type="time"],.wy-control-group.fluid-input input[type="datetime"],.wy-control-group.fluid-input input[type="datetime-local"],.wy-control-group.fluid-input input[type="week"],.wy-control-group.fluid-input input[type="number"],.wy-control-group.fluid-input input[type="search"],.wy-control-group.fluid-input input[type="tel"],.wy-control-group.fluid-input input[type="color"]{width:100%}.wy-form-message-inline{display:inline-block;padding-left:0.3em;color:#666;vertical-align:middle;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:0.3125em;font-style:italic}input{line-height:normal}input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;*overflow:visible}input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border 0.3s linear;-moz-transition:border 0.3s linear;transition:border 0.3s linear}input[type="datetime-local"]{padding:0.34375em 0.625em}input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0;margin-right:0.3125em;*height:13px;*width:13px}input[type="search"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input[type="text"]:focus,input[type="password"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus{outline:0;outline:thin dotted \9;border-color:#333}input.no-focus:focus{border-color:#ccc !important}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;outline:1px auto #129FEA}input[type="text"][disabled],input[type="password"][disabled],input[type="email"][disabled],input[type="url"][disabled],input[type="date"][disabled],input[type="month"][disabled],input[type="time"][disabled],input[type="datetime"][disabled],input[type="datetime-local"][disabled],input[type="week"][disabled],input[type="number"][disabled],input[type="search"][disabled],input[type="tel"][disabled],input[type="color"][disabled]{cursor:not-allowed;background-color:#f3f6f6;color:#cad2d3}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;border:1px solid #E74C3C}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}input[type="file"]:focus:invalid:focus,input[type="radio"]:focus:invalid:focus,input[type="checkbox"]:focus:invalid:focus{outline-color:#E74C3C}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif}select,textarea{padding:0.5em 0.625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border 0.3s linear;-moz-transition:border 0.3s linear;transition:border 0.3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#fff;color:#cad2d3;border-color:transparent}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{padding:6px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:solid 1px #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}.wy-control-group.wy-control-group-error input[type="text"],.wy-control-group.wy-control-group-error input[type="password"],.wy-control-group.wy-control-group-error input[type="email"],.wy-control-group.wy-control-group-error input[type="url"],.wy-control-group.wy-control-group-error input[type="date"],.wy-control-group.wy-control-group-error input[type="month"],.wy-control-group.wy-control-group-error input[type="time"],.wy-control-group.wy-control-group-error input[type="datetime"],.wy-control-group.wy-control-group-error input[type="datetime-local"],.wy-control-group.wy-control-group-error input[type="week"],.wy-control-group.wy-control-group-error input[type="number"],.wy-control-group.wy-control-group-error input[type="search"],.wy-control-group.wy-control-group-error input[type="tel"],.wy-control-group.wy-control-group-error input[type="color"]{border:solid 1px #E74C3C}.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:0.5em 0.625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980B9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width: 480px){.wy-form button[type="submit"]{margin:0.7em 0 0}.wy-form input[type="text"],.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0.3em;display:block}.wy-form label{margin-bottom:0.3em;display:block}.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:0.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0 0}.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width: 768px){.tablet-hide{display:none}}@media screen and (max-width: 480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;border-bottom:solid 2px #e1e4e5}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;vertical-align:middle}.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;padding-right:0}.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:gray;font-size:90%}.wy-table-tertiary{color:gray;font-size:80%}.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}.wy-table-backed{background-color:#f3f6f6}.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0 !important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980B9;text-decoration:none}a:hover{color:#3091d1}a:visited{color:#9B59B6}html{height:100%;overflow-x:hidden}body{font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;font-weight:normal;color:#404040;min-height:100%;overflow-x:hidden;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#E67E22 !important}a.wy-text-warning:hover{color:#eb9950 !important}.wy-text-info{color:#2980B9 !important}a.wy-text-info:hover{color:#409ad5 !important}.wy-text-success{color:#27AE60 !important}a.wy-text-success:hover{color:#36d278 !important}.wy-text-danger{color:#E74C3C !important}a.wy-text-danger:hover{color:#ed7669 !important}.wy-text-neutral{color:#404040 !important}a.wy-text-neutral:hover{color:#595959 !important}h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif}p{line-height:24px;margin:0;font-size:16px;margin-bottom:24px}h1{font-size:175%}h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}code,.rst-content tt{white-space:nowrap;max-width:100%;background:#fff;border:solid 1px #e1e4e5;font-size:75%;padding:0 5px;font-family:Consolas,"Andale Mono WT","Andale Mono","Lucida Console","Lucida Sans Typewriter","DejaVu Sans Mono","Bitstream Vera Sans Mono","Liberation Mono","Nimbus Mono L",Monaco,"Courier New",Courier,monospace;color:#E74C3C;overflow-x:auto}code.code-large,.rst-content tt.code-large{font-size:90%}.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;margin-left:24px}.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;margin-left:24px}.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}.codeblock-example{border:1px solid #e1e4e5;border-bottom:none;padding:24px;padding-top:48px;font-weight:500;background:#fff;position:relative}.codeblock-example:after{content:"Example";position:absolute;top:0px;left:0px;background:#9B59B6;color:#fff;padding:6px 12px}.codeblock-example.prettyprint-example-only{border:1px solid #e1e4e5;margin-bottom:24px}.codeblock,pre.literal-block,.rst-content .literal-block,.rst-content pre.literal-block,div[class^='highlight']{border:1px solid #e1e4e5;padding:0px;overflow-x:auto;background:#fff;margin:1px 0 24px 0}.codeblock div[class^='highlight'],pre.literal-block div[class^='highlight'],.rst-content .literal-block div[class^='highlight'],div[class^='highlight'] div[class^='highlight']{border:none;background:none;margin:0}div[class^='highlight'] td.code{width:100%}.linenodiv pre{border-right:solid 1px #e6e9ea;margin:0;padding:12px 12px;font-family:Consolas,"Andale Mono WT","Andale Mono","Lucida Console","Lucida Sans Typewriter","DejaVu Sans Mono","Bitstream Vera Sans Mono","Liberation Mono","Nimbus Mono L",Monaco,"Courier New",Courier,monospace;font-size:12px;line-height:1.5;color:#d9d9d9}div[class^='highlight'] pre{white-space:pre;margin:0;padding:12px 12px;font-family:Consolas,"Andale Mono WT","Andale Mono","Lucida Console","Lucida Sans Typewriter","DejaVu Sans Mono","Bitstream Vera Sans Mono","Liberation Mono","Nimbus Mono L",Monaco,"Courier New",Courier,monospace;font-size:12px;line-height:1.5;display:block;overflow:auto;color:#404040}@media print{.codeblock,pre.literal-block,.rst-content .literal-block,.rst-content pre.literal-block,div[class^='highlight'],div[class^='highlight'] pre{white-space:pre-wrap}}.hll{background-color:#ffc;margin:0 -12px;padding:0 12px;display:block}.c{color:#998;font-style:italic}.err{color:#a61717;background-color:#e3d2d2}.k{font-weight:bold}.o{font-weight:bold}.cm{color:#998;font-style:italic}.cp{color:#999;font-weight:bold}.c1{color:#998;font-style:italic}.cs{color:#999;font-weight:bold;font-style:italic}.gd{color:#000;background-color:#fdd}.gd .x{color:#000;background-color:#faa}.ge{font-style:italic}.gr{color:#a00}.gh{color:#999}.gi{color:#000;background-color:#dfd}.gi .x{color:#000;background-color:#afa}.go{color:#888}.gp{color:#555}.gs{font-weight:bold}.gu{color:purple;font-weight:bold}.gt{color:#a00}.kc{font-weight:bold}.kd{font-weight:bold}.kn{font-weight:bold}.kp{font-weight:bold}.kr{font-weight:bold}.kt{color:#458;font-weight:bold}.m{color:#099}.s{color:#d14}.n{color:#333}.na{color:teal}.nb{color:#0086b3}.nc{color:#458;font-weight:bold}.no{color:teal}.ni{color:purple}.ne{color:#900;font-weight:bold}.nf{color:#900;font-weight:bold}.nn{color:#555}.nt{color:navy}.nv{color:teal}.ow{font-weight:bold}.w{color:#bbb}.mf{color:#099}.mh{color:#099}.mi{color:#099}.mo{color:#099}.sb{color:#d14}.sc{color:#d14}.sd{color:#d14}.s2{color:#d14}.se{color:#d14}.sh{color:#d14}.si{color:#d14}.sx{color:#d14}.sr{color:#009926}.s1{color:#d14}.ss{color:#990073}.bp{color:#999}.vc{color:teal}.vg{color:teal}.vi{color:teal}.il{color:#099}.gc{color:#999;background-color:#EAF2F5}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical header{height:32px;display:inline-block;line-height:32px;padding:0 1.618em;display:block;font-weight:bold;text-transform:uppercase;font-size:80%;color:#2980B9;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:gray;border-right:solid 1px #c9c9c9;padding:0.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;padding:0.4045em 1.618em;font-weight:bold;position:relative;background:#fcfcfc;border:none;border-bottom:solid 1px #c9c9c9;border-top:solid 1px #c9c9c9;padding-left:1.618em -4px}.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;padding:0.4045em 2.427em}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical .local-toc li ul{display:block}.wy-menu-vertical li ul li a{margin-bottom:0;color:#b3b3b3;font-weight:normal}.wy-menu-vertical a{display:inline-block;line-height:18px;padding:0.4045em 1.618em;display:block;position:relative;font-size:90%;color:#b3b3b3}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:active{background-color:#2980B9;cursor:pointer;color:#fff}.wy-side-nav-search{z-index:200;background-color:#2980B9;text-align:center;padding:0.809em;display:block;color:#fcfcfc;margin-bottom:0.809em}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto 0.809em auto;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;font-size:100%;font-weight:bold;display:inline-block;padding:4px 6px;margin-bottom:0.809em}.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}.wy-nav .wy-menu-vertical header{color:#2980B9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980B9;color:#fff}[data-menu-wrap]{-webkit-transition:all 0.2s ease-in;-moz-transition:all 0.2s ease-in;transition:all 0.2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:left repeat-y #fcfcfc;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyRpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMy1jMDExIDY2LjE0NTY2MSwgMjAxMi8wMi8wNi0xNDo1NjoyNyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoTWFjaW50b3NoKSIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDoxOERBMTRGRDBFMUUxMUUzODUwMkJCOThDMEVFNURFMCIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDoxOERBMTRGRTBFMUUxMUUzODUwMkJCOThDMEVFNURFMCI+IDx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOjE4REExNEZCMEUxRTExRTM4NTAyQkI5OEMwRUU1REUwIiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOjE4REExNEZDMEUxRTExRTM4NTAyQkI5OEMwRUU1REUwIi8+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+EwrlwAAAAA5JREFUeNpiMDU0BAgwAAE2AJgB9BnaAAAAAElFTkSuQmCC);background-size:300px 1px}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:absolute;top:0;left:0;width:300px;overflow:hidden;min-height:100%;background:#343131;z-index:200}.wy-nav-top{display:none;background:#2980B9;color:#fff;padding:0.4045em 0.809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:before,.wy-nav-top:after{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:bold}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,0.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:#999}footer p{margin-bottom:12px}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;content:""}.rst-footer-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:solid 1px #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:solid 1px #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:gray;font-size:90%}@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width: 1400px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,footer,.wy-nav-side{display:none}.wy-nav-content-wrap{margin-left:0}}nav.stickynav{position:fixed;top:0}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .icon{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}.rst-content img{max-width:100%;height:auto !important}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure.align-center{text-align:center}.rst-content .section>img{margin-bottom:24px}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;border-color:rgba(0,0,0,0.1) !important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}.rst-content .line-block{margin-left:24px}.rst-content .topic-title{font-weight:bold;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0px 0px 24px 24px}.rst-content .align-left{float:left;margin:0px 24px 24px 0px}.rst-content .align-center{margin:auto;display:block}.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink{display:none;visibility:hidden;font-size:14px}.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after{visibility:visible;content:"";font-family:FontAwesome;display:inline-block}.rst-content h1:hover .headerlink,.rst-content h2:hover .headerlink,.rst-content h3:hover .headerlink,.rst-content h4:hover .headerlink,.rst-content h5:hover .headerlink,.rst-content h6:hover .headerlink,.rst-content dl dt:hover .headerlink{display:inline-block}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:solid 1px #e1e4e5}.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}.rst-content .sidebar .last{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif;font-weight:bold;background:#e1e4e5;padding:6px 12px;margin:-24px;margin-bottom:24px;font-size:100%}.rst-content .highlighted{background:#F1C40F;display:inline-block;font-weight:bold;padding:0 6px}.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:super;font-size:90%}.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;border:none;color:#999}.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;background-color:transparent !important;white-space:normal}.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}.rst-content table.field-list{border:none}.rst-content table.field-list td{border:none;padding-top:5px}.rst-content table.field-list td>strong{display:inline-block;margin-top:3px}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left;padding-left:0}.rst-content tt{color:#000}.rst-content tt big,.rst-content tt em{font-size:100% !important;line-height:normal}.rst-content tt .xref,a .rst-content tt{font-weight:bold}.rst-content a tt{color:#2980B9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:bold}.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}.rst-content dl dd{margin:0 0 12px 24px}.rst-content dl:not(.docutils){margin-bottom:24px}.rst-content dl:not(.docutils) dt{display:inline-block;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980B9;border-top:solid 3px #6ab0de;padding:6px;position:relative}.rst-content dl:not(.docutils) dt:before{color:#6ab0de}.rst-content dl:not(.docutils) dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;border:none;border-left:solid 3px #ccc;background:#f0f0f0;color:gray}.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dt:first-child{margin-top:0}.rst-content dl:not(.docutils) tt{font-weight:bold}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname{background-color:transparent;border:none;padding:0;font-size:100% !important}.rst-content dl:not(.docutils) tt.descname{font-weight:bold}.rst-content dl:not(.docutils) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:bold}.rst-content dl:not(.docutils) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;color:#27AE60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:bold}@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}}span[id*='MathJax-Span']{color:#404040}.math{text-align:center} diff --git a/doc/html/css/theme_extra.css b/doc/html/css/theme_extra.css new file mode 100644 index 00000000..e53d320a --- /dev/null +++ b/doc/html/css/theme_extra.css @@ -0,0 +1,193 @@ +/* + * Sphinx doesn't have support for section dividers like we do in + * MkDocs, this styles the section titles in the nav + * + * https://github.com/mkdocs/mkdocs/issues/175 + */ +.wy-menu-vertical span { + line-height: 18px; + padding: 0.4045em 1.618em; + display: block; + position: relative; + font-size: 90%; + color: #838383; +} + +.wy-menu-vertical .subnav a { + padding: 0.4045em 2.427em; +} + +/* + * Long navigations run off the bottom of the screen as the nav + * area doesn't scroll. + * + * https://github.com/mkdocs/mkdocs/pull/202 + * + * Builds upon pull 202 https://github.com/mkdocs/mkdocs/pull/202 + * to make toc scrollbar end before navigations buttons to not be overlapping. + */ +.wy-nav-side { + height: calc(100% - 45px); + overflow-y: auto; + min-height: 0; +} + +.rst-versions{ + border-top: 0; + height: 45px; +} + +@media screen and (max-width: 768px) { + .wy-nav-side { + height: 100%; + } +} + +/* + * readthedocs theme hides nav items when the window height is + * too small to contain them. + * + * https://github.com/mkdocs/mkdocs/issues/#348 + */ +.wy-menu-vertical ul { + margin-bottom: 2em; +} + +/* + * Wrap inline code samples otherwise they shoot of the side and + * can't be read at all. + * + * https://github.com/mkdocs/mkdocs/issues/313 + * https://github.com/mkdocs/mkdocs/issues/233 + * https://github.com/mkdocs/mkdocs/issues/834 + */ +code { + white-space: pre-wrap; + word-wrap: break-word; + padding: 2px 5px; +} + +/** + * Make code blocks display as blocks and give them the appropriate + * font size and padding. + * + * https://github.com/mkdocs/mkdocs/issues/855 + * https://github.com/mkdocs/mkdocs/issues/834 + * https://github.com/mkdocs/mkdocs/issues/233 + */ +pre code { + white-space: pre; + word-wrap: normal; + display: block; + padding: 12px; + font-size: 12px; +} + +/* + * Fix link colors when the link text is inline code. + * + * https://github.com/mkdocs/mkdocs/issues/718 + */ +a code { + color: #2980B9; +} +a:hover code { + color: #3091d1; +} +a:visited code { + color: #9B59B6; +} + +/* + * The CSS classes from highlight.js seem to clash with the + * ReadTheDocs theme causing some code to be incorrectly made + * bold and italic. + * + * https://github.com/mkdocs/mkdocs/issues/411 + */ +pre .cs, pre .c { + font-weight: inherit; + font-style: inherit; +} + +/* + * Fix some issues with the theme and non-highlighted code + * samples. Without and highlighting styles attached the + * formatting is broken. + * + * https://github.com/mkdocs/mkdocs/issues/319 + */ +.no-highlight { + display: block; + padding: 0.5em; + color: #333; +} + + +/* + * Additions specific to the search functionality provided by MkDocs + */ + +.search-results article { + margin-top: 23px; + border-top: 1px solid #E1E4E5; + padding-top: 24px; +} + +.search-results article:first-child { + border-top: none; +} + +form .search-query { + width: 100%; + border-radius: 50px; + padding: 6px 12px; /* csslint allow: box-model */ + border-color: #D1D4D5; +} + +.wy-menu-vertical li ul { + display: inherit; +} + +.wy-menu-vertical li ul.subnav ul.subnav{ + padding-left: 1em; +} + +.wy-menu-vertical .subnav li.current > a { + padding-left: 2.42em; +} +.wy-menu-vertical .subnav li.current > ul li a { + padding-left: 3.23em; +} + +/* + * Improve inline code blocks within admonitions. + * + * https://github.com/mkdocs/mkdocs/issues/656 + */ + .admonition code { + color: #404040; + border: 1px solid #c7c9cb; + border: 1px solid rgba(0, 0, 0, 0.2); + background: #f8fbfd; + background: rgba(255, 255, 255, 0.7); +} + +/* + * Account for wide tables which go off the side. + * Override borders to avoid wierdness on narrow tables. + * + * https://github.com/mkdocs/mkdocs/issues/834 + * https://github.com/mkdocs/mkdocs/pull/1034 + */ +.rst-content .section .docutils { + width: 100%; + overflow: auto; + display: block; + border: none; +} + +td, th { + border: 1px solid #e1e4e5 !important; /* csslint allow: important */ + border-collapse: collapse; +} diff --git a/doc/html/fonts/fontawesome-webfont.eot b/doc/html/fonts/fontawesome-webfont.eot new file mode 100644 index 0000000000000000000000000000000000000000..0662cb96bfb78cb2603df4bc9995314bd6806312 GIT binary patch literal 37405 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�-A&iY%khEsGVMaq&$BJA^QAs8x>7-g_ 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 k3oQ8fX5bK*@j<^ZuhPaXzhu&RG++`-oM{J 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 literal 0 HcmV?d00001 diff --git a/doc/github-markdown.css b/doc/html/github-markdown.css similarity index 100% rename from doc/github-markdown.css rename to doc/html/github-markdown.css diff --git a/doc/images/bookmarklet.png b/doc/html/images/bookmarklet.png similarity index 100% rename from doc/images/bookmarklet.png rename to doc/html/images/bookmarklet.png diff --git a/doc/images/doc-logo.png b/doc/html/images/doc-logo.png similarity index 100% rename from doc/images/doc-logo.png rename to doc/html/images/doc-logo.png diff --git a/doc/images/doc-logo.svg b/doc/html/images/doc-logo.svg similarity index 100% rename from doc/images/doc-logo.svg rename to doc/html/images/doc-logo.svg diff --git a/doc/images/firefoxshare.png b/doc/html/images/firefoxshare.png similarity index 100% rename from doc/images/firefoxshare.png rename to doc/html/images/firefoxshare.png diff --git a/doc/images/rss-filter-1.png b/doc/html/images/rss-filter-1.png similarity index 100% rename from doc/images/rss-filter-1.png rename to doc/html/images/rss-filter-1.png diff --git a/doc/images/rss-filter-2.png b/doc/html/images/rss-filter-2.png similarity index 100% rename from doc/images/rss-filter-2.png rename to doc/html/images/rss-filter-2.png diff --git a/doc/html/img/favicon.ico b/doc/html/img/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..e85006a3ce1c6fd81faa6d5a13095519c4a6fc96 GIT binary patch literal 1150 zcmd6lF-yZh9L1kl>(HSEK`2y^4yB6->f+$wD)=oNY!UheIt03Q=;qj=;8*Bap_4*& za8yAl;wmmx5Yyi^7dXN-WYdJ-{qNqpcez|5t#Fr0qTSYcPTG`I2PBk8r$~4kg^0zN zCJe(rhix3do!L$bZ+IuZ{i08x=JR3=e+M4pv0KsKA??{u_*EFfo|`p&t`Vf=jn{)F z1fKk9hWsmYwqWAP^JO*5u*R;*L&dX3H$%S7oB$f0{ISh{QVXuncnzN67WQH2`lip7 zhX+VI$6x$1+$8gMjh4+1l0N#8_0Fh=N#EwpKk{SeE!)SHFB@xQFX3y+8sF#_@!bDW eIdI-IC`$c%>bk?KbPeN9RHtL<1^)v~#xMt8oB^@` literal 0 HcmV?d00001 diff --git a/doc/html/index.html b/doc/html/index.html new file mode 100644 index 00000000..a9b0c7b9 --- /dev/null +++ b/doc/html/index.html @@ -0,0 +1,344 @@ + + + + + + + + + + + Home - Shaarli Documentation + + + + + + + + + + + + + + + + + +

+ + + + +
+ + + + + +
+
+
+ +
+
+
+
+ +

Welcome to the Shaarli wiki!

+

Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli.

+

For general info, read the README.

+

If you have any questions or ideas, please join the chat (also reachable via IRC), post them in our general discussion (archive) or read the current issues. If you've found a bug, please create a new issue.

+

If you would like a feature added to Shaarli, check the issues labeled feature, enhancement, and plugin.

+

Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the doc/ directory of your Shaarli installation.

+ +
+
+ + +
+
+ +
+ +
+ +
+ + + GitHub + + + + Next » + + +
+ + + + + + diff --git a/doc/html/js/highlight.pack.js b/doc/html/js/highlight.pack.js new file mode 100644 index 00000000..a5818dfb --- /dev/null +++ b/doc/html/js/highlight.pack.js @@ -0,0 +1,2 @@ +!function(e){"undefined"!=typeof exports?e(exports):(window.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return window.hljs}))}(function(e){function n(e){return e.replace(/&/gm,"&").replace(//gm,">")}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0==t.index}function a(e){var n=(e.className+" "+(e.parentNode?e.parentNode.className:"")).split(/\s+/);return n=n.map(function(e){return e.replace(/^lang(uage)?-/,"")}),n.filter(function(e){return N(e)||/no(-?)highlight|plain|text/.test(e)})[0]}function i(e,n){var t,r={};for(t in e)r[t]=e[t];if(n)for(t in n)r[t]=n[t];return r}function o(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3==i.nodeType?a+=i.nodeValue.length:1==i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function u(e,r,a){function i(){return e.length&&r.length?e[0].offset!=r[0].offset?e[0].offset"}function u(e){l+=""}function c(e){("start"==e.event?o:u)(e.node)}for(var s=0,l="",f=[];e.length||r.length;){var g=i();if(l+=n(a.substr(s,g[0].offset-s)),s=g[0].offset,g==e){f.reverse().forEach(u);do c(g.splice(0,1)[0]),g=i();while(g==e&&g.length&&g[0].offset==s);f.reverse().forEach(o)}else"start"==g[0].event?f.push(g[0].node):f.pop(),c(g.splice(0,1)[0])}return l+n(a.substr(s))}function c(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,o){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var u={},c=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");u[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?c("keyword",a.k):Object.keys(a.k).forEach(function(e){c(e,a.k[e])}),a.k=u}a.lR=t(a.l||/\b\w+\b/,!0),o&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&o.tE&&(a.tE+=(a.e?"|":"")+o.tE)),a.i&&(a.iR=t(a.i)),void 0===a.r&&(a.r=1),a.c||(a.c=[]);var s=[];a.c.forEach(function(e){e.v?e.v.forEach(function(n){s.push(i(e,n))}):s.push("self"==e?a:e)}),a.c=s,a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,o);var l=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=l.length?t(l.join("|"),!0):{exec:function(){return null}}}}r(e)}function s(e,t,a,i){function o(e,n){for(var t=0;t";return i+=e+'">',i+n+o}function d(){if(!L.k)return n(y);var e="",t=0;L.lR.lastIndex=0;for(var r=L.lR.exec(y);r;){e+=n(y.substr(t,r.index-t));var a=g(L,r);a?(B+=a[1],e+=p(a[0],n(r[0]))):e+=n(r[0]),t=L.lR.lastIndex,r=L.lR.exec(y)}return e+n(y.substr(t))}function h(){if(L.sL&&!w[L.sL])return n(y);var e=L.sL?s(L.sL,y,!0,M[L.sL]):l(y);return L.r>0&&(B+=e.r),"continuous"==L.subLanguageMode&&(M[L.sL]=e.top),p(e.language,e.value,!1,!0)}function b(){return void 0!==L.sL?h():d()}function v(e,t){var r=e.cN?p(e.cN,"",!0):"";e.rB?(k+=r,y=""):e.eB?(k+=n(t)+r,y=""):(k+=r,y=t),L=Object.create(e,{parent:{value:L}})}function m(e,t){if(y+=e,void 0===t)return k+=b(),0;var r=o(t,L);if(r)return k+=b(),v(r,t),r.rB?0:t.length;var a=u(L,t);if(a){var i=L;i.rE||i.eE||(y+=t),k+=b();do L.cN&&(k+=""),B+=L.r,L=L.parent;while(L!=a.parent);return i.eE&&(k+=n(t)),y="",a.starts&&v(a.starts,""),i.rE?0:t.length}if(f(t,L))throw new Error('Illegal lexeme "'+t+'" for mode "'+(L.cN||"")+'"');return y+=t,t.length||1}var E=N(e);if(!E)throw new Error('Unknown language: "'+e+'"');c(E);var R,L=i||E,M={},k="";for(R=L;R!=E;R=R.parent)R.cN&&(k=p(R.cN,"",!0)+k);var y="",B=0;try{for(var C,j,I=0;;){if(L.t.lastIndex=I,C=L.t.exec(t),!C)break;j=m(t.substr(I,C.index-I),C[0]),I=C.index+j}for(m(t.substr(I)),R=L;R.parent;R=R.parent)R.cN&&(k+="");return{r:B,value:k,language:e,top:L}}catch(S){if(-1!=S.message.indexOf("Illegal"))return{r:0,value:n(t)};throw S}}function l(e,t){t=t||x.languages||Object.keys(w);var r={r:0,value:n(e)},a=r;return t.forEach(function(n){if(N(n)){var t=s(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}}),a.language&&(r.second_best=a),r}function f(e){return x.tabReplace&&(e=e.replace(/^((<[^>]+>|\t)+)/gm,function(e,n){return n.replace(/\t/g,x.tabReplace)})),x.useBR&&(e=e.replace(/\n/g,"
")),e}function g(e,n,t){var r=n?E[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function p(e){var n=a(e);if(!/no(-?)highlight|plain|text/.test(n)){var t;x.useBR?(t=document.createElementNS("http://www.w3.org/1999/xhtml","div"),t.innerHTML=e.innerHTML.replace(/\n/g,"").replace(//g,"\n")):t=e;var r=t.textContent,i=n?s(n,r,!0):l(r),c=o(t);if(c.length){var p=document.createElementNS("http://www.w3.org/1999/xhtml","div");p.innerHTML=i.value,i.value=u(c,o(p),r)}i.value=f(i.value),e.innerHTML=i.value,e.className=g(e.className,n,i.language),e.result={language:i.language,re:i.r},i.second_best&&(e.second_best={language:i.second_best.language,re:i.second_best.r})}}function d(e){x=i(x,e)}function h(){if(!h.called){h.called=!0;var e=document.querySelectorAll("pre code");Array.prototype.forEach.call(e,p)}}function b(){addEventListener("DOMContentLoaded",h,!1),addEventListener("load",h,!1)}function v(n,t){var r=w[n]=t(e);r.aliases&&r.aliases.forEach(function(e){E[e]=n})}function m(){return Object.keys(w)}function N(e){return w[e]||w[E[e]]}var x={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0},w={},E={};return e.highlight=s,e.highlightAuto=l,e.fixMarkup=f,e.highlightBlock=p,e.configure=d,e.initHighlighting=h,e.initHighlightingOnLoad=b,e.registerLanguage=v,e.listLanguages=m,e.getLanguage=N,e.inherit=i,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="\\b(0[xX][a-fA-F0-9]+|(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e});hljs.registerLanguage("objectivec",function(e){var t={cN:"built_in",b:"(AV|CA|CF|CG|CI|MK|MP|NS|UI)\\w+"},i={keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},o=/[a-zA-Z@][a-zA-Z0-9_]*/,n="@interface @class @protocol @implementation";return{aliases:["m","mm","objc","obj-c"],k:i,l:o,i:""}]}]},{cN:"class",b:"("+n.split(" ").join("|")+")\\b",e:"({|$)",eE:!0,k:n,l:o,c:[e.UTM]},{cN:"variable",b:"\\."+e.UIR,r:0}]}});hljs.registerLanguage("sql",function(e){var t=e.C("--","$");return{cI:!0,i:/[<>]/,c:[{cN:"operator",bK:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate savepoint release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke",e:/;/,eW:!0,k:{keyword:"abs absolute acos action add adddate addtime aes_decrypt aes_encrypt after aggregate all allocate alter analyze and any are as asc ascii asin assertion at atan atan2 atn2 authorization authors avg backup before begin benchmark between bin binlog bit_and bit_count bit_length bit_or bit_xor both by cache call cascade cascaded case cast catalog ceil ceiling chain change changed char_length character_length charindex charset check checksum checksum_agg choose close coalesce coercibility collate collation collationproperty column columns columns_updated commit compress concat concat_ws concurrent connect connection connection_id consistent constraint constraints continue contributors conv convert convert_tz corresponding cos cot count count_big crc32 create cross cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime data database databases datalength date_add date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts datetimeoffsetfromparts day dayname dayofmonth dayofweek dayofyear deallocate declare decode default deferrable deferred degrees delayed delete des_decrypt des_encrypt des_key_file desc describe descriptor diagnostics difference disconnect distinct distinctrow div do domain double drop dumpfile each else elt enclosed encode encrypt end end-exec engine engines eomonth errors escape escaped event eventdata events except exception exec execute exists exp explain export_set extended external extract fast fetch field fields find_in_set first first_value floor flush for force foreign format found found_rows from from_base64 from_days from_unixtime full function get get_format get_lock getdate getutcdate global go goto grant grants greatest group group_concat grouping grouping_id gtid_subset gtid_subtract handler having help hex high_priority hosts hour ident_current ident_incr ident_seed identified identity if ifnull ignore iif ilike immediate in index indicator inet6_aton inet6_ntoa inet_aton inet_ntoa infile initially inner innodb input insert install instr intersect into is is_free_lock is_ipv4 is_ipv4_compat is_ipv4_mapped is_not is_not_null is_used_lock isdate isnull isolation join key kill language last last_day last_insert_id last_value lcase lead leading least leaves left len lenght level like limit lines ln load load_file local localtime localtimestamp locate lock log log10 log2 logfile logs low_priority lower lpad ltrim make_set makedate maketime master master_pos_wait match matched max md5 medium merge microsecond mid min minute mod mode module month monthname mutex name_const names national natural nchar next no no_write_to_binlog not now nullif nvarchar oct octet_length of old_password on only open optimize option optionally or ord order outer outfile output pad parse partial partition password patindex percent_rank percentile_cont percentile_disc period_add period_diff pi plugin position pow power pragma precision prepare preserve primary prior privileges procedure procedure_analyze processlist profile profiles public publishingservername purge quarter query quick quote quotename radians rand read references regexp relative relaylog release release_lock rename repair repeat replace replicate reset restore restrict return returns reverse revoke right rlike rollback rollup round row row_count rows rpad rtrim savepoint schema scroll sec_to_time second section select serializable server session session_user set sha sha1 sha2 share show sign sin size slave sleep smalldatetimefromparts snapshot some soname soundex sounds_like space sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_no_cache sql_small_result sql_variant_property sqlstate sqrt square start starting status std stddev stddev_pop stddev_samp stdev stdevp stop str str_to_date straight_join strcmp string stuff subdate substr substring subtime subtring_index sum switchoffset sysdate sysdatetime sysdatetimeoffset system_user sysutcdatetime table tables tablespace tan temporary terminated tertiary_weights then time time_format time_to_sec timediff timefromparts timestamp timestampadd timestampdiff timezone_hour timezone_minute to to_base64 to_days to_seconds todatetimeoffset trailing transaction translation trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse ucase uncompress uncompressed_length unhex unicode uninstall union unique unix_timestamp unknown unlock update upgrade upped upper usage use user user_resources using utc_date utc_time utc_timestamp uuid uuid_short validate_password_strength value values var var_pop var_samp variables variance varp version view warnings week weekday weekofyear weight_string when whenever where with work write xml xor year yearweek zon",literal:"true false null",built_in:"array bigint binary bit blob boolean char character date dec decimal float int integer interval number numeric real serial smallint varchar varying int8 serial8 text"},c:[{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]},{cN:"string",b:'"',e:'"',c:[e.BE,{b:'""'}]},{cN:"string",b:"`",e:"`",c:[e.BE]},e.CNM,e.CBCM,t]},e.CBCM,t]}});hljs.registerLanguage("javascript",function(e){return{aliases:["js"],k:{keyword:"in of if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const export super debugger as await",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document Symbol Set Map WeakSet WeakMap Proxy Reflect Promise"},c:[{cN:"pi",r:10,v:[{b:/^\s*('|")use strict('|")/},{b:/^\s*('|")use asm('|")/}]},e.ASM,e.QSM,{cN:"string",b:"`",e:"`",c:[e.BE,{cN:"subst",b:"\\$\\{",e:"\\}"}]},e.CLCM,e.CBCM,{cN:"number",b:"\\b(0[xXbBoO][a-fA-F0-9]+|(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",r:0},{b:"("+e.RSR+"|\\b(case|return|throw)\\b)\\s*",k:"return throw case",c:[e.CLCM,e.CBCM,e.RM,{b:/\s*[);\]]/,r:0,sL:"xml"}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:/[A-Za-z$_][0-9A-Za-z$_]*/}),{cN:"params",b:/\(/,e:/\)/,c:[e.CLCM,e.CBCM],i:/["'\(]/}],i:/\[|%/},{b:/\$[(.]/},{b:"\\."+e.IR,r:0},{bK:"import",e:"[;$]",k:"import from as",c:[e.ASM,e.QSM]},{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]}]}});hljs.registerLanguage("scss",function(e){{var t="[a-zA-Z-][a-zA-Z0-9_-]*",i={cN:"variable",b:"(\\$"+t+")\\b"},r={cN:"function",b:t+"\\(",rB:!0,eE:!0,e:"\\("},o={cN:"hexcolor",b:"#[0-9A-Fa-f]+"};({cN:"attribute",b:"[A-Z\\_\\.\\-]+",e:":",eE:!0,i:"[^\\s]",starts:{cN:"value",eW:!0,eE:!0,c:[r,o,e.CSSNM,e.QSM,e.ASM,e.CBCM,{cN:"important",b:"!important"}]}})}return{cI:!0,i:"[=/|']",c:[e.CLCM,e.CBCM,r,{cN:"id",b:"\\#[A-Za-z0-9_-]+",r:0},{cN:"class",b:"\\.[A-Za-z0-9_-]+",r:0},{cN:"attr_selector",b:"\\[",e:"\\]",i:"$"},{cN:"tag",b:"\\b(a|abbr|acronym|address|area|article|aside|audio|b|base|big|blockquote|body|br|button|canvas|caption|cite|code|col|colgroup|command|datalist|dd|del|details|dfn|div|dl|dt|em|embed|fieldset|figcaption|figure|footer|form|frame|frameset|(h[1-6])|head|header|hgroup|hr|html|i|iframe|img|input|ins|kbd|keygen|label|legend|li|link|map|mark|meta|meter|nav|noframes|noscript|object|ol|optgroup|option|output|p|param|pre|progress|q|rp|rt|ruby|samp|script|section|select|small|span|strike|strong|style|sub|sup|table|tbody|td|textarea|tfoot|th|thead|time|title|tr|tt|ul|var|video)\\b",r:0},{cN:"pseudo",b:":(visited|valid|root|right|required|read-write|read-only|out-range|optional|only-of-type|only-child|nth-of-type|nth-last-of-type|nth-last-child|nth-child|not|link|left|last-of-type|last-child|lang|invalid|indeterminate|in-range|hover|focus|first-of-type|first-line|first-letter|first-child|first|enabled|empty|disabled|default|checked|before|after|active)"},{cN:"pseudo",b:"::(after|before|choices|first-letter|first-line|repeat-index|repeat-item|selection|value)"},i,{cN:"attribute",b:"\\b(z-index|word-wrap|word-spacing|word-break|width|widows|white-space|visibility|vertical-align|unicode-bidi|transition-timing-function|transition-property|transition-duration|transition-delay|transition|transform-style|transform-origin|transform|top|text-underline-position|text-transform|text-shadow|text-rendering|text-overflow|text-indent|text-decoration-style|text-decoration-line|text-decoration-color|text-decoration|text-align-last|text-align|tab-size|table-layout|right|resize|quotes|position|pointer-events|perspective-origin|perspective|page-break-inside|page-break-before|page-break-after|padding-top|padding-right|padding-left|padding-bottom|padding|overflow-y|overflow-x|overflow-wrap|overflow|outline-width|outline-style|outline-offset|outline-color|outline|orphans|order|opacity|object-position|object-fit|normal|none|nav-up|nav-right|nav-left|nav-index|nav-down|min-width|min-height|max-width|max-height|mask|marks|margin-top|margin-right|margin-left|margin-bottom|margin|list-style-type|list-style-position|list-style-image|list-style|line-height|letter-spacing|left|justify-content|initial|inherit|ime-mode|image-orientation|image-resolution|image-rendering|icon|hyphens|height|font-weight|font-variant-ligatures|font-variant|font-style|font-stretch|font-size-adjust|font-size|font-language-override|font-kerning|font-feature-settings|font-family|font|float|flex-wrap|flex-shrink|flex-grow|flex-flow|flex-direction|flex-basis|flex|filter|empty-cells|display|direction|cursor|counter-reset|counter-increment|content|column-width|column-span|column-rule-width|column-rule-style|column-rule-color|column-rule|column-gap|column-fill|column-count|columns|color|clip-path|clip|clear|caption-side|break-inside|break-before|break-after|box-sizing|box-shadow|box-decoration-break|bottom|border-width|border-top-width|border-top-style|border-top-right-radius|border-top-left-radius|border-top-color|border-top|border-style|border-spacing|border-right-width|border-right-style|border-right-color|border-right|border-radius|border-left-width|border-left-style|border-left-color|border-left|border-image-width|border-image-source|border-image-slice|border-image-repeat|border-image-outset|border-image|border-color|border-collapse|border-bottom-width|border-bottom-style|border-bottom-right-radius|border-bottom-left-radius|border-bottom-color|border-bottom|border|background-size|background-repeat|background-position|background-origin|background-image|background-color|background-clip|background-attachment|background-blend-mode|background|backface-visibility|auto|animation-timing-function|animation-play-state|animation-name|animation-iteration-count|animation-fill-mode|animation-duration|animation-direction|animation-delay|animation|align-self|align-items|align-content)\\b",i:"[^\\s]"},{cN:"value",b:"\\b(whitespace|wait|w-resize|visible|vertical-text|vertical-ideographic|uppercase|upper-roman|upper-alpha|underline|transparent|top|thin|thick|text|text-top|text-bottom|tb-rl|table-header-group|table-footer-group|sw-resize|super|strict|static|square|solid|small-caps|separate|se-resize|scroll|s-resize|rtl|row-resize|ridge|right|repeat|repeat-y|repeat-x|relative|progress|pointer|overline|outside|outset|oblique|nowrap|not-allowed|normal|none|nw-resize|no-repeat|no-drop|newspaper|ne-resize|n-resize|move|middle|medium|ltr|lr-tb|lowercase|lower-roman|lower-alpha|loose|list-item|line|line-through|line-edge|lighter|left|keep-all|justify|italic|inter-word|inter-ideograph|inside|inset|inline|inline-block|inherit|inactive|ideograph-space|ideograph-parenthesis|ideograph-numeric|ideograph-alpha|horizontal|hidden|help|hand|groove|fixed|ellipsis|e-resize|double|dotted|distribute|distribute-space|distribute-letter|distribute-all-lines|disc|disabled|default|decimal|dashed|crosshair|collapse|col-resize|circle|char|center|capitalize|break-word|break-all|bottom|both|bolder|bold|block|bidi-override|below|baseline|auto|always|all-scroll|absolute|table|table-cell)\\b"},{cN:"value",b:":",e:";",c:[r,i,o,e.CSSNM,e.QSM,e.ASM,{cN:"important",b:"!important"}]},{cN:"at_rule",b:"@",e:"[{;]",k:"mixin include extend for if else each while charset import debug media page content font-face namespace warn",c:[r,i,e.QSM,e.ASM,o,e.CSSNM,{cN:"preprocessor",b:"\\s[A-Za-z0-9_.-]+",r:0}]}]}});hljs.registerLanguage("mel",function(e){return{k:"int float string vector matrix if else switch case default while do for in break continue global proc return about abs addAttr addAttributeEditorNodeHelp addDynamic addNewShelfTab addPP addPanelCategory addPrefixToName advanceToNextDrivenKey affectedNet affects aimConstraint air alias aliasAttr align alignCtx alignCurve alignSurface allViewFit ambientLight angle angleBetween animCone animCurveEditor animDisplay animView annotate appendStringArray applicationName applyAttrPreset applyTake arcLenDimContext arcLengthDimension arclen arrayMapper art3dPaintCtx artAttrCtx artAttrPaintVertexCtx artAttrSkinPaintCtx artAttrTool artBuildPaintMenu artFluidAttrCtx artPuttyCtx artSelectCtx artSetPaintCtx artUserPaintCtx assignCommand assignInputDevice assignViewportFactories attachCurve attachDeviceAttr attachSurface attrColorSliderGrp attrCompatibility attrControlGrp attrEnumOptionMenu attrEnumOptionMenuGrp attrFieldGrp attrFieldSliderGrp attrNavigationControlGrp attrPresetEditWin attributeExists attributeInfo attributeMenu attributeQuery autoKeyframe autoPlace bakeClip bakeFluidShading bakePartialHistory bakeResults bakeSimulation basename basenameEx batchRender bessel bevel bevelPlus binMembership bindSkin blend2 blendShape blendShapeEditor blendShapePanel blendTwoAttr blindDataType boneLattice boundary boxDollyCtx boxZoomCtx bufferCurve buildBookmarkMenu buildKeyframeMenu button buttonManip CBG cacheFile cacheFileCombine cacheFileMerge cacheFileTrack camera cameraView canCreateManip canvas capitalizeString catch catchQuiet ceil changeSubdivComponentDisplayLevel changeSubdivRegion channelBox character characterMap characterOutlineEditor characterize chdir checkBox checkBoxGrp checkDefaultRenderGlobals choice circle circularFillet clamp clear clearCache clip clipEditor clipEditorCurrentTimeCtx clipSchedule clipSchedulerOutliner clipTrimBefore closeCurve closeSurface cluster cmdFileOutput cmdScrollFieldExecuter cmdScrollFieldReporter cmdShell coarsenSubdivSelectionList collision color colorAtPoint colorEditor colorIndex colorIndexSliderGrp colorSliderButtonGrp colorSliderGrp columnLayout commandEcho commandLine commandPort compactHairSystem componentEditor compositingInterop computePolysetVolume condition cone confirmDialog connectAttr connectControl connectDynamic connectJoint connectionInfo constrain constrainValue constructionHistory container containsMultibyte contextInfo control convertFromOldLayers convertIffToPsd convertLightmap convertSolidTx convertTessellation convertUnit copyArray copyFlexor copyKey copySkinWeights cos cpButton cpCache cpClothSet cpCollision cpConstraint cpConvClothToMesh cpForces cpGetSolverAttr cpPanel cpProperty cpRigidCollisionFilter cpSeam cpSetEdit cpSetSolverAttr cpSolver cpSolverTypes cpTool cpUpdateClothUVs createDisplayLayer createDrawCtx createEditor createLayeredPsdFile createMotionField createNewShelf createNode createRenderLayer createSubdivRegion cross crossProduct ctxAbort ctxCompletion ctxEditMode ctxTraverse currentCtx currentTime currentTimeCtx currentUnit curve curveAddPtCtx curveCVCtx curveEPCtx curveEditorCtx curveIntersect curveMoveEPCtx curveOnSurface curveSketchCtx cutKey cycleCheck cylinder dagPose date defaultLightListCheckBox defaultNavigation defineDataServer defineVirtualDevice deformer deg_to_rad delete deleteAttr deleteShadingGroupsAndMaterials deleteShelfTab deleteUI deleteUnusedBrushes delrandstr detachCurve detachDeviceAttr detachSurface deviceEditor devicePanel dgInfo dgdirty dgeval dgtimer dimWhen directKeyCtx directionalLight dirmap dirname disable disconnectAttr disconnectJoint diskCache displacementToPoly displayAffected displayColor displayCull displayLevelOfDetail displayPref displayRGBColor displaySmoothness displayStats displayString displaySurface distanceDimContext distanceDimension doBlur dolly dollyCtx dopeSheetEditor dot dotProduct doubleProfileBirailSurface drag dragAttrContext draggerContext dropoffLocator duplicate duplicateCurve duplicateSurface dynCache dynControl dynExport dynExpression dynGlobals dynPaintEditor dynParticleCtx dynPref dynRelEdPanel dynRelEditor dynamicLoad editAttrLimits editDisplayLayerGlobals editDisplayLayerMembers editRenderLayerAdjustment editRenderLayerGlobals editRenderLayerMembers editor editorTemplate effector emit emitter enableDevice encodeString endString endsWith env equivalent equivalentTol erf error eval evalDeferred evalEcho event exactWorldBoundingBox exclusiveLightCheckBox exec executeForEachObject exists exp expression expressionEditorListen extendCurve extendSurface extrude fcheck fclose feof fflush fgetline fgetword file fileBrowserDialog fileDialog fileExtension fileInfo filetest filletCurve filter filterCurve filterExpand filterStudioImport findAllIntersections findAnimCurves findKeyframe findMenuItem findRelatedSkinCluster finder firstParentOf fitBspline flexor floatEq floatField floatFieldGrp floatScrollBar floatSlider floatSlider2 floatSliderButtonGrp floatSliderGrp floor flow fluidCacheInfo fluidEmitter fluidVoxelInfo flushUndo fmod fontDialog fopen formLayout format fprint frameLayout fread freeFormFillet frewind fromNativePath fwrite gamma gauss geometryConstraint getApplicationVersionAsFloat getAttr getClassification getDefaultBrush getFileList getFluidAttr getInputDeviceRange getMayaPanelTypes getModifiers getPanel getParticleAttr getPluginResource getenv getpid glRender glRenderEditor globalStitch gmatch goal gotoBindPose grabColor gradientControl gradientControlNoAttr graphDollyCtx graphSelectContext graphTrackCtx gravity grid gridLayout group groupObjectsByName HfAddAttractorToAS HfAssignAS HfBuildEqualMap HfBuildFurFiles HfBuildFurImages HfCancelAFR HfConnectASToHF HfCreateAttractor HfDeleteAS HfEditAS HfPerformCreateAS HfRemoveAttractorFromAS HfSelectAttached HfSelectAttractors HfUnAssignAS hardenPointCurve hardware hardwareRenderPanel headsUpDisplay headsUpMessage help helpLine hermite hide hilite hitTest hotBox hotkey hotkeyCheck hsv_to_rgb hudButton hudSlider hudSliderButton hwReflectionMap hwRender hwRenderLoad hyperGraph hyperPanel hyperShade hypot iconTextButton iconTextCheckBox iconTextRadioButton iconTextRadioCollection iconTextScrollList iconTextStaticLabel ikHandle ikHandleCtx ikHandleDisplayScale ikSolver ikSplineHandleCtx ikSystem ikSystemInfo ikfkDisplayMethod illustratorCurves image imfPlugins inheritTransform insertJoint insertJointCtx insertKeyCtx insertKnotCurve insertKnotSurface instance instanceable instancer intField intFieldGrp intScrollBar intSlider intSliderGrp interToUI internalVar intersect iprEngine isAnimCurve isConnected isDirty isParentOf isSameObject isTrue isValidObjectName isValidString isValidUiName isolateSelect itemFilter itemFilterAttr itemFilterRender itemFilterType joint jointCluster jointCtx jointDisplayScale jointLattice keyTangent keyframe keyframeOutliner keyframeRegionCurrentTimeCtx keyframeRegionDirectKeyCtx keyframeRegionDollyCtx keyframeRegionInsertKeyCtx keyframeRegionMoveKeyCtx keyframeRegionScaleKeyCtx keyframeRegionSelectKeyCtx keyframeRegionSetKeyCtx keyframeRegionTrackCtx keyframeStats lassoContext lattice latticeDeformKeyCtx launch launchImageEditor layerButton layeredShaderPort layeredTexturePort layout layoutDialog lightList lightListEditor lightListPanel lightlink lineIntersection linearPrecision linstep listAnimatable listAttr listCameras listConnections listDeviceAttachments listHistory listInputDeviceAxes listInputDeviceButtons listInputDevices listMenuAnnotation listNodeTypes listPanelCategories listRelatives listSets listTransforms listUnselected listerEditor loadFluid loadNewShelf loadPlugin loadPluginLanguageResources loadPrefObjects localizedPanelLabel lockNode loft log longNameOf lookThru ls lsThroughFilter lsType lsUI Mayatomr mag makeIdentity makeLive makePaintable makeRoll makeSingleSurface makeTubeOn makebot manipMoveContext manipMoveLimitsCtx manipOptions manipRotateContext manipRotateLimitsCtx manipScaleContext manipScaleLimitsCtx marker match max memory menu menuBarLayout menuEditor menuItem menuItemToShelf menuSet menuSetPref messageLine min minimizeApp mirrorJoint modelCurrentTimeCtx modelEditor modelPanel mouse movIn movOut move moveIKtoFK moveKeyCtx moveVertexAlongDirection multiProfileBirailSurface mute nParticle nameCommand nameField namespace namespaceInfo newPanelItems newton nodeCast nodeIconButton nodeOutliner nodePreset nodeType noise nonLinear normalConstraint normalize nurbsBoolean nurbsCopyUVSet nurbsCube nurbsEditUV nurbsPlane nurbsSelect nurbsSquare nurbsToPoly nurbsToPolygonsPref nurbsToSubdiv nurbsToSubdivPref nurbsUVSet nurbsViewDirectionVector objExists objectCenter objectLayer objectType objectTypeUI obsoleteProc oceanNurbsPreviewPlane offsetCurve offsetCurveOnSurface offsetSurface openGLExtension openMayaPref optionMenu optionMenuGrp optionVar orbit orbitCtx orientConstraint outlinerEditor outlinerPanel overrideModifier paintEffectsDisplay pairBlend palettePort paneLayout panel panelConfiguration panelHistory paramDimContext paramDimension paramLocator parent parentConstraint particle particleExists particleInstancer particleRenderInfo partition pasteKey pathAnimation pause pclose percent performanceOptions pfxstrokes pickWalk picture pixelMove planarSrf plane play playbackOptions playblast plugAttr plugNode pluginInfo pluginResourceUtil pointConstraint pointCurveConstraint pointLight pointMatrixMult pointOnCurve pointOnSurface pointPosition poleVectorConstraint polyAppend polyAppendFacetCtx polyAppendVertex polyAutoProjection polyAverageNormal polyAverageVertex polyBevel polyBlendColor polyBlindData polyBoolOp polyBridgeEdge polyCacheMonitor polyCheck polyChipOff polyClipboard polyCloseBorder polyCollapseEdge polyCollapseFacet polyColorBlindData polyColorDel polyColorPerVertex polyColorSet polyCompare polyCone polyCopyUV polyCrease polyCreaseCtx polyCreateFacet polyCreateFacetCtx polyCube polyCut polyCutCtx polyCylinder polyCylindricalProjection polyDelEdge polyDelFacet polyDelVertex polyDuplicateAndConnect polyDuplicateEdge polyEditUV polyEditUVShell polyEvaluate polyExtrudeEdge polyExtrudeFacet polyExtrudeVertex polyFlipEdge polyFlipUV polyForceUV polyGeoSampler polyHelix polyInfo polyInstallAction polyLayoutUV polyListComponentConversion polyMapCut polyMapDel polyMapSew polyMapSewMove polyMergeEdge polyMergeEdgeCtx polyMergeFacet polyMergeFacetCtx polyMergeUV polyMergeVertex polyMirrorFace polyMoveEdge polyMoveFacet polyMoveFacetUV polyMoveUV polyMoveVertex polyNormal polyNormalPerVertex polyNormalizeUV polyOptUvs polyOptions polyOutput polyPipe polyPlanarProjection polyPlane polyPlatonicSolid polyPoke polyPrimitive polyPrism polyProjection polyPyramid polyQuad polyQueryBlindData polyReduce polySelect polySelectConstraint polySelectConstraintMonitor polySelectCtx polySelectEditCtx polySeparate polySetToFaceNormal polySewEdge polyShortestPathCtx polySmooth polySoftEdge polySphere polySphericalProjection polySplit polySplitCtx polySplitEdge polySplitRing polySplitVertex polyStraightenUVBorder polySubdivideEdge polySubdivideFacet polyToSubdiv polyTorus polyTransfer polyTriangulate polyUVSet polyUnite polyWedgeFace popen popupMenu pose pow preloadRefEd print progressBar progressWindow projFileViewer projectCurve projectTangent projectionContext projectionManip promptDialog propModCtx propMove psdChannelOutliner psdEditTextureFile psdExport psdTextureFile putenv pwd python querySubdiv quit rad_to_deg radial radioButton radioButtonGrp radioCollection radioMenuItemCollection rampColorPort rand randomizeFollicles randstate rangeControl readTake rebuildCurve rebuildSurface recordAttr recordDevice redo reference referenceEdit referenceQuery refineSubdivSelectionList refresh refreshAE registerPluginResource rehash reloadImage removeJoint removeMultiInstance removePanelCategory rename renameAttr renameSelectionList renameUI render renderGlobalsNode renderInfo renderLayerButton renderLayerParent renderLayerPostProcess renderLayerUnparent renderManip renderPartition renderQualityNode renderSettings renderThumbnailUpdate renderWindowEditor renderWindowSelectContext renderer reorder reorderDeformers requires reroot resampleFluid resetAE resetPfxToPolyCamera resetTool resolutionNode retarget reverseCurve reverseSurface revolve rgb_to_hsv rigidBody rigidSolver roll rollCtx rootOf rot rotate rotationInterpolation roundConstantRadius rowColumnLayout rowLayout runTimeCommand runup sampleImage saveAllShelves saveAttrPreset saveFluid saveImage saveInitialState saveMenu savePrefObjects savePrefs saveShelf saveToolSettings scale scaleBrushBrightness scaleComponents scaleConstraint scaleKey scaleKeyCtx sceneEditor sceneUIReplacement scmh scriptCtx scriptEditorInfo scriptJob scriptNode scriptTable scriptToShelf scriptedPanel scriptedPanelType scrollField scrollLayout sculpt searchPathArray seed selLoadSettings select selectContext selectCurveCV selectKey selectKeyCtx selectKeyframeRegionCtx selectMode selectPref selectPriority selectType selectedNodes selectionConnection separator setAttr setAttrEnumResource setAttrMapping setAttrNiceNameResource setConstraintRestPosition setDefaultShadingGroup setDrivenKeyframe setDynamic setEditCtx setEditor setFluidAttr setFocus setInfinity setInputDeviceMapping setKeyCtx setKeyPath setKeyframe setKeyframeBlendshapeTargetWts setMenuMode setNodeNiceNameResource setNodeTypeFlag setParent setParticleAttr setPfxToPolyCamera setPluginResource setProject setStampDensity setStartupMessage setState setToolTo setUITemplate setXformManip sets shadingConnection shadingGeometryRelCtx shadingLightRelCtx shadingNetworkCompare shadingNode shapeCompare shelfButton shelfLayout shelfTabLayout shellField shortNameOf showHelp showHidden showManipCtx showSelectionInTitle showShadingGroupAttrEditor showWindow sign simplify sin singleProfileBirailSurface size sizeBytes skinCluster skinPercent smoothCurve smoothTangentSurface smoothstep snap2to2 snapKey snapMode snapTogetherCtx snapshot soft softMod softModCtx sort sound soundControl source spaceLocator sphere sphrand spotLight spotLightPreviewPort spreadSheetEditor spring sqrt squareSurface srtContext stackTrace startString startsWith stitchAndExplodeShell stitchSurface stitchSurfacePoints strcmp stringArrayCatenate stringArrayContains stringArrayCount stringArrayInsertAtIndex stringArrayIntersector stringArrayRemove stringArrayRemoveAtIndex stringArrayRemoveDuplicates stringArrayRemoveExact stringArrayToString stringToStringArray strip stripPrefixFromName stroke subdAutoProjection subdCleanTopology subdCollapse subdDuplicateAndConnect subdEditUV subdListComponentConversion subdMapCut subdMapSewMove subdMatchTopology subdMirror subdToBlind subdToPoly subdTransferUVsToCache subdiv subdivCrease subdivDisplaySmoothness substitute substituteAllString substituteGeometry substring surface surfaceSampler surfaceShaderList swatchDisplayPort switchTable symbolButton symbolCheckBox sysFile system tabLayout tan tangentConstraint texLatticeDeformContext texManipContext texMoveContext texMoveUVShellContext texRotateContext texScaleContext texSelectContext texSelectShortestPathCtx texSmudgeUVContext texWinToolCtx text textCurves textField textFieldButtonGrp textFieldGrp textManip textScrollList textToShelf textureDisplacePlane textureHairColor texturePlacementContext textureWindow threadCount threePointArcCtx timeControl timePort timerX toNativePath toggle toggleAxis toggleWindowVisibility tokenize tokenizeList tolerance tolower toolButton toolCollection toolDropped toolHasOptions toolPropertyWindow torus toupper trace track trackCtx transferAttributes transformCompare transformLimits translator trim trunc truncateFluidCache truncateHairCache tumble tumbleCtx turbulence twoPointArcCtx uiRes uiTemplate unassignInputDevice undo undoInfo ungroup uniform unit unloadPlugin untangleUV untitledFileName untrim upAxis updateAE userCtx uvLink uvSnapshot validateShelfName vectorize view2dToolCtx viewCamera viewClipPlane viewFit viewHeadOn viewLookAt viewManip viewPlace viewSet visor volumeAxis vortex waitCursor warning webBrowser webBrowserPrefs whatIs window windowPref wire wireContext workspace wrinkle wrinkleContext writeTake xbmLangPathList xform",i:"",o={cN:"params",b:"\\([^\\(]",rB:!0,c:[{b:/\(/,e:/\)/,k:c,c:["self"].concat(r)}]};return{aliases:["coffee","cson","iced"],k:c,i:/\/\*/,c:r.concat([e.C("###","###"),e.HCM,{cN:"function",b:"^\\s*"+n+"\\s*=\\s*"+s,e:"[-=]>",rB:!0,c:[i,o]},{b:/[:\(,=]\s*/,r:0,c:[{cN:"function",b:s,e:"[-=]>",rB:!0,c:[o]}]},{cN:"class",bK:"class",e:"$",i:/[:="\[\]]/,c:[{bK:"extends",eW:!0,i:/[:="\[\]]/,c:[i]},i]},{cN:"attribute",b:n+":",e:":",rB:!0,rE:!0,r:0}])}});hljs.registerLanguage("tex",function(c){var e={cN:"command",b:"\\\\[a-zA-Zа-яА-я]+[\\*]?"},m={cN:"command",b:"\\\\[^a-zA-Zа-яА-я0-9]"},r={cN:"special",b:"[{}\\[\\]\\&#~]",r:0};return{c:[{b:"\\\\[a-zA-Zа-яА-я]+[\\*]? *= *-?\\d*\\.?\\d+(pt|pc|mm|cm|in|dd|cc|ex|em)?",rB:!0,c:[e,m,{cN:"number",b:" *=",e:"-?\\d*\\.?\\d+(pt|pc|mm|cm|in|dd|cc|ex|em)?",eB:!0}],r:10},e,m,r,{cN:"formula",b:"\\$\\$",e:"\\$\\$",c:[e,m,r],r:0},{cN:"formula",b:"\\$",e:"\\$",c:[e,m,r],r:0},c.C("%","$",{r:0})]}});hljs.registerLanguage("go",function(e){var t={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer",constant:"true false iota nil",typename:"bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{aliases:["golang"],k:t,i:"",sL:"vbscript"}]}});hljs.registerLanguage("haskell",function(e){var c=[e.C("--","$"),e.C("{-","-}",{c:["self"]})],a={cN:"pragma",b:"{-#",e:"#-}"},i={cN:"preprocessor",b:"^#",e:"$"},n={cN:"type",b:"\\b[A-Z][\\w']*",r:0},t={cN:"container",b:"\\(",e:"\\)",i:'"',c:[a,i,{cN:"type",b:"\\b[A-Z][\\w]*(\\((\\.\\.|,|\\w+)\\))?"},e.inherit(e.TM,{b:"[_a-z][\\w']*"})].concat(c)},l={cN:"container",b:"{",e:"}",c:t.c};return{aliases:["hs"],k:"let in if then else case of where do module import hiding qualified type data newtype deriving class instance as default infix infixl infixr foreign export ccall stdcall cplusplus jvm dotnet safe unsafe family forall mdo proc rec",c:[{cN:"module",b:"\\bmodule\\b",e:"where",k:"module where",c:[t].concat(c),i:"\\W\\.|;"},{cN:"import",b:"\\bimport\\b",e:"$",k:"import|0 qualified as hiding",c:[t].concat(c),i:"\\W\\.|;"},{cN:"class",b:"^(\\s*)?(class|instance)\\b",e:"where",k:"class family instance where",c:[n,t].concat(c)},{cN:"typedef",b:"\\b(data|(new)?type)\\b",e:"$",k:"data family type newtype deriving",c:[a,n,t,l].concat(c)},{cN:"default",bK:"default",e:"$",c:[n,t].concat(c)},{cN:"infix",bK:"infix infixl infixr",e:"$",c:[e.CNM].concat(c)},{cN:"foreign",b:"\\bforeign\\b",e:"$",k:"foreign import export ccall stdcall cplusplus jvm dotnet safe unsafe",c:[n,e.QSM].concat(c)},{cN:"shebang",b:"#!\\/usr\\/bin\\/env runhaskell",e:"$"},a,i,e.QSM,e.CNM,n,e.inherit(e.TM,{b:"^[_a-z][\\w']*"}),{b:"->|<-"}].concat(c)}});hljs.registerLanguage("scilab",function(e){var n=[e.CNM,{cN:"string",b:"'|\"",e:"'|\"",c:[e.BE,{b:"''"}]}];return{aliases:["sci"],k:{keyword:"abort break case clear catch continue do elseif else endfunction end for functionglobal if pause return resume select try then while%f %F %t %T %pi %eps %inf %nan %e %i %z %s",built_in:"abs and acos asin atan ceil cd chdir clearglobal cosh cos cumprod deff disp errorexec execstr exists exp eye gettext floor fprintf fread fsolve imag isdef isemptyisinfisnan isvector lasterror length load linspace list listfiles log10 log2 logmax min msprintf mclose mopen ones or pathconvert poly printf prod pwd rand realround sinh sin size gsort sprintf sqrt strcat strcmps tring sum system tanh tantype typename warning zeros matrix"},i:'("|#|/\\*|\\s+/\\w+)',c:[{cN:"function",bK:"function endfunction",e:"$",k:"function endfunction|10",c:[e.UTM,{cN:"params",b:"\\(",e:"\\)"}]},{cN:"transposed_variable",b:"[a-zA-Z_][a-zA-Z_0-9]*('+[\\.']*|[\\.']+)",e:"",r:0},{cN:"matrix",b:"\\[",e:"\\]'*[\\.']*",r:0,c:n},e.C("//","$")].concat(n)}});hljs.registerLanguage("profile",function(e){return{c:[e.CNM,{cN:"built_in",b:"{",e:"}$",eB:!0,eE:!0,c:[e.ASM,e.QSM],r:0},{cN:"filename",b:"[a-zA-Z_][\\da-zA-Z_]+\\.[\\da-zA-Z_]{1,3}",e:":",eE:!0},{cN:"header",b:"(ncalls|tottime|cumtime)",e:"$",k:"ncalls tottime|10 cumtime|10 filename",r:10},{cN:"summary",b:"function calls",e:"$",c:[e.CNM],r:10},e.ASM,e.QSM,{cN:"function",b:"\\(",e:"\\)$",c:[e.UTM],r:0}]}});hljs.registerLanguage("thrift",function(e){var t="bool byte i16 i32 i64 double string binary";return{k:{keyword:"namespace const typedef struct enum service exception void oneway set list map required optional",built_in:t,literal:"true false"},c:[e.QSM,e.NM,e.CLCM,e.CBCM,{cN:"class",bK:"struct enum service exception",e:/\{/,i:/\n/,c:[e.inherit(e.TM,{starts:{eW:!0,eE:!0}})]},{b:"\\b(set|list|map)\\s*<",e:">",k:t,c:["self"]}]}});hljs.registerLanguage("matlab",function(e){var a=[e.CNM,{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]}],s={r:0,c:[{cN:"operator",b:/'['\.]*/}]};return{k:{keyword:"break case catch classdef continue else elseif end enumerated events for function global if methods otherwise parfor persistent properties return spmd switch try while",built_in:"sin sind sinh asin asind asinh cos cosd cosh acos acosd acosh tan tand tanh atan atand atan2 atanh sec secd sech asec asecd asech csc cscd csch acsc acscd acsch cot cotd coth acot acotd acoth hypot exp expm1 log log1p log10 log2 pow2 realpow reallog realsqrt sqrt nthroot nextpow2 abs angle complex conj imag real unwrap isreal cplxpair fix floor ceil round mod rem sign airy besselj bessely besselh besseli besselk beta betainc betaln ellipj ellipke erf erfc erfcx erfinv expint gamma gammainc gammaln psi legendre cross dot factor isprime primes gcd lcm rat rats perms nchoosek factorial cart2sph cart2pol pol2cart sph2cart hsv2rgb rgb2hsv zeros ones eye repmat rand randn linspace logspace freqspace meshgrid accumarray size length ndims numel disp isempty isequal isequalwithequalnans cat reshape diag blkdiag tril triu fliplr flipud flipdim rot90 find sub2ind ind2sub bsxfun ndgrid permute ipermute shiftdim circshift squeeze isscalar isvector ans eps realmax realmin pi i inf nan isnan isinf isfinite j why compan gallery hadamard hankel hilb invhilb magic pascal rosser toeplitz vander wilkinson"},i:'(//|"|#|/\\*|\\s+/\\w+)',c:[{cN:"function",bK:"function",e:"$",c:[e.UTM,{cN:"params",b:"\\(",e:"\\)"},{cN:"params",b:"\\[",e:"\\]"}]},{b:/[a-zA-Z_][a-zA-Z_0-9]*'['\.]*/,rB:!0,r:0,c:[{b:/[a-zA-Z_][a-zA-Z_0-9]*/,r:0},s.c[0]]},{cN:"matrix",b:"\\[",e:"\\]",c:a,r:0,starts:s},{cN:"cell",b:"\\{",e:/}/,c:a,r:0,starts:s},{b:/\)/,r:0,starts:s},e.C("^\\s*\\%\\{\\s*$","^\\s*\\%\\}\\s*$"),e.C("\\%","$")].concat(a)}});hljs.registerLanguage("vbscript",function(e){return{aliases:["vbs"],cI:!0,k:{keyword:"call class const dim do loop erase execute executeglobal exit for each next function if then else on error option explicit new private property let get public randomize redim rem select case set stop sub while wend with end to elseif is or xor and not class_initialize class_terminate default preserve in me byval byref step resume goto",built_in:"lcase month vartype instrrev ubound setlocale getobject rgb getref string weekdayname rnd dateadd monthname now day minute isarray cbool round formatcurrency conversions csng timevalue second year space abs clng timeserial fixs len asc isempty maths dateserial atn timer isobject filter weekday datevalue ccur isdate instr datediff formatdatetime replace isnull right sgn array snumeric log cdbl hex chr lbound msgbox ucase getlocale cos cdate cbyte rtrim join hour oct typename trim strcomp int createobject loadpicture tan formatnumber mid scriptenginebuildversion scriptengine split scriptengineminorversion cint sin datepart ltrim sqr scriptenginemajorversion time derived eval date formatpercent exp inputbox left ascw chrw regexp server response request cstr err",literal:"true false null nothing empty"},i:"//",c:[e.inherit(e.QSM,{c:[{b:'""'}]}),e.C(/'/,/$/,{r:0}),e.CNM]}});hljs.registerLanguage("capnproto",function(t){return{aliases:["capnp"],k:{keyword:"struct enum interface union group import using const annotation extends in of on as with from fixed",built_in:"Void Bool Int8 Int16 Int32 Int64 UInt8 UInt16 UInt32 UInt64 Float32 Float64 Text Data AnyPointer AnyStruct Capability List",literal:"true false"},c:[t.QSM,t.NM,t.HCM,{cN:"shebang",b:/@0x[\w\d]{16};/,i:/\n/},{cN:"number",b:/@\d+\b/},{cN:"class",bK:"struct enum",e:/\{/,i:/\n/,c:[t.inherit(t.TM,{starts:{eW:!0,eE:!0}})]},{cN:"class",bK:"interface",e:/\{/,i:/\n/,c:[t.inherit(t.TM,{starts:{eW:!0,eE:!0}})]}]}});hljs.registerLanguage("xl",function(e){var t="ObjectLoader Animate MovieCredits Slides Filters Shading Materials LensFlare Mapping VLCAudioVideo StereoDecoder PointCloud NetworkAccess RemoteControl RegExp ChromaKey Snowfall NodeJS Speech Charts",o={keyword:"if then else do while until for loop import with is as where when by data constant",literal:"true false nil",type:"integer real text name boolean symbol infix prefix postfix block tree",built_in:"in mod rem and or xor not abs sign floor ceil sqrt sin cos tan asin acos atan exp expm1 log log2 log10 log1p pi at",module:t,id:"text_length text_range text_find text_replace contains page slide basic_slide title_slide title subtitle fade_in fade_out fade_at clear_color color line_color line_width texture_wrap texture_transform texture scale_?x scale_?y scale_?z? translate_?x translate_?y translate_?z? rotate_?x rotate_?y rotate_?z? rectangle circle ellipse sphere path line_to move_to quad_to curve_to theme background contents locally time mouse_?x mouse_?y mouse_buttons"},a={cN:"constant",b:"[A-Z][A-Z_0-9]+",r:0},r={cN:"variable",b:"([A-Z][a-z_0-9]+)+",r:0},i={cN:"id",b:"[a-z][a-z_0-9]+",r:0},l={cN:"string",b:'"',e:'"',i:"\\n"},n={cN:"string",b:"'",e:"'",i:"\\n"},s={cN:"string",b:"<<",e:">>"},c={cN:"number",b:"[0-9]+#[0-9A-Z_]+(\\.[0-9-A-Z_]+)?#?([Ee][+-]?[0-9]+)?",r:10},_={cN:"import",bK:"import",e:"$",k:{keyword:"import",module:t},r:0,c:[l]},d={cN:"function",b:"[a-z].*->"};return{aliases:["tao"],l:/[a-zA-Z][a-zA-Z0-9_?]*/,k:o,c:[e.CLCM,e.CBCM,l,n,s,d,_,a,r,i,c,e.NM]}});hljs.registerLanguage("scala",function(e){var t={cN:"annotation",b:"@[A-Za-z]+"},a={cN:"string",b:'u?r?"""',e:'"""',r:10},r={cN:"symbol",b:"'\\w[\\w\\d_]*(?!')"},c={cN:"type",b:"\\b[A-Z][A-Za-z0-9_]*",r:0},i={cN:"title",b:/[^0-9\n\t "'(),.`{}\[\]:;][^\n\t "'(),.`{}\[\]:;]+|[^0-9\n\t "'(),.`{}\[\]:;=]/,r:0},l={cN:"class",bK:"class object trait type",e:/[:={\[(\n;]/,c:[{cN:"keyword",bK:"extends with",r:10},i]},n={cN:"function",bK:"def val",e:/[:={\[(\n;]/,c:[i]};return{k:{literal:"true false null",keyword:"type yield lazy override def with val var sealed abstract private trait object if forSome for while throw finally protected extends import final return else break new catch super class case package default try this match continue throws implicit"},c:[e.CLCM,e.CBCM,a,e.QSM,r,c,n,l,e.CNM,t]}});hljs.registerLanguage("elixir",function(e){var n="[a-zA-Z_][a-zA-Z0-9_]*(\\!|\\?)?",r="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",b="and false then defined module in return redo retry end for true self when next until do begin unless nil break not case cond alias while ensure or include use alias fn quote",c={cN:"subst",b:"#\\{",e:"}",l:n,k:b},a={cN:"string",c:[e.BE,c],v:[{b:/'/,e:/'/},{b:/"/,e:/"/}]},i={cN:"function",bK:"def defp defmacro",e:/\B\b/,c:[e.inherit(e.TM,{b:n,endsParent:!0})]},s=e.inherit(i,{cN:"class",bK:"defmodule defrecord",e:/\bdo\b|$|;/}),l=[a,e.HCM,s,i,{cN:"constant",b:"(\\b[A-Z_]\\w*(.)?)+",r:0},{cN:"symbol",b:":",c:[a,{b:r}],r:0},{cN:"symbol",b:n+":",r:0},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{cN:"variable",b:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{b:"->"},{b:"("+e.RSR+")\\s*",c:[e.HCM,{cN:"regexp",i:"\\n",c:[e.BE,c],v:[{b:"/",e:"/[a-z]*"},{b:"%r\\[",e:"\\][a-z]*"}]}],r:0}];return c.c=l,{l:n,k:b,c:l}});hljs.registerLanguage("sml",function(e){return{aliases:["ml"],k:{keyword:"abstype and andalso as case datatype do else end eqtype exception fn fun functor handle if in include infix infixr let local nonfix of op open orelse raise rec sharing sig signature struct structure then type val with withtype where while",built_in:"array bool char exn int list option order real ref string substring vector unit word",literal:"true false NONE SOME LESS EQUAL GREATER nil"},i:/\/\/|>>/,l:"[a-z_]\\w*!?",c:[{cN:"literal",b:"\\[(\\|\\|)?\\]|\\(\\)"},e.C("\\(\\*","\\*\\)",{c:["self"]}),{cN:"symbol",b:"'[A-Za-z_](?!')[\\w']*"},{cN:"tag",b:"`[A-Z][\\w']*"},{cN:"type",b:"\\b[A-Z][\\w']*",r:0},{b:"[a-z_]\\w*'[\\w']*"},e.inherit(e.ASM,{cN:"char",r:0}),e.inherit(e.QSM,{i:null}),{cN:"number",b:"\\b(0[xX][a-fA-F0-9_]+[Lln]?|0[oO][0-7_]+[Lln]?|0[bB][01_]+[Lln]?|[0-9][0-9_]*([Lln]|(\\.[0-9_]*)?([eE][-+]?[0-9_]+)?)?)",r:0},{b:/[-=]>/}]}});hljs.registerLanguage("apache",function(e){var r={cN:"number",b:"[\\$%]\\d+"};return{aliases:["apacheconf"],cI:!0,c:[e.HCM,{cN:"tag",b:""},{cN:"keyword",b:/\w+/,r:0,k:{common:"order deny allow setenv rewriterule rewriteengine rewritecond documentroot sethandler errordocument loadmodule options header listen serverroot servername"},starts:{e:/$/,r:0,k:{literal:"on off all"},c:[{cN:"sqbracket",b:"\\s\\[",e:"\\]$"},{cN:"cbracket",b:"[\\$%]\\{",e:"\\}",c:["self",r]},r,e.QSM]}}],i:/\S/}});hljs.registerLanguage("dockerfile",function(n){return{aliases:["docker"],cI:!0,k:{built_ins:"from maintainer cmd expose add copy entrypoint volume user workdir onbuild run env"},c:[n.HCM,{k:{built_in:"run cmd entrypoint volume add copy workdir onbuild"},b:/^ *(onbuild +)?(run|cmd|entrypoint|volume|add|copy|workdir) +/,starts:{e:/[^\\]\n/,sL:"bash",subLanguageMode:"continuous"}},{k:{built_in:"from maintainer expose env user onbuild"},b:/^ *(onbuild +)?(from|maintainer|expose|env|user|onbuild) +/,e:/[^\\]\n/,c:[n.ASM,n.QSM,n.NM,n.HCM]}]}});hljs.registerLanguage("markdown",function(e){return{aliases:["md","mkdown","mkd"],c:[{cN:"header",v:[{b:"^#{1,6}",e:"$"},{b:"^.+?\\n[=-]{2,}$"}]},{b:"<",e:">",sL:"xml",r:0},{cN:"bullet",b:"^([*+-]|(\\d+\\.))\\s+"},{cN:"strong",b:"[*_]{2}.+?[*_]{2}"},{cN:"emphasis",v:[{b:"\\*.+?\\*"},{b:"_.+?_",r:0}]},{cN:"blockquote",b:"^>\\s+",e:"$"},{cN:"code",v:[{b:"`.+?`"},{b:"^( {4}| )",e:"$",r:0}]},{cN:"horizontal_rule",b:"^[-\\*]{3,}",e:"$"},{b:"\\[.+?\\][\\(\\[].*?[\\)\\]]",rB:!0,c:[{cN:"link_label",b:"\\[",e:"\\]",eB:!0,rE:!0,r:0},{cN:"link_url",b:"\\]\\(",e:"\\)",eB:!0,eE:!0},{cN:"link_reference",b:"\\]\\[",e:"\\]",eB:!0,eE:!0}],r:10},{b:"^\\[.+\\]:",rB:!0,c:[{cN:"link_reference",b:"\\[",e:"\\]:",eB:!0,eE:!0,starts:{cN:"link_url",e:"$"}}]}]}});hljs.registerLanguage("haml",function(s){return{cI:!0,c:[{cN:"doctype",b:"^!!!( (5|1\\.1|Strict|Frameset|Basic|Mobile|RDFa|XML\\b.*))?$",r:10},s.C("^\\s*(!=#|=#|-#|/).*$",!1,{r:0}),{b:"^\\s*(-|=|!=)(?!#)",starts:{e:"\\n",sL:"ruby"}},{cN:"tag",b:"^\\s*%",c:[{cN:"title",b:"\\w+"},{cN:"value",b:"[#\\.]\\w+"},{b:"{\\s*",e:"\\s*}",eE:!0,c:[{b:":\\w+\\s*=>",e:",\\s+",rB:!0,eW:!0,c:[{cN:"symbol",b:":\\w+"},{cN:"string",b:'"',e:'"'},{cN:"string",b:"'",e:"'"},{b:"\\w+",r:0}]}]},{b:"\\(\\s*",e:"\\s*\\)",eE:!0,c:[{b:"\\w+\\s*=",e:"\\s+",rB:!0,eW:!0,c:[{cN:"attribute",b:"\\w+",r:0},{cN:"string",b:'"',e:'"'},{cN:"string",b:"'",e:"'"},{b:"\\w+",r:0}]}]}]},{cN:"bullet",b:"^\\s*[=~]\\s*",r:0},{b:"#{",starts:{e:"}",sL:"ruby"}}]}});hljs.registerLanguage("fortran",function(e){var t={cN:"params",b:"\\(",e:"\\)"},n={constant:".False. .True.",type:"integer real character complex logical dimension allocatable|10 parameter external implicit|10 none double precision assign intent optional pointer target in out common equivalence data",keyword:"kind do while private call intrinsic where elsewhere type endtype endmodule endselect endinterface end enddo endif if forall endforall only contains default return stop then public subroutine|10 function program .and. .or. .not. .le. .eq. .ge. .gt. .lt. goto save else use module select case access blank direct exist file fmt form formatted iostat name named nextrec number opened rec recl sequential status unformatted unit continue format pause cycle exit c_null_char c_alert c_backspace c_form_feed flush wait decimal round iomsg synchronous nopass non_overridable pass protected volatile abstract extends import non_intrinsic value deferred generic final enumerator class associate bind enum c_int c_short c_long c_long_long c_signed_char c_size_t c_int8_t c_int16_t c_int32_t c_int64_t c_int_least8_t c_int_least16_t c_int_least32_t c_int_least64_t c_int_fast8_t c_int_fast16_t c_int_fast32_t c_int_fast64_t c_intmax_t C_intptr_t c_float c_double c_long_double c_float_complex c_double_complex c_long_double_complex c_bool c_char c_null_ptr c_null_funptr c_new_line c_carriage_return c_horizontal_tab c_vertical_tab iso_c_binding c_loc c_funloc c_associated c_f_pointer c_ptr c_funptr iso_fortran_env character_storage_size error_unit file_storage_size input_unit iostat_end iostat_eor numeric_storage_size output_unit c_f_procpointer ieee_arithmetic ieee_support_underflow_control ieee_get_underflow_mode ieee_set_underflow_mode newunit contiguous pad position action delim readwrite eor advance nml interface procedure namelist include sequence elemental pure",built_in:"alog alog10 amax0 amax1 amin0 amin1 amod cabs ccos cexp clog csin csqrt dabs dacos dasin datan datan2 dcos dcosh ddim dexp dint dlog dlog10 dmax1 dmin1 dmod dnint dsign dsin dsinh dsqrt dtan dtanh float iabs idim idint idnint ifix isign max0 max1 min0 min1 sngl algama cdabs cdcos cdexp cdlog cdsin cdsqrt cqabs cqcos cqexp cqlog cqsin cqsqrt dcmplx dconjg derf derfc dfloat dgamma dimag dlgama iqint qabs qacos qasin qatan qatan2 qcmplx qconjg qcos qcosh qdim qerf qerfc qexp qgamma qimag qlgama qlog qlog10 qmax1 qmin1 qmod qnint qsign qsin qsinh qsqrt qtan qtanh abs acos aimag aint anint asin atan atan2 char cmplx conjg cos cosh exp ichar index int log log10 max min nint sign sin sinh sqrt tan tanh print write dim lge lgt lle llt mod nullify allocate deallocate adjustl adjustr all allocated any associated bit_size btest ceiling count cshift date_and_time digits dot_product eoshift epsilon exponent floor fraction huge iand ibclr ibits ibset ieor ior ishft ishftc lbound len_trim matmul maxexponent maxloc maxval merge minexponent minloc minval modulo mvbits nearest pack present product radix random_number random_seed range repeat reshape rrspacing scale scan selected_int_kind selected_real_kind set_exponent shape size spacing spread sum system_clock tiny transpose trim ubound unpack verify achar iachar transfer dble entry dprod cpu_time command_argument_count get_command get_command_argument get_environment_variable is_iostat_end ieee_arithmetic ieee_support_underflow_control ieee_get_underflow_mode ieee_set_underflow_mode is_iostat_eor move_alloc new_line selected_char_kind same_type_as extends_type_ofacosh asinh atanh bessel_j0 bessel_j1 bessel_jn bessel_y0 bessel_y1 bessel_yn erf erfc erfc_scaled gamma log_gamma hypot norm2 atomic_define atomic_ref execute_command_line leadz trailz storage_size merge_bits bge bgt ble blt dshiftl dshiftr findloc iall iany iparity image_index lcobound ucobound maskl maskr num_images parity popcnt poppar shifta shiftl shiftr this_image"};return{cI:!0,aliases:["f90","f95"],k:n,c:[e.inherit(e.ASM,{cN:"string",r:0}),e.inherit(e.QSM,{cN:"string",r:0}),{cN:"function",bK:"subroutine function program",i:"[${=\\n]",c:[e.UTM,t]},e.C("!","$",{r:0}),{cN:"number",b:"(?=\\b|\\+|\\-|\\.)(?=\\.\\d|\\d)(?:\\d+)?(?:\\.?\\d*)(?:[de][+-]?\\d+)?\\b\\.?",r:0}]}});hljs.registerLanguage("smali",function(r){var t=["add","and","cmp","cmpg","cmpl","const","div","double","float","goto","if","int","long","move","mul","neg","new","nop","not","or","rem","return","shl","shr","sput","sub","throw","ushr","xor"],n=["aget","aput","array","check","execute","fill","filled","goto/16","goto/32","iget","instance","invoke","iput","monitor","packed","sget","sparse"],s=["transient","constructor","abstract","final","synthetic","public","private","protected","static","bridge","system"];return{aliases:["smali"],c:[{cN:"string",b:'"',e:'"',r:0},r.C("#","$",{r:0}),{cN:"keyword",b:"\\s*\\.end\\s[a-zA-Z0-9]*",r:1},{cN:"keyword",b:"^[ ]*\\.[a-zA-Z]*",r:0},{cN:"keyword",b:"\\s:[a-zA-Z_0-9]*",r:0},{cN:"keyword",b:"\\s("+s.join("|")+")",r:1},{cN:"keyword",b:"\\[",r:0},{cN:"instruction",b:"\\s("+t.join("|")+")\\s",r:1},{cN:"instruction",b:"\\s("+t.join("|")+")((\\-|/)[a-zA-Z0-9]+)+\\s",r:10},{cN:"instruction",b:"\\s("+n.join("|")+")((\\-|/)[a-zA-Z0-9]+)*\\s",r:10},{cN:"class",b:"L[^(;:\n]*;",r:0},{cN:"function",b:'( |->)[^(\n ;"]*\\(',r:0},{cN:"function",b:"\\)",r:0},{cN:"variable",b:"[vp][0-9]+",r:0}]}});hljs.registerLanguage("julia",function(r){var e={keyword:"in abstract baremodule begin bitstype break catch ccall const continue do else elseif end export finally for function global if immutable import importall let local macro module quote return try type typealias using while",literal:"true false ANY ARGS CPU_CORES C_NULL DL_LOAD_PATH DevNull ENDIAN_BOM ENV I|0 Inf Inf16 Inf32 InsertionSort JULIA_HOME LOAD_PATH MS_ASYNC MS_INVALIDATE MS_SYNC MergeSort NaN NaN16 NaN32 OS_NAME QuickSort RTLD_DEEPBIND RTLD_FIRST RTLD_GLOBAL RTLD_LAZY RTLD_LOCAL RTLD_NODELETE RTLD_NOLOAD RTLD_NOW RoundDown RoundFromZero RoundNearest RoundToZero RoundUp STDERR STDIN STDOUT VERSION WORD_SIZE catalan cglobal e eu eulergamma golden im nothing pi γ π φ",built_in:"ASCIIString AbstractArray AbstractRNG AbstractSparseArray Any ArgumentError Array Associative Base64Pipe Bidiagonal BigFloat BigInt BitArray BitMatrix BitVector Bool BoundsError Box CFILE Cchar Cdouble Cfloat Char CharString Cint Clong Clonglong ClusterManager Cmd Coff_t Colon Complex Complex128 Complex32 Complex64 Condition Cptrdiff_t Cshort Csize_t Cssize_t Cuchar Cuint Culong Culonglong Cushort Cwchar_t DArray DataType DenseArray Diagonal Dict DimensionMismatch DirectIndexString Display DivideError DomainError EOFError EachLine Enumerate ErrorException Exception Expr Factorization FileMonitor FileOffset Filter Float16 Float32 Float64 FloatRange FloatingPoint Function GetfieldNode GotoNode Hermitian IO IOBuffer IOStream IPv4 IPv6 InexactError Int Int128 Int16 Int32 Int64 Int8 IntSet Integer InterruptException IntrinsicFunction KeyError LabelNode LambdaStaticData LineNumberNode LoadError LocalProcess MIME MathConst MemoryError MersenneTwister Method MethodError MethodTable Module NTuple NewvarNode Nothing Number ObjectIdDict OrdinalRange OverflowError ParseError PollingFileWatcher ProcessExitedException ProcessGroup Ptr QuoteNode Range Range1 Ranges Rational RawFD Real Regex RegexMatch RemoteRef RepString RevString RopeString RoundingMode Set SharedArray Signed SparseMatrixCSC StackOverflowError Stat StatStruct StepRange String SubArray SubString SymTridiagonal Symbol SymbolNode Symmetric SystemError Task TextDisplay Timer TmStruct TopNode Triangular Tridiagonal Type TypeConstructor TypeError TypeName TypeVar UTF16String UTF32String UTF8String UdpSocket Uint Uint128 Uint16 Uint32 Uint64 Uint8 UndefRefError UndefVarError UniformScaling UnionType UnitRange Unsigned Vararg VersionNumber WString WeakKeyDict WeakRef Woodbury Zip"},t="[A-Za-z_\\u00A1-\\uFFFF][A-Za-z_0-9\\u00A1-\\uFFFF]*",o={l:t,k:e},n={cN:"type-annotation",b:/::/},a={cN:"subtype",b:/<:/},i={cN:"number",b:/(\b0x[\d_]*(\.[\d_]*)?|0x\.\d[\d_]*)p[-+]?\d+|\b0[box][a-fA-F0-9][a-fA-F0-9_]*|(\b\d[\d_]*(\.[\d_]*)?|\.\d[\d_]*)([eEfF][-+]?\d+)?/,r:0},l={cN:"char",b:/'(.|\\[xXuU][a-zA-Z0-9]+)'/},c={cN:"subst",b:/\$\(/,e:/\)/,k:e},u={cN:"variable",b:"\\$"+t},d={cN:"string",c:[r.BE,c,u],v:[{b:/\w*"/,e:/"\w*/},{b:/\w*"""/,e:/"""\w*/}]},g={cN:"string",c:[r.BE,c,u],b:"`",e:"`"},s={cN:"macrocall",b:"@"+t},S={cN:"comment",v:[{b:"#=",e:"=#",r:10},{b:"#",e:"$"}]};return o.c=[i,l,n,a,d,g,s,S,r.HCM],c.c=o.c,o});hljs.registerLanguage("delphi",function(e){var r="exports register file shl array record property for mod while set ally label uses raise not stored class safecall var interface or private static exit index inherited to else stdcall override shr asm far resourcestring finalization packed virtual out and protected library do xorwrite goto near function end div overload object unit begin string on inline repeat until destructor write message program with read initialization except default nil if case cdecl in downto threadvar of try pascal const external constructor type public then implementation finally published procedure",t=[e.CLCM,e.C(/\{/,/\}/,{r:0}),e.C(/\(\*/,/\*\)/,{r:10})],i={cN:"string",b:/'/,e:/'/,c:[{b:/''/}]},c={cN:"string",b:/(#\d+)+/},o={b:e.IR+"\\s*=\\s*class\\s*\\(",rB:!0,c:[e.TM]},n={cN:"function",bK:"function constructor destructor procedure",e:/[:;]/,k:"function constructor|10 destructor|10 procedure|10",c:[e.TM,{cN:"params",b:/\(/,e:/\)/,k:r,c:[i,c]}].concat(t)};return{cI:!0,k:r,i:/"|\$[G-Zg-z]|\/\*|<\/|\|/,c:[i,c,e.NM,o,n].concat(t)}});hljs.registerLanguage("brainfuck",function(r){var n={cN:"literal",b:"[\\+\\-]",r:0};return{aliases:["bf"],c:[r.C("[^\\[\\]\\.,\\+\\-<> \r\n]","[\\[\\]\\.,\\+\\-<> \r\n]",{rE:!0,r:0}),{cN:"title",b:"[\\[\\]]",r:0},{cN:"string",b:"[\\.,]",r:0},{b:/\+\+|\-\-/,rB:!0,c:[n]},n]}});hljs.registerLanguage("ini",function(e){return{cI:!0,i:/\S/,c:[e.C(";","$"),{cN:"title",b:"^\\[",e:"\\]"},{cN:"setting",b:"^[a-z0-9\\[\\]_-]+[ \\t]*=[ \\t]*",e:"$",c:[{cN:"value",eW:!0,k:"on off true false yes no",c:[e.QSM,e.NM],r:0}]}]}});hljs.registerLanguage("json",function(e){var t={literal:"true false null"},i=[e.QSM,e.CNM],l={cN:"value",e:",",eW:!0,eE:!0,c:i,k:t},c={b:"{",e:"}",c:[{cN:"attribute",b:'\\s*"',e:'"\\s*:\\s*',eB:!0,eE:!0,c:[e.BE],i:"\\n",starts:l}],i:"\\S"},n={b:"\\[",e:"\\]",c:[e.inherit(l,{cN:null})],i:"\\S"};return i.splice(i.length,0,c,n),{c:i,k:t,i:"\\S"}});hljs.registerLanguage("powershell",function(e){var t={b:"`[\\s\\S]",r:0},r={cN:"variable",v:[{b:/\$[\w\d][\w\d_:]*/}]},o={cN:"string",b:/"/,e:/"/,c:[t,r,{cN:"variable",b:/\$[A-z]/,e:/[^A-z]/}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["ps"],l:/-?[A-z\.\-]+/,cI:!0,k:{keyword:"if else foreach return function do while until elseif begin for trap data dynamicparam end break throw param continue finally in switch exit filter try process catch",literal:"$null $true $false",built_in:"Add-Content Add-History Add-Member Add-PSSnapin Clear-Content Clear-Item Clear-Item Property Clear-Variable Compare-Object ConvertFrom-SecureString Convert-Path ConvertTo-Html ConvertTo-SecureString Copy-Item Copy-ItemProperty Export-Alias Export-Clixml Export-Console Export-Csv ForEach-Object Format-Custom Format-List Format-Table Format-Wide Get-Acl Get-Alias Get-AuthenticodeSignature Get-ChildItem Get-Command Get-Content Get-Credential Get-Culture Get-Date Get-EventLog Get-ExecutionPolicy Get-Help Get-History Get-Host Get-Item Get-ItemProperty Get-Location Get-Member Get-PfxCertificate Get-Process Get-PSDrive Get-PSProvider Get-PSSnapin Get-Service Get-TraceSource Get-UICulture Get-Unique Get-Variable Get-WmiObject Group-Object Import-Alias Import-Clixml Import-Csv Invoke-Expression Invoke-History Invoke-Item Join-Path Measure-Command Measure-Object Move-Item Move-ItemProperty New-Alias New-Item New-ItemProperty New-Object New-PSDrive New-Service New-TimeSpan New-Variable Out-Default Out-File Out-Host Out-Null Out-Printer Out-String Pop-Location Push-Location Read-Host Remove-Item Remove-ItemProperty Remove-PSDrive Remove-PSSnapin Remove-Variable Rename-Item Rename-ItemProperty Resolve-Path Restart-Service Resume-Service Select-Object Select-String Set-Acl Set-Alias Set-AuthenticodeSignature Set-Content Set-Date Set-ExecutionPolicy Set-Item Set-ItemProperty Set-Location Set-PSDebug Set-Service Set-TraceSource Set-Variable Sort-Object Split-Path Start-Service Start-Sleep Start-Transcript Stop-Process Stop-Service Stop-Transcript Suspend-Service Tee-Object Test-Path Trace-Command Update-FormatData Update-TypeData Where-Object Write-Debug Write-Error Write-Host Write-Output Write-Progress Write-Verbose Write-Warning",operator:"-ne -eq -lt -gt -ge -le -not -like -notlike -match -notmatch -contains -notcontains -in -notin -replace"},c:[e.HCM,e.NM,o,a,r]}});hljs.registerLanguage("gradle",function(e){return{cI:!0,k:{keyword:"task project allprojects subprojects artifacts buildscript configurations dependencies repositories sourceSets description delete from into include exclude source classpath destinationDir includes options sourceCompatibility targetCompatibility group flatDir doLast doFirst flatten todir fromdir ant def abstract break case catch continue default do else extends final finally for if implements instanceof native new private protected public return static switch synchronized throw throws transient try volatile while strictfp package import false null super this true antlrtask checkstyle codenarc copy boolean byte char class double float int interface long short void compile runTime file fileTree abs any append asList asWritable call collect compareTo count div dump each eachByte eachFile eachLine every find findAll flatten getAt getErr getIn getOut getText grep immutable inject inspect intersect invokeMethods isCase join leftShift minus multiply newInputStream newOutputStream newPrintWriter newReader newWriter next plus pop power previous print println push putAt read readBytes readLines reverse reverseEach round size sort splitEachLine step subMap times toInteger toList tokenize upto waitForOrKill withPrintWriter withReader withStream withWriter withWriterAppend write writeLine"},c:[e.CLCM,e.CBCM,e.ASM,e.QSM,e.NM,e.RM]}});hljs.registerLanguage("erb",function(e){return{sL:"xml",subLanguageMode:"continuous",c:[e.C("<%#","%>"),{b:"<%[%=-]?",e:"[%-]?%>",sL:"ruby",eB:!0,eE:!0}]}});hljs.registerLanguage("swift",function(e){var i={keyword:"class deinit enum extension func import init let protocol static struct subscript typealias var break case continue default do else fallthrough if in for return switch where while as dynamicType is new super self Self Type __COLUMN__ __FILE__ __FUNCTION__ __LINE__ associativity didSet get infix inout left mutating none nonmutating operator override postfix precedence prefix right set unowned unowned safe unsafe weak willSet",literal:"true false nil",built_in:"abs advance alignof alignofValue assert bridgeFromObjectiveC bridgeFromObjectiveCUnconditional bridgeToObjectiveC bridgeToObjectiveCUnconditional c contains count countElements countLeadingZeros debugPrint debugPrintln distance dropFirst dropLast dump encodeBitsAsWords enumerate equal false filter find getBridgedObjectiveCType getVaList indices insertionSort isBridgedToObjectiveC isBridgedVerbatimToObjectiveC isUniquelyReferenced join lexicographicalCompare map max maxElement min minElement nil numericCast partition posix print println quickSort reduce reflect reinterpretCast reverse roundUpToAlignment sizeof sizeofValue sort split startsWith strideof strideofValue swap swift toString transcode true underestimateCount unsafeReflect withExtendedLifetime withObjectAtPlusZero withUnsafePointer withUnsafePointerToObject withUnsafePointers withVaList"},t={cN:"type",b:"\\b[A-Z][\\w']*",r:0},n=e.C("/\\*","\\*/",{c:["self"]}),r={cN:"subst",b:/\\\(/,e:"\\)",k:i,c:[]},s={cN:"number",b:"\\b([\\d_]+(\\.[\\deE_]+)?|0x[a-fA-F0-9_]+(\\.[a-fA-F0-9p_]+)?|0b[01_]+|0o[0-7_]+)\\b",r:0},o=e.inherit(e.QSM,{c:[r,e.BE]});return r.c=[s],{k:i,c:[o,e.CLCM,n,t,s,{cN:"func",bK:"func",e:"{",eE:!0,c:[e.inherit(e.TM,{b:/[A-Za-z$_][0-9A-Za-z$_]*/,i:/\(/}),{cN:"generics",b://,i:/>/},{cN:"params",b:/\(/,e:/\)/,endsParent:!0,k:i,c:["self",s,o,e.CBCM,{b:":"}],i:/["']/}],i:/\[|%/},{cN:"class",bK:"struct protocol class extension enum",k:i,e:"\\{",eE:!0,c:[e.inherit(e.TM,{b:/[A-Za-z$_][0-9A-Za-z$_]*/})]},{cN:"preprocessor",b:"(@assignment|@class_protocol|@exported|@final|@lazy|@noreturn|@NSCopying|@NSManaged|@objc|@optional|@required|@auto_closure|@noreturn|@IBAction|@IBDesignable|@IBInspectable|@IBOutlet|@infix|@prefix|@postfix)"}]}});hljs.registerLanguage("lisp",function(b){var e="[a-zA-Z_\\-\\+\\*\\/\\<\\=\\>\\&\\#][a-zA-Z0-9_\\-\\+\\*\\/\\<\\=\\>\\&\\#!]*",c="\\|[^]*?\\|",r="(\\-|\\+)?\\d+(\\.\\d+|\\/\\d+)?((d|e|f|l|s|D|E|F|L|S)(\\+|\\-)?\\d+)?",a={cN:"shebang",b:"^#!",e:"$"},i={cN:"literal",b:"\\b(t{1}|nil)\\b"},l={cN:"number",v:[{b:r,r:0},{b:"#(b|B)[0-1]+(/[0-1]+)?"},{b:"#(o|O)[0-7]+(/[0-7]+)?"},{b:"#(x|X)[0-9a-fA-F]+(/[0-9a-fA-F]+)?"},{b:"#(c|C)\\("+r+" +"+r,e:"\\)"}]},t=b.inherit(b.QSM,{i:null}),d=b.C(";","$",{r:0}),n={cN:"variable",b:"\\*",e:"\\*"},u={cN:"keyword",b:"[:&]"+e},N={b:e,r:0},o={b:c},s={b:"\\(",e:"\\)",c:["self",i,t,l,N]},v={cN:"quoted",c:[l,t,n,u,s,N],v:[{b:"['`]\\(",e:"\\)"},{b:"\\(quote ",e:"\\)",k:"quote"},{b:"'"+c}]},f={cN:"quoted",v:[{b:"'"+e},{b:"#'"+e+"(::"+e+")*"}]},g={cN:"list",b:"\\(\\s*",e:"\\)"},q={eW:!0,r:0};return g.c=[{cN:"keyword",v:[{b:e},{b:c}]},q],q.c=[v,f,g,i,l,t,d,n,u,o,N],{i:/\S/,c:[l,a,i,t,d,v,f,g,N]}});hljs.registerLanguage("rsl",function(e){return{k:{keyword:"float color point normal vector matrix while for if do return else break extern continue",built_in:"abs acos ambient area asin atan atmosphere attribute calculatenormal ceil cellnoise clamp comp concat cos degrees depth Deriv diffuse distance Du Dv environment exp faceforward filterstep floor format fresnel incident length lightsource log match max min mod noise normalize ntransform opposite option phong pnoise pow printf ptlined radians random reflect refract renderinfo round setcomp setxcomp setycomp setzcomp shadow sign sin smoothstep specular specularbrdf spline sqrt step tan texture textureinfo trace transform vtransform xcomp ycomp zcomp"},i:" > >= ` abs acos angle append apply asin assoc assq assv atan boolean? caar cadr call-with-input-file call-with-output-file call-with-values car cdddar cddddr cdr ceiling char->integer char-alphabetic? char-ci<=? char-ci=? char-ci>? char-downcase char-lower-case? char-numeric? char-ready? char-upcase char-upper-case? char-whitespace? char<=? char=? char>? char? close-input-port close-output-port complex? cons cos current-input-port current-output-port denominator display eof-object? eq? equal? eqv? eval even? exact->inexact exact? exp expt floor force gcd imag-part inexact->exact inexact? input-port? integer->char integer? interaction-environment lcm length list list->string list->vector list-ref list-tail list? load log magnitude make-polar make-rectangular make-string make-vector max member memq memv min modulo negative? newline not null-environment null? number->string number? numerator odd? open-input-file open-output-file output-port? pair? peek-char port? positive? procedure? quasiquote quote quotient rational? rationalize read read-char real-part real? remainder reverse round scheme-report-environment set! set-car! set-cdr! sin sqrt string string->list string->number string->symbol string-append string-ci<=? string-ci=? string-ci>? string-copy string-fill! string-length string-ref string-set! string<=? string=? string>? string? substring symbol->string symbol? tan transcript-off transcript-on truncate values vector vector->list vector-fill! vector-length vector-ref vector-set! with-input-from-file with-output-to-file write write-char zero?"},n={cN:"shebang",b:"^#!",e:"$"},c={cN:"literal",b:"(#t|#f|#\\\\"+t+"|#\\\\.)"},l={cN:"number",v:[{b:r,r:0},{b:i,r:0},{b:"#b[0-1]+(/[0-1]+)?"},{b:"#o[0-7]+(/[0-7]+)?"},{b:"#x[0-9a-f]+(/[0-9a-f]+)?"}]},s=e.QSM,o=[e.C(";","$",{r:0}),e.C("#\\|","\\|#")],u={b:t,r:0},p={cN:"variable",b:"'"+t},d={eW:!0,r:0},g={cN:"list",v:[{b:"\\(",e:"\\)"},{b:"\\[",e:"\\]"}],c:[{cN:"keyword",b:t,l:t,k:a},d]};return d.c=[c,l,s,u,p,g].concat(o),{i:/\S/,c:[n,l,s,p,g].concat(o)}});hljs.registerLanguage("stata",function(e){return{aliases:["do","ado"],cI:!0,k:"if else in foreach for forv forva forval forvalu forvalue forvalues by bys bysort xi quietly qui capture about ac ac_7 acprplot acprplot_7 adjust ado adopath adoupdate alpha ameans an ano anov anova anova_estat anova_terms anovadef aorder ap app appe appen append arch arch_dr arch_estat arch_p archlm areg areg_p args arima arima_dr arima_estat arima_p as asmprobit asmprobit_estat asmprobit_lf asmprobit_mfx__dlg asmprobit_p ass asse asser assert avplot avplot_7 avplots avplots_7 bcskew0 bgodfrey binreg bip0_lf biplot bipp_lf bipr_lf bipr_p biprobit bitest bitesti bitowt blogit bmemsize boot bootsamp bootstrap bootstrap_8 boxco_l boxco_p boxcox boxcox_6 boxcox_p bprobit br break brier bro brow brows browse brr brrstat bs bs_7 bsampl_w bsample bsample_7 bsqreg bstat bstat_7 bstat_8 bstrap bstrap_7 ca ca_estat ca_p cabiplot camat canon canon_8 canon_8_p canon_estat canon_p cap caprojection capt captu captur capture cat cc cchart cchart_7 cci cd censobs_table centile cf char chdir checkdlgfiles checkestimationsample checkhlpfiles checksum chelp ci cii cl class classutil clear cli clis clist clo clog clog_lf clog_p clogi clogi_sw clogit clogit_lf clogit_p clogitp clogl_sw cloglog clonevar clslistarray cluster cluster_measures cluster_stop cluster_tree cluster_tree_8 clustermat cmdlog cnr cnre cnreg cnreg_p cnreg_sw cnsreg codebook collaps4 collapse colormult_nb colormult_nw compare compress conf confi confir confirm conren cons const constr constra constrai constrain constraint continue contract copy copyright copysource cor corc corr corr2data corr_anti corr_kmo corr_smc corre correl correla correlat correlate corrgram cou coun count cox cox_p cox_sw coxbase coxhaz coxvar cprplot cprplot_7 crc cret cretu cretur creturn cross cs cscript cscript_log csi ct ct_is ctset ctst_5 ctst_st cttost cumsp cumsp_7 cumul cusum cusum_7 cutil d datasig datasign datasigna datasignat datasignatu datasignatur datasignature datetof db dbeta de dec deco decod decode deff des desc descr descri describ describe destring dfbeta dfgls dfuller di di_g dir dirstats dis discard disp disp_res disp_s displ displa display distinct do doe doed doedi doedit dotplot dotplot_7 dprobit drawnorm drop ds ds_util dstdize duplicates durbina dwstat dydx e ed edi edit egen eivreg emdef en enc enco encod encode eq erase ereg ereg_lf ereg_p ereg_sw ereghet ereghet_glf ereghet_glf_sh ereghet_gp ereghet_ilf ereghet_ilf_sh ereghet_ip eret eretu eretur ereturn err erro error est est_cfexist est_cfname est_clickable est_expand est_hold est_table est_unhold est_unholdok estat estat_default estat_summ estat_vce_only esti estimates etodow etof etomdy ex exi exit expand expandcl fac fact facto factor factor_estat factor_p factor_pca_rotated factor_rotate factormat fcast fcast_compute fcast_graph fdades fdadesc fdadescr fdadescri fdadescrib fdadescribe fdasav fdasave fdause fh_st file open file read file close file filefilter fillin find_hlp_file findfile findit findit_7 fit fl fli flis flist for5_0 form forma format fpredict frac_154 frac_adj frac_chk frac_cox frac_ddp frac_dis frac_dv frac_in frac_mun frac_pp frac_pq frac_pv frac_wgt frac_xo fracgen fracplot fracplot_7 fracpoly fracpred fron_ex fron_hn fron_p fron_tn fron_tn2 frontier ftodate ftoe ftomdy ftowdate g gamhet_glf gamhet_gp gamhet_ilf gamhet_ip gamma gamma_d2 gamma_p gamma_sw gammahet gdi_hexagon gdi_spokes ge gen gene gener genera generat generate genrank genstd genvmean gettoken gl gladder gladder_7 glim_l01 glim_l02 glim_l03 glim_l04 glim_l05 glim_l06 glim_l07 glim_l08 glim_l09 glim_l10 glim_l11 glim_l12 glim_lf glim_mu glim_nw1 glim_nw2 glim_nw3 glim_p glim_v1 glim_v2 glim_v3 glim_v4 glim_v5 glim_v6 glim_v7 glm glm_6 glm_p glm_sw glmpred glo glob globa global glogit glogit_8 glogit_p gmeans gnbre_lf gnbreg gnbreg_5 gnbreg_p gomp_lf gompe_sw gomper_p gompertz gompertzhet gomphet_glf gomphet_glf_sh gomphet_gp gomphet_ilf gomphet_ilf_sh gomphet_ip gphdot gphpen gphprint gprefs gprobi_p gprobit gprobit_8 gr gr7 gr_copy gr_current gr_db gr_describe gr_dir gr_draw gr_draw_replay gr_drop gr_edit gr_editviewopts gr_example gr_example2 gr_export gr_print gr_qscheme gr_query gr_read gr_rename gr_replay gr_save gr_set gr_setscheme gr_table gr_undo gr_use graph graph7 grebar greigen greigen_7 greigen_8 grmeanby grmeanby_7 gs_fileinfo gs_filetype gs_graphinfo gs_stat gsort gwood h hadimvo hareg hausman haver he heck_d2 heckma_p heckman heckp_lf heckpr_p heckprob hel help hereg hetpr_lf hetpr_p hetprob hettest hexdump hilite hist hist_7 histogram hlogit hlu hmeans hotel hotelling hprobit hreg hsearch icd9 icd9_ff icd9p iis impute imtest inbase include inf infi infil infile infix inp inpu input ins insheet insp inspe inspec inspect integ inten intreg intreg_7 intreg_p intrg2_ll intrg_ll intrg_ll2 ipolate iqreg ir irf irf_create irfm iri is_svy is_svysum isid istdize ivprob_1_lf ivprob_lf ivprobit ivprobit_p ivreg ivreg_footnote ivtob_1_lf ivtob_lf ivtobit ivtobit_p jackknife jacknife jknife jknife_6 jknife_8 jkstat joinby kalarma1 kap kap_3 kapmeier kappa kapwgt kdensity kdensity_7 keep ksm ksmirnov ktau kwallis l la lab labe label labelbook ladder levels levelsof leverage lfit lfit_p li lincom line linktest lis list lloghet_glf lloghet_glf_sh lloghet_gp lloghet_ilf lloghet_ilf_sh lloghet_ip llogi_sw llogis_p llogist llogistic llogistichet lnorm_lf lnorm_sw lnorma_p lnormal lnormalhet lnormhet_glf lnormhet_glf_sh lnormhet_gp lnormhet_ilf lnormhet_ilf_sh lnormhet_ip lnskew0 loadingplot loc loca local log logi logis_lf logistic logistic_p logit logit_estat logit_p loglogs logrank loneway lookfor lookup lowess lowess_7 lpredict lrecomp lroc lroc_7 lrtest ls lsens lsens_7 lsens_x lstat ltable ltable_7 ltriang lv lvr2plot lvr2plot_7 m ma mac macr macro makecns man manova manova_estat manova_p manovatest mantel mark markin markout marksample mat mat_capp mat_order mat_put_rr mat_rapp mata mata_clear mata_describe mata_drop mata_matdescribe mata_matsave mata_matuse mata_memory mata_mlib mata_mosave mata_rename mata_which matalabel matcproc matlist matname matr matri matrix matrix_input__dlg matstrik mcc mcci md0_ md1_ md1debug_ md2_ md2debug_ mds mds_estat mds_p mdsconfig mdslong mdsmat mdsshepard mdytoe mdytof me_derd mean means median memory memsize meqparse mer merg merge mfp mfx mhelp mhodds minbound mixed_ll mixed_ll_reparm mkassert mkdir mkmat mkspline ml ml_5 ml_adjs ml_bhhhs ml_c_d ml_check ml_clear ml_cnt ml_debug ml_defd ml_e0 ml_e0_bfgs ml_e0_cycle ml_e0_dfp ml_e0i ml_e1 ml_e1_bfgs ml_e1_bhhh ml_e1_cycle ml_e1_dfp ml_e2 ml_e2_cycle ml_ebfg0 ml_ebfr0 ml_ebfr1 ml_ebh0q ml_ebhh0 ml_ebhr0 ml_ebr0i ml_ecr0i ml_edfp0 ml_edfr0 ml_edfr1 ml_edr0i ml_eds ml_eer0i ml_egr0i ml_elf ml_elf_bfgs ml_elf_bhhh ml_elf_cycle ml_elf_dfp ml_elfi ml_elfs ml_enr0i ml_enrr0 ml_erdu0 ml_erdu0_bfgs ml_erdu0_bhhh ml_erdu0_bhhhq ml_erdu0_cycle ml_erdu0_dfp ml_erdu0_nrbfgs ml_exde ml_footnote ml_geqnr ml_grad0 ml_graph ml_hbhhh ml_hd0 ml_hold ml_init ml_inv ml_log ml_max ml_mlout ml_mlout_8 ml_model ml_nb0 ml_opt ml_p ml_plot ml_query ml_rdgrd ml_repor ml_s_e ml_score ml_searc ml_technique ml_unhold mleval mlf_ mlmatbysum mlmatsum mlog mlogi mlogit mlogit_footnote mlogit_p mlopts mlsum mlvecsum mnl0_ mor more mov move mprobit mprobit_lf mprobit_p mrdu0_ mrdu1_ mvdecode mvencode mvreg mvreg_estat n nbreg nbreg_al nbreg_lf nbreg_p nbreg_sw nestreg net newey newey_7 newey_p news nl nl_7 nl_9 nl_9_p nl_p nl_p_7 nlcom nlcom_p nlexp2 nlexp2_7 nlexp2a nlexp2a_7 nlexp3 nlexp3_7 nlgom3 nlgom3_7 nlgom4 nlgom4_7 nlinit nllog3 nllog3_7 nllog4 nllog4_7 nlog_rd nlogit nlogit_p nlogitgen nlogittree nlpred no nobreak noi nois noisi noisil noisily note notes notes_dlg nptrend numlabel numlist odbc old_ver olo olog ologi ologi_sw ologit ologit_p ologitp on one onew onewa oneway op_colnm op_comp op_diff op_inv op_str opr opro oprob oprob_sw oprobi oprobi_p oprobit oprobitp opts_exclusive order orthog orthpoly ou out outf outfi outfil outfile outs outsh outshe outshee outsheet ovtest pac pac_7 palette parse parse_dissim pause pca pca_8 pca_display pca_estat pca_p pca_rotate pcamat pchart pchart_7 pchi pchi_7 pcorr pctile pentium pergram pergram_7 permute permute_8 personal peto_st pkcollapse pkcross pkequiv pkexamine pkexamine_7 pkshape pksumm pksumm_7 pl plo plot plugin pnorm pnorm_7 poisgof poiss_lf poiss_sw poisso_p poisson poisson_estat post postclose postfile postutil pperron pr prais prais_e prais_e2 prais_p predict predictnl preserve print pro prob probi probit probit_estat probit_p proc_time procoverlay procrustes procrustes_estat procrustes_p profiler prog progr progra program prop proportion prtest prtesti pwcorr pwd q\\s qby qbys qchi qchi_7 qladder qladder_7 qnorm qnorm_7 qqplot qqplot_7 qreg qreg_c qreg_p qreg_sw qu quadchk quantile quantile_7 que quer query range ranksum ratio rchart rchart_7 rcof recast reclink recode reg reg3 reg3_p regdw regr regre regre_p2 regres regres_p regress regress_estat regriv_p remap ren rena renam rename renpfix repeat replace report reshape restore ret retu retur return rm rmdir robvar roccomp roccomp_7 roccomp_8 rocf_lf rocfit rocfit_8 rocgold rocplot rocplot_7 roctab roctab_7 rolling rologit rologit_p rot rota rotat rotate rotatemat rreg rreg_p ru run runtest rvfplot rvfplot_7 rvpplot rvpplot_7 sa safesum sample sampsi sav save savedresults saveold sc sca scal scala scalar scatter scm_mine sco scob_lf scob_p scobi_sw scobit scor score scoreplot scoreplot_help scree screeplot screeplot_help sdtest sdtesti se search separate seperate serrbar serrbar_7 serset set set_defaults sfrancia sh she shel shell shewhart shewhart_7 signestimationsample signrank signtest simul simul_7 simulate simulate_8 sktest sleep slogit slogit_d2 slogit_p smooth snapspan so sor sort spearman spikeplot spikeplot_7 spikeplt spline_x split sqreg sqreg_p sret sretu sretur sreturn ssc st st_ct st_hc st_hcd st_hcd_sh st_is st_issys st_note st_promo st_set st_show st_smpl st_subid stack statsby statsby_8 stbase stci stci_7 stcox stcox_estat stcox_fr stcox_fr_ll stcox_p stcox_sw stcoxkm stcoxkm_7 stcstat stcurv stcurve stcurve_7 stdes stem stepwise stereg stfill stgen stir stjoin stmc stmh stphplot stphplot_7 stphtest stphtest_7 stptime strate strate_7 streg streg_sw streset sts sts_7 stset stsplit stsum sttocc sttoct stvary stweib su suest suest_8 sum summ summa summar summari summariz summarize sunflower sureg survcurv survsum svar svar_p svmat svy svy_disp svy_dreg svy_est svy_est_7 svy_estat svy_get svy_gnbreg_p svy_head svy_header svy_heckman_p svy_heckprob_p svy_intreg_p svy_ivreg_p svy_logistic_p svy_logit_p svy_mlogit_p svy_nbreg_p svy_ologit_p svy_oprobit_p svy_poisson_p svy_probit_p svy_regress_p svy_sub svy_sub_7 svy_x svy_x_7 svy_x_p svydes svydes_8 svygen svygnbreg svyheckman svyheckprob svyintreg svyintreg_7 svyintrg svyivreg svylc svylog_p svylogit svymarkout svymarkout_8 svymean svymlog svymlogit svynbreg svyolog svyologit svyoprob svyoprobit svyopts svypois svypois_7 svypoisson svyprobit svyprobt svyprop svyprop_7 svyratio svyreg svyreg_p svyregress svyset svyset_7 svyset_8 svytab svytab_7 svytest svytotal sw sw_8 swcnreg swcox swereg swilk swlogis swlogit swologit swoprbt swpois swprobit swqreg swtobit swweib symmetry symmi symplot symplot_7 syntax sysdescribe sysdir sysuse szroeter ta tab tab1 tab2 tab_or tabd tabdi tabdis tabdisp tabi table tabodds tabodds_7 tabstat tabu tabul tabula tabulat tabulate te tempfile tempname tempvar tes test testnl testparm teststd tetrachoric time_it timer tis tob tobi tobit tobit_p tobit_sw token tokeni tokeniz tokenize tostring total translate translator transmap treat_ll treatr_p treatreg trim trnb_cons trnb_mean trpoiss_d2 trunc_ll truncr_p truncreg tsappend tset tsfill tsline tsline_ex tsreport tsrevar tsrline tsset tssmooth tsunab ttest ttesti tut_chk tut_wait tutorial tw tware_st two twoway twoway__fpfit_serset twoway__function_gen twoway__histogram_gen twoway__ipoint_serset twoway__ipoints_serset twoway__kdensity_gen twoway__lfit_serset twoway__normgen_gen twoway__pci_serset twoway__qfit_serset twoway__scatteri_serset twoway__sunflower_gen twoway_ksm_serset ty typ type typeof u unab unabbrev unabcmd update us use uselabel var var_mkcompanion var_p varbasic varfcast vargranger varirf varirf_add varirf_cgraph varirf_create varirf_ctable varirf_describe varirf_dir varirf_drop varirf_erase varirf_graph varirf_ograph varirf_rename varirf_set varirf_table varlist varlmar varnorm varsoc varstable varstable_w varstable_w2 varwle vce vec vec_fevd vec_mkphi vec_p vec_p_w vecirf_create veclmar veclmar_w vecnorm vecnorm_w vecrank vecstable verinst vers versi versio version view viewsource vif vwls wdatetof webdescribe webseek webuse weib1_lf weib2_lf weib_lf weib_lf0 weibhet_glf weibhet_glf_sh weibhet_glfa weibhet_glfa_sh weibhet_gp weibhet_ilf weibhet_ilf_sh weibhet_ilfa weibhet_ilfa_sh weibhet_ip weibu_sw weibul_p weibull weibull_c weibull_s weibullhet wh whelp whi which whil while wilc_st wilcoxon win wind windo window winexec wntestb wntestb_7 wntestq xchart xchart_7 xcorr xcorr_7 xi xi_6 xmlsav xmlsave xmluse xpose xsh xshe xshel xshell xt_iis xt_tis xtab_p xtabond xtbin_p xtclog xtcloglog xtcloglog_8 xtcloglog_d2 xtcloglog_pa_p xtcloglog_re_p xtcnt_p xtcorr xtdata xtdes xtfront_p xtfrontier xtgee xtgee_elink xtgee_estat xtgee_makeivar xtgee_p xtgee_plink xtgls xtgls_p xthaus xthausman xtht_p xthtaylor xtile xtint_p xtintreg xtintreg_8 xtintreg_d2 xtintreg_p xtivp_1 xtivp_2 xtivreg xtline xtline_ex xtlogit xtlogit_8 xtlogit_d2 xtlogit_fe_p xtlogit_pa_p xtlogit_re_p xtmixed xtmixed_estat xtmixed_p xtnb_fe xtnb_lf xtnbreg xtnbreg_pa_p xtnbreg_refe_p xtpcse xtpcse_p xtpois xtpoisson xtpoisson_d2 xtpoisson_pa_p xtpoisson_refe_p xtpred xtprobit xtprobit_8 xtprobit_d2 xtprobit_re_p xtps_fe xtps_lf xtps_ren xtps_ren_8 xtrar_p xtrc xtrc_p xtrchh xtrefe_p xtreg xtreg_be xtreg_fe xtreg_ml xtreg_pa_p xtreg_re xtregar xtrere_p xtset xtsf_ll xtsf_llti xtsum xttab xttest0 xttobit xttobit_8 xttobit_p xttrans yx yxview__barlike_draw yxview_area_draw yxview_bar_draw yxview_dot_draw yxview_dropline_draw yxview_function_draw yxview_iarrow_draw yxview_ilabels_draw yxview_normal_draw yxview_pcarrow_draw yxview_pcbarrow_draw yxview_pccapsym_draw yxview_pcscatter_draw yxview_pcspike_draw yxview_rarea_draw yxview_rbar_draw yxview_rbarm_draw yxview_rcap_draw yxview_rcapsym_draw yxview_rconnected_draw yxview_rline_draw yxview_rscatter_draw yxview_rspike_draw yxview_spike_draw yxview_sunflower_draw zap_s zinb zinb_llf zinb_plf zip zip_llf zip_p zip_plf zt_ct_5 zt_hc_5 zt_hcd_5 zt_is_5 zt_iss_5 zt_sho_5 zt_smp_5 ztbase_5 ztcox_5 ztdes_5 ztereg_5 ztfill_5 ztgen_5 ztir_5 ztjoin_5 ztnb ztnb_p ztp ztp_p zts_5 ztset_5 ztspli_5 ztsum_5 zttoct_5 ztvary_5 ztweib_5",c:[{cN:"label",v:[{b:"\\$\\{?[a-zA-Z0-9_]+\\}?"},{b:"`[a-zA-Z0-9_]+'"}]},{cN:"string",v:[{b:'`"[^\r\n]*?"\''},{b:'"[^\r\n"]*"'}]},{cN:"literal",v:[{b:"\\b(abs|acos|asin|atan|atan2|atanh|ceil|cloglog|comb|cos|digamma|exp|floor|invcloglog|invlogit|ln|lnfact|lnfactorial|lngamma|log|log10|max|min|mod|reldif|round|sign|sin|sqrt|sum|tan|tanh|trigamma|trunc|betaden|Binomial|binorm|binormal|chi2|chi2tail|dgammapda|dgammapdada|dgammapdadx|dgammapdx|dgammapdxdx|F|Fden|Ftail|gammaden|gammap|ibeta|invbinomial|invchi2|invchi2tail|invF|invFtail|invgammap|invibeta|invnchi2|invnFtail|invnibeta|invnorm|invnormal|invttail|nbetaden|nchi2|nFden|nFtail|nibeta|norm|normal|normalden|normd|npnchi2|tden|ttail|uniform|abbrev|char|index|indexnot|length|lower|ltrim|match|plural|proper|real|regexm|regexr|regexs|reverse|rtrim|string|strlen|strlower|strltrim|strmatch|strofreal|strpos|strproper|strreverse|strrtrim|strtrim|strupper|subinstr|subinword|substr|trim|upper|word|wordcount|_caller|autocode|byteorder|chop|clip|cond|e|epsdouble|epsfloat|group|inlist|inrange|irecode|matrix|maxbyte|maxdouble|maxfloat|maxint|maxlong|mi|minbyte|mindouble|minfloat|minint|minlong|missing|r|recode|replay|return|s|scalar|d|date|day|dow|doy|halfyear|mdy|month|quarter|week|year|d|daily|dofd|dofh|dofm|dofq|dofw|dofy|h|halfyearly|hofd|m|mofd|monthly|q|qofd|quarterly|tin|twithin|w|weekly|wofd|y|yearly|yh|ym|yofd|yq|yw|cholesky|colnumb|colsof|corr|det|diag|diag0cnt|el|get|hadamard|I|inv|invsym|issym|issymmetric|J|matmissing|matuniform|mreldif|nullmat|rownumb|rowsof|sweep|syminv|trace|vec|vecdiag)(?=\\(|$)"}]},e.C("^[ ]*\\*.*$",!1),e.CLCM,e.CBCM]}});hljs.registerLanguage("asciidoc",function(e){return{aliases:["adoc"],c:[e.C("^/{4,}\\n","\\n/{4,}$",{r:10}),e.C("^//","$",{r:0}),{cN:"title",b:"^\\.\\w.*$"},{b:"^[=\\*]{4,}\\n",e:"\\n^[=\\*]{4,}$",r:10},{cN:"header",b:"^(={1,5}) .+?( \\1)?$",r:10},{cN:"header",b:"^[^\\[\\]\\n]+?\\n[=\\-~\\^\\+]{2,}$",r:10},{cN:"attribute",b:"^:.+?:",e:"\\s",eE:!0,r:10},{cN:"attribute",b:"^\\[.+?\\]$",r:0},{cN:"blockquote",b:"^_{4,}\\n",e:"\\n_{4,}$",r:10},{cN:"code",b:"^[\\-\\.]{4,}\\n",e:"\\n[\\-\\.]{4,}$",r:10},{b:"^\\+{4,}\\n",e:"\\n\\+{4,}$",c:[{b:"<",e:">",sL:"xml",r:0}],r:10},{cN:"bullet",b:"^(\\*+|\\-+|\\.+|[^\\n]+?::)\\s+"},{cN:"label",b:"^(NOTE|TIP|IMPORTANT|WARNING|CAUTION):\\s+",r:10},{cN:"strong",b:"\\B\\*(?![\\*\\s])",e:"(\\n{2}|\\*)",c:[{b:"\\\\*\\w",r:0}]},{cN:"emphasis",b:"\\B'(?!['\\s])",e:"(\\n{2}|')",c:[{b:"\\\\'\\w",r:0}],r:0},{cN:"emphasis",b:"_(?![_\\s])",e:"(\\n{2}|_)",r:0},{cN:"smartquote",v:[{b:"``.+?''"},{b:"`.+?'"}]},{cN:"code",b:"(`.+?`|\\+.+?\\+)",r:0},{cN:"code",b:"^[ \\t]",e:"$",r:0},{cN:"horizontal_rule",b:"^'{3,}[ \\t]*$",r:10},{b:"(link:)?(http|https|ftp|file|irc|image:?):\\S+\\[.*?\\]",rB:!0,c:[{b:"(link|image:?):",r:0},{cN:"link_url",b:"\\w",e:"[^\\[]+",r:0},{cN:"link_label",b:"\\[",e:"\\]",eB:!0,eE:!0,r:0}],r:10}]}});hljs.registerLanguage("php",function(e){var c={cN:"variable",b:"\\$+[a-zA-Z_-ÿ][a-zA-Z0-9_-ÿ]*"},i={cN:"preprocessor",b:/<\?(php)?|\?>/},a={cN:"string",c:[e.BE,i],v:[{b:'b"',e:'"'},{b:"b'",e:"'"},e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null})]},n={v:[e.BNM,e.CNM]};return{aliases:["php3","php4","php5","php6"],cI:!0,k:"and include_once list abstract global private echo interface as static endswitch array null if endwhile or const for endforeach self var while isset public protected exit foreach throw elseif include __FILE__ empty require_once do xor return parent clone use __CLASS__ __LINE__ else break print eval new catch __METHOD__ case exception default die require __FUNCTION__ enddeclare final try switch continue endfor endif declare unset true false trait goto instanceof insteadof __DIR__ __NAMESPACE__ yield finally",c:[e.CLCM,e.HCM,e.C("/\\*","\\*/",{c:[{cN:"phpdoc",b:"\\s@[A-Za-z]+"},i]}),e.C("__halt_compiler.+?;",!1,{eW:!0,k:"__halt_compiler",l:e.UIR}),{cN:"string",b:"<<<['\"]?\\w+['\"]?$",e:"^\\w+;",c:[e.BE]},i,c,{b:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{cN:"function",bK:"function",e:/[;{]/,eE:!0,i:"\\$|\\[|%",c:[e.UTM,{cN:"params",b:"\\(",e:"\\)",c:["self",c,e.CBCM,a,n]}]},{cN:"class",bK:"class interface",e:"{",eE:!0,i:/[:\(\$"]/,c:[{bK:"extends implements"},e.UTM]},{bK:"namespace",e:";",i:/[\.']/,c:[e.UTM]},{bK:"use",e:";",c:[e.UTM]},{b:"=>"},a,n]}});hljs.registerLanguage("java",function(e){var a=e.UIR+"(<"+e.UIR+">)?",t="false synchronized int abstract float private char boolean static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private",c="(\\b(0b[01_]+)|\\b0[xX][a-fA-F0-9_]+|(\\b[\\d_]+(\\.[\\d_]*)?|\\.[\\d_]+)([eE][-+]?\\d+)?)[lLfF]?",r={cN:"number",b:c,r:0};return{aliases:["jsp"],k:t,i:/<\//,c:[{cN:"javadoc",b:"/\\*\\*",e:"\\*/",r:0,c:[{cN:"javadoctag",b:"(^|\\s)@[A-Za-z]+"}]},e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"new throw return",r:0},{cN:"function",b:"("+a+"\\s+)+"+e.UIR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:t,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,k:t,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},r,{cN:"annotation",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("glsl",function(e){return{k:{keyword:"atomic_uint attribute bool break bvec2 bvec3 bvec4 case centroid coherent const continue default discard dmat2 dmat2x2 dmat2x3 dmat2x4 dmat3 dmat3x2 dmat3x3 dmat3x4 dmat4 dmat4x2 dmat4x3 dmat4x4 do double dvec2 dvec3 dvec4 else flat float for highp if iimage1D iimage1DArray iimage2D iimage2DArray iimage2DMS iimage2DMSArray iimage2DRect iimage3D iimageBuffer iimageCube iimageCubeArray image1D image1DArray image2D image2DArray image2DMS image2DMSArray image2DRect image3D imageBuffer imageCube imageCubeArray in inout int invariant isampler1D isampler1DArray isampler2D isampler2DArray isampler2DMS isampler2DMSArray isampler2DRect isampler3D isamplerBuffer isamplerCube isamplerCubeArray ivec2 ivec3 ivec4 layout lowp mat2 mat2x2 mat2x3 mat2x4 mat3 mat3x2 mat3x3 mat3x4 mat4 mat4x2 mat4x3 mat4x4 mediump noperspective out patch precision readonly restrict return sample sampler1D sampler1DArray sampler1DArrayShadow sampler1DShadow sampler2D sampler2DArray sampler2DArrayShadow sampler2DMS sampler2DMSArray sampler2DRect sampler2DRectShadow sampler2DShadow sampler3D samplerBuffer samplerCube samplerCubeArray samplerCubeArrayShadow samplerCubeShadow smooth struct subroutine switch uimage1D uimage1DArray uimage2D uimage2DArray uimage2DMS uimage2DMSArray uimage2DRect uimage3D uimageBuffer uimageCube uimageCubeArray uint uniform usampler1D usampler1DArray usampler2D usampler2DArray usampler2DMS usampler2DMSArray usampler2DRect usampler3D usamplerBuffer usamplerCube usamplerCubeArray uvec2 uvec3 uvec4 varying vec2 vec3 vec4 void volatile while writeonly",built_in:"gl_BackColor gl_BackLightModelProduct gl_BackLightProduct gl_BackMaterial gl_BackSecondaryColor gl_ClipDistance gl_ClipPlane gl_ClipVertex gl_Color gl_DepthRange gl_EyePlaneQ gl_EyePlaneR gl_EyePlaneS gl_EyePlaneT gl_Fog gl_FogCoord gl_FogFragCoord gl_FragColor gl_FragCoord gl_FragData gl_FragDepth gl_FrontColor gl_FrontFacing gl_FrontLightModelProduct gl_FrontLightProduct gl_FrontMaterial gl_FrontSecondaryColor gl_InstanceID gl_InvocationID gl_Layer gl_LightModel gl_LightSource gl_MaxAtomicCounterBindings gl_MaxAtomicCounterBufferSize gl_MaxClipDistances gl_MaxClipPlanes gl_MaxCombinedAtomicCounterBuffers gl_MaxCombinedAtomicCounters gl_MaxCombinedImageUniforms gl_MaxCombinedImageUnitsAndFragmentOutputs gl_MaxCombinedTextureImageUnits gl_MaxDrawBuffers gl_MaxFragmentAtomicCounterBuffers gl_MaxFragmentAtomicCounters gl_MaxFragmentImageUniforms gl_MaxFragmentInputComponents gl_MaxFragmentUniformComponents gl_MaxFragmentUniformVectors gl_MaxGeometryAtomicCounterBuffers gl_MaxGeometryAtomicCounters gl_MaxGeometryImageUniforms gl_MaxGeometryInputComponents gl_MaxGeometryOutputComponents gl_MaxGeometryOutputVertices gl_MaxGeometryTextureImageUnits gl_MaxGeometryTotalOutputComponents gl_MaxGeometryUniformComponents gl_MaxGeometryVaryingComponents gl_MaxImageSamples gl_MaxImageUnits gl_MaxLights gl_MaxPatchVertices gl_MaxProgramTexelOffset gl_MaxTessControlAtomicCounterBuffers gl_MaxTessControlAtomicCounters gl_MaxTessControlImageUniforms gl_MaxTessControlInputComponents gl_MaxTessControlOutputComponents gl_MaxTessControlTextureImageUnits gl_MaxTessControlTotalOutputComponents gl_MaxTessControlUniformComponents gl_MaxTessEvaluationAtomicCounterBuffers gl_MaxTessEvaluationAtomicCounters gl_MaxTessEvaluationImageUniforms gl_MaxTessEvaluationInputComponents gl_MaxTessEvaluationOutputComponents gl_MaxTessEvaluationTextureImageUnits gl_MaxTessEvaluationUniformComponents gl_MaxTessGenLevel gl_MaxTessPatchComponents gl_MaxTextureCoords gl_MaxTextureImageUnits gl_MaxTextureUnits gl_MaxVaryingComponents gl_MaxVaryingFloats gl_MaxVaryingVectors gl_MaxVertexAtomicCounterBuffers gl_MaxVertexAtomicCounters gl_MaxVertexAttribs gl_MaxVertexImageUniforms gl_MaxVertexOutputComponents gl_MaxVertexTextureImageUnits gl_MaxVertexUniformComponents gl_MaxVertexUniformVectors gl_MaxViewports gl_MinProgramTexelOffsetgl_ModelViewMatrix gl_ModelViewMatrixInverse gl_ModelViewMatrixInverseTranspose gl_ModelViewMatrixTranspose gl_ModelViewProjectionMatrix gl_ModelViewProjectionMatrixInverse gl_ModelViewProjectionMatrixInverseTranspose gl_ModelViewProjectionMatrixTranspose gl_MultiTexCoord0 gl_MultiTexCoord1 gl_MultiTexCoord2 gl_MultiTexCoord3 gl_MultiTexCoord4 gl_MultiTexCoord5 gl_MultiTexCoord6 gl_MultiTexCoord7 gl_Normal gl_NormalMatrix gl_NormalScale gl_ObjectPlaneQ gl_ObjectPlaneR gl_ObjectPlaneS gl_ObjectPlaneT gl_PatchVerticesIn gl_PerVertex gl_Point gl_PointCoord gl_PointSize gl_Position gl_PrimitiveID gl_PrimitiveIDIn gl_ProjectionMatrix gl_ProjectionMatrixInverse gl_ProjectionMatrixInverseTranspose gl_ProjectionMatrixTranspose gl_SampleID gl_SampleMask gl_SampleMaskIn gl_SamplePosition gl_SecondaryColor gl_TessCoord gl_TessLevelInner gl_TessLevelOuter gl_TexCoord gl_TextureEnvColor gl_TextureMatrixInverseTranspose gl_TextureMatrixTranspose gl_Vertex gl_VertexID gl_ViewportIndex gl_in gl_out EmitStreamVertex EmitVertex EndPrimitive EndStreamPrimitive abs acos acosh all any asin asinh atan atanh atomicCounter atomicCounterDecrement atomicCounterIncrement barrier bitCount bitfieldExtract bitfieldInsert bitfieldReverse ceil clamp cos cosh cross dFdx dFdy degrees determinant distance dot equal exp exp2 faceforward findLSB findMSB floatBitsToInt floatBitsToUint floor fma fract frexp ftransform fwidth greaterThan greaterThanEqual imageAtomicAdd imageAtomicAnd imageAtomicCompSwap imageAtomicExchange imageAtomicMax imageAtomicMin imageAtomicOr imageAtomicXor imageLoad imageStore imulExtended intBitsToFloat interpolateAtCentroid interpolateAtOffset interpolateAtSample inverse inversesqrt isinf isnan ldexp length lessThan lessThanEqual log log2 matrixCompMult max memoryBarrier min mix mod modf noise1 noise2 noise3 noise4 normalize not notEqual outerProduct packDouble2x32 packHalf2x16 packSnorm2x16 packSnorm4x8 packUnorm2x16 packUnorm4x8 pow radians reflect refract round roundEven shadow1D shadow1DLod shadow1DProj shadow1DProjLod shadow2D shadow2DLod shadow2DProj shadow2DProjLod sign sin sinh smoothstep sqrt step tan tanh texelFetch texelFetchOffset texture texture1D texture1DLod texture1DProj texture1DProjLod texture2D texture2DLod texture2DProj texture2DProjLod texture3D texture3DLod texture3DProj texture3DProjLod textureCube textureCubeLod textureGather textureGatherOffset textureGatherOffsets textureGrad textureGradOffset textureLod textureLodOffset textureOffset textureProj textureProjGrad textureProjGradOffset textureProjLod textureProjLodOffset textureProjOffset textureQueryLod textureSize transpose trunc uaddCarry uintBitsToFloat umulExtended unpackDouble2x32 unpackHalf2x16 unpackSnorm2x16 unpackSnorm4x8 unpackUnorm2x16 unpackUnorm4x8 usubBorrow gl_TextureMatrix gl_TextureMatrixInverse",literal:"true false"},i:'"',c:[e.CLCM,e.CBCM,e.CNM,{cN:"preprocessor",b:"#",e:"$"}]}});hljs.registerLanguage("lua",function(e){var t="\\[=*\\[",a="\\]=*\\]",r={b:t,e:a,c:["self"]},n=[e.C("--(?!"+t+")","$"),e.C("--"+t,a,{c:[r],r:10})];return{l:e.UIR,k:{keyword:"and break do else elseif end false for if in local nil not or repeat return then true until while",built_in:"_G _VERSION assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstring module next pairs pcall print rawequal rawget rawset require select setfenv setmetatable tonumber tostring type unpack xpcall coroutine debug io math os package string table"},c:n.concat([{cN:"function",bK:"function",e:"\\)",c:[e.inherit(e.TM,{b:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{cN:"params",b:"\\(",eW:!0,c:n}].concat(n)},e.CNM,e.ASM,e.QSM,{cN:"string",b:t,e:a,c:[r],r:5}])}});hljs.registerLanguage("protobuf",function(e){return{k:{keyword:"package import option optional required repeated group",built_in:"double float int32 int64 uint32 uint64 sint32 sint64 fixed32 fixed64 sfixed32 sfixed64 bool string bytes",literal:"true false"},c:[e.QSM,e.NM,e.CLCM,{cN:"class",bK:"message enum service",e:/\{/,i:/\n/,c:[e.inherit(e.TM,{starts:{eW:!0,eE:!0}})]},{cN:"function",bK:"rpc",e:/;/,eE:!0,k:"rpc returns"},{cN:"constant",b:/^\s*[A-Z_]+/,e:/\s*=/,eE:!0}]}});hljs.registerLanguage("gcode",function(e){var N="[A-Z_][A-Z0-9_.]*",i="\\%",c={literal:"",built_in:"",keyword:"IF DO WHILE ENDWHILE CALL ENDIF SUB ENDSUB GOTO REPEAT ENDREPEAT EQ LT GT NE GE LE OR XOR"},r={cN:"preprocessor",b:"([O])([0-9]+)"},l=[e.CLCM,e.CBCM,e.C(/\(/,/\)/),e.inherit(e.CNM,{b:"([-+]?([0-9]*\\.?[0-9]+\\.?))|"+e.CNR}),e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null}),{cN:"keyword",b:"([G])([0-9]+\\.?[0-9]?)"},{cN:"title",b:"([M])([0-9]+\\.?[0-9]?)"},{cN:"title",b:"(VC|VS|#)",e:"(\\d+)"},{cN:"title",b:"(VZOFX|VZOFY|VZOFZ)"},{cN:"built_in",b:"(ATAN|ABS|ACOS|ASIN|SIN|COS|EXP|FIX|FUP|ROUND|LN|TAN)(\\[)",e:"([-+]?([0-9]*\\.?[0-9]+\\.?))(\\])"},{cN:"label",v:[{b:"N",e:"\\d+",i:"\\W"}]}];return{aliases:["nc"],cI:!0,l:N,k:c,c:[{cN:"preprocessor",b:i},r].concat(l)}});hljs.registerLanguage("vim",function(e){return{l:/[!#@\w]+/,k:{keyword:"N|0 P|0 X|0 a|0 ab abc abo al am an|0 ar arga argd arge argdo argg argl argu as au aug aun b|0 bN ba bad bd be bel bf bl bm bn bo bp br brea breaka breakd breakl bro bufdo buffers bun bw c|0 cN cNf ca cabc caddb cad caddf cal cat cb cc ccl cd ce cex cf cfir cgetb cgete cg changes chd che checkt cl cla clo cm cmapc cme cn cnew cnf cno cnorea cnoreme co col colo com comc comp con conf cope cp cpf cq cr cs cst cu cuna cunme cw d|0 delm deb debugg delc delf dif diffg diffo diffp diffpu diffs diffthis dig di dl dell dj dli do doautoa dp dr ds dsp e|0 ea ec echoe echoh echom echon el elsei em en endfo endf endt endw ene ex exe exi exu f|0 files filet fin fina fini fir fix fo foldc foldd folddoc foldo for fu g|0 go gr grepa gu gv ha h|0 helpf helpg helpt hi hid his i|0 ia iabc if ij il im imapc ime ino inorea inoreme int is isp iu iuna iunme j|0 ju k|0 keepa kee keepj lN lNf l|0 lad laddb laddf la lan lat lb lc lch lcl lcs le lefta let lex lf lfir lgetb lgete lg lgr lgrepa lh ll lla lli lmak lm lmapc lne lnew lnf ln loadk lo loc lockv lol lope lp lpf lr ls lt lu lua luad luaf lv lvimgrepa lw m|0 ma mak map mapc marks mat me menut mes mk mks mksp mkv mkvie mod mz mzf nbc nb nbs n|0 new nm nmapc nme nn nnoreme noa no noh norea noreme norm nu nun nunme ol o|0 om omapc ome on ono onoreme opt ou ounme ow p|0 profd prof pro promptr pc ped pe perld po popu pp pre prev ps pt ptN ptf ptj ptl ptn ptp ptr pts pu pw py3 python3 py3d py3f py pyd pyf q|0 quita qa r|0 rec red redi redr redraws reg res ret retu rew ri rightb rub rubyd rubyf rund ru rv s|0 sN san sa sal sav sb sbN sba sbf sbl sbm sbn sbp sbr scrip scripte scs se setf setg setl sf sfir sh sim sig sil sl sla sm smap smapc sme sn sni sno snor snoreme sor so spelld spe spelli spellr spellu spellw sp spr sre st sta startg startr star stopi stj sts sun sunm sunme sus sv sw sy synti sync t|0 tN tabN tabc tabdo tabe tabf tabfir tabl tabm tabnew tabn tabo tabp tabr tabs tab ta tags tc tcld tclf te tf th tj tl tm tn to tp tr try ts tu u|0 undoj undol una unh unl unlo unm unme uns up v|0 ve verb vert vim vimgrepa vi viu vie vm vmapc vme vne vn vnoreme vs vu vunme windo w|0 wN wa wh wi winc winp wn wp wq wqa ws wu wv x|0 xa xmapc xm xme xn xnoreme xu xunme y|0 z|0 ~ Next Print append abbreviate abclear aboveleft all amenu anoremenu args argadd argdelete argedit argglobal arglocal argument ascii autocmd augroup aunmenu buffer bNext ball badd bdelete behave belowright bfirst blast bmodified bnext botright bprevious brewind break breakadd breakdel breaklist browse bunload bwipeout change cNext cNfile cabbrev cabclear caddbuffer caddexpr caddfile call catch cbuffer cclose center cexpr cfile cfirst cgetbuffer cgetexpr cgetfile chdir checkpath checktime clist clast close cmap cmapclear cmenu cnext cnewer cnfile cnoremap cnoreabbrev cnoremenu copy colder colorscheme command comclear compiler continue confirm copen cprevious cpfile cquit crewind cscope cstag cunmap cunabbrev cunmenu cwindow delete delmarks debug debuggreedy delcommand delfunction diffupdate diffget diffoff diffpatch diffput diffsplit digraphs display deletel djump dlist doautocmd doautoall deletep drop dsearch dsplit edit earlier echo echoerr echohl echomsg else elseif emenu endif endfor endfunction endtry endwhile enew execute exit exusage file filetype find finally finish first fixdel fold foldclose folddoopen folddoclosed foldopen function global goto grep grepadd gui gvim hardcopy help helpfind helpgrep helptags highlight hide history insert iabbrev iabclear ijump ilist imap imapclear imenu inoremap inoreabbrev inoremenu intro isearch isplit iunmap iunabbrev iunmenu join jumps keepalt keepmarks keepjumps lNext lNfile list laddexpr laddbuffer laddfile last language later lbuffer lcd lchdir lclose lcscope left leftabove lexpr lfile lfirst lgetbuffer lgetexpr lgetfile lgrep lgrepadd lhelpgrep llast llist lmake lmap lmapclear lnext lnewer lnfile lnoremap loadkeymap loadview lockmarks lockvar lolder lopen lprevious lpfile lrewind ltag lunmap luado luafile lvimgrep lvimgrepadd lwindow move mark make mapclear match menu menutranslate messages mkexrc mksession mkspell mkvimrc mkview mode mzscheme mzfile nbclose nbkey nbsart next nmap nmapclear nmenu nnoremap nnoremenu noautocmd noremap nohlsearch noreabbrev noremenu normal number nunmap nunmenu oldfiles open omap omapclear omenu only onoremap onoremenu options ounmap ounmenu ownsyntax print profdel profile promptfind promptrepl pclose pedit perl perldo pop popup ppop preserve previous psearch ptag ptNext ptfirst ptjump ptlast ptnext ptprevious ptrewind ptselect put pwd py3do py3file python pydo pyfile quit quitall qall read recover redo redir redraw redrawstatus registers resize retab return rewind right rightbelow ruby rubydo rubyfile rundo runtime rviminfo substitute sNext sandbox sargument sall saveas sbuffer sbNext sball sbfirst sblast sbmodified sbnext sbprevious sbrewind scriptnames scriptencoding scscope set setfiletype setglobal setlocal sfind sfirst shell simalt sign silent sleep slast smagic smapclear smenu snext sniff snomagic snoremap snoremenu sort source spelldump spellgood spellinfo spellrepall spellundo spellwrong split sprevious srewind stop stag startgreplace startreplace startinsert stopinsert stjump stselect sunhide sunmap sunmenu suspend sview swapname syntax syntime syncbind tNext tabNext tabclose tabedit tabfind tabfirst tablast tabmove tabnext tabonly tabprevious tabrewind tag tcl tcldo tclfile tearoff tfirst throw tjump tlast tmenu tnext topleft tprevious trewind tselect tunmenu undo undojoin undolist unabbreviate unhide unlet unlockvar unmap unmenu unsilent update vglobal version verbose vertical vimgrep vimgrepadd visual viusage view vmap vmapclear vmenu vnew vnoremap vnoremenu vsplit vunmap vunmenu write wNext wall while winsize wincmd winpos wnext wprevious wqall wsverb wundo wviminfo xit xall xmapclear xmap xmenu xnoremap xnoremenu xunmap xunmenu yank",built_in:"abs acos add and append argc argidx argv asin atan atan2 browse browsedir bufexists buflisted bufloaded bufname bufnr bufwinnr byte2line byteidx call ceil changenr char2nr cindent clearmatches col complete complete_add complete_check confirm copy cos cosh count cscope_connection cursor deepcopy delete did_filetype diff_filler diff_hlID empty escape eval eventhandler executable exists exp expand extend feedkeys filereadable filewritable filter finddir findfile float2nr floor fmod fnameescape fnamemodify foldclosed foldclosedend foldlevel foldtext foldtextresult foreground function garbagecollect get getbufline getbufvar getchar getcharmod getcmdline getcmdpos getcmdtype getcwd getfontname getfperm getfsize getftime getftype getline getloclist getmatches getpid getpos getqflist getreg getregtype gettabvar gettabwinvar getwinposx getwinposy getwinvar glob globpath has has_key haslocaldir hasmapto histadd histdel histget histnr hlexists hlID hostname iconv indent index input inputdialog inputlist inputrestore inputsave inputsecret insert invert isdirectory islocked items join keys len libcall libcallnr line line2byte lispindent localtime log log10 luaeval map maparg mapcheck match matchadd matcharg matchdelete matchend matchlist matchstr max min mkdir mode mzeval nextnonblank nr2char or pathshorten pow prevnonblank printf pumvisible py3eval pyeval range readfile reltime reltimestr remote_expr remote_foreground remote_peek remote_read remote_send remove rename repeat resolve reverse round screenattr screenchar screencol screenrow search searchdecl searchpair searchpairpos searchpos server2client serverlist setbufvar setcmdpos setline setloclist setmatches setpos setqflist setreg settabvar settabwinvar setwinvar sha256 shellescape shiftwidth simplify sin sinh sort soundfold spellbadword spellsuggest split sqrt str2float str2nr strchars strdisplaywidth strftime stridx string strlen strpart strridx strtrans strwidth submatch substitute synconcealed synID synIDattr synIDtrans synstack system tabpagebuflist tabpagenr tabpagewinnr tagfiles taglist tan tanh tempname tolower toupper tr trunc type undofile undotree values virtcol visualmode wildmenumode winbufnr wincol winheight winline winnr winrestcmd winrestview winsaveview winwidth writefile xor"},i:/[{:]/,c:[e.NM,e.ASM,{cN:"string",b:/"((\\")|[^"\n])*("|\n)/},{cN:"variable",b:/[bwtglsav]:[\w\d_]*/},{cN:"function",bK:"function function!",e:"$",r:0,c:[e.TM,{cN:"params",b:"\\(",e:"\\)"}]}]}});hljs.registerLanguage("processing",function(e){return{k:{keyword:"BufferedReader PVector PFont PImage PGraphics HashMap boolean byte char color double float int long String Array FloatDict FloatList IntDict IntList JSONArray JSONObject Object StringDict StringList Table TableRow XML false synchronized int abstract float private char boolean static null if const for true while long throw strictfp finally protected import native final return void enum else break transient new catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private",constant:"P2D P3D HALF_PI PI QUARTER_PI TAU TWO_PI",variable:"displayHeight displayWidth mouseY mouseX mousePressed pmouseX pmouseY key keyCode pixels focused frameCount frameRate height width",title:"setup draw",built_in:"size createGraphics beginDraw createShape loadShape PShape arc ellipse line point quad rect triangle bezier bezierDetail bezierPoint bezierTangent curve curveDetail curvePoint curveTangent curveTightness shape shapeMode beginContour beginShape bezierVertex curveVertex endContour endShape quadraticVertex vertex ellipseMode noSmooth rectMode smooth strokeCap strokeJoin strokeWeight mouseClicked mouseDragged mouseMoved mousePressed mouseReleased mouseWheel keyPressed keyPressedkeyReleased keyTyped print println save saveFrame day hour millis minute month second year background clear colorMode fill noFill noStroke stroke alpha blue brightness color green hue lerpColor red saturation modelX modelY modelZ screenX screenY screenZ ambient emissive shininess specular add createImage beginCamera camera endCamera frustum ortho perspective printCamera printProjection cursor frameRate noCursor exit loop noLoop popStyle pushStyle redraw binary boolean byte char float hex int str unbinary unhex join match matchAll nf nfc nfp nfs split splitTokens trim append arrayCopy concat expand reverse shorten sort splice subset box sphere sphereDetail createInput createReader loadBytes loadJSONArray loadJSONObject loadStrings loadTable loadXML open parseXML saveTable selectFolder selectInput beginRaw beginRecord createOutput createWriter endRaw endRecord PrintWritersaveBytes saveJSONArray saveJSONObject saveStream saveStrings saveXML selectOutput popMatrix printMatrix pushMatrix resetMatrix rotate rotateX rotateY rotateZ scale shearX shearY translate ambientLight directionalLight lightFalloff lights lightSpecular noLights normal pointLight spotLight image imageMode loadImage noTint requestImage tint texture textureMode textureWrap blend copy filter get loadPixels set updatePixels blendMode loadShader PShaderresetShader shader createFont loadFont text textFont textAlign textLeading textMode textSize textWidth textAscent textDescent abs ceil constrain dist exp floor lerp log mag map max min norm pow round sq sqrt acos asin atan atan2 cos degrees radians sin tan noise noiseDetail noiseSeed random randomGaussian randomSeed"},c:[e.CLCM,e.CBCM,e.ASM,e.QSM,e.CNM]}});hljs.registerLanguage("mizar",function(e){return{k:"environ vocabularies notations constructors definitions registrations theorems schemes requirements begin end definition registration cluster existence pred func defpred deffunc theorem proof let take assume then thus hence ex for st holds consider reconsider such that and in provided of as from be being by means equals implies iff redefine define now not or attr is mode suppose per cases set thesis contradiction scheme reserve struct correctness compatibility coherence symmetry assymetry reflexivity irreflexivity connectedness uniqueness commutativity idempotence involutiveness projectivity",c:[e.C("::","$")]}});hljs.registerLanguage("vbnet",function(e){return{aliases:["vb"],cI:!0,k:{keyword:"addhandler addressof alias and andalso aggregate ansi as assembly auto binary by byref byval call case catch class compare const continue custom declare default delegate dim distinct do each equals else elseif end enum erase error event exit explicit finally for friend from function get global goto group handles if implements imports in inherits interface into is isfalse isnot istrue join key let lib like loop me mid mod module mustinherit mustoverride mybase myclass namespace narrowing new next not notinheritable notoverridable of off on operator option optional or order orelse overloads overridable overrides paramarray partial preserve private property protected public raiseevent readonly redim rem removehandler resume return select set shadows shared skip static step stop structure strict sub synclock take text then throw to try unicode until using when where while widening with withevents writeonly xor",built_in:"boolean byte cbool cbyte cchar cdate cdec cdbl char cint clng cobj csbyte cshort csng cstr ctype date decimal directcast double gettype getxmlnamespace iif integer long object sbyte short single string trycast typeof uinteger ulong ushort",literal:"true false nothing"},i:"//|{|}|endif|gosub|variant|wend",c:[e.inherit(e.QSM,{c:[{b:'""'}]}),e.C("'","$",{rB:!0,c:[{cN:"xmlDocTag",b:"'''|",c:[e.PWM]},{cN:"xmlDocTag",b:"",c:[e.PWM]}]}),e.CNM,{cN:"preprocessor",b:"#",e:"$",k:"if else elseif end region externalsource"}]}});hljs.registerLanguage("q",function(e){var s={keyword:"do while select delete by update from",constant:"0b 1b",built_in:"neg not null string reciprocal floor ceiling signum mod xbar xlog and or each scan over prior mmu lsq inv md5 ltime gtime count first var dev med cov cor all any rand sums prds mins maxs fills deltas ratios avgs differ prev next rank reverse iasc idesc asc desc msum mcount mavg mdev xrank mmin mmax xprev rotate distinct group where flip type key til get value attr cut set upsert raze union inter except cross sv vs sublist enlist read0 read1 hopen hclose hdel hsym hcount peach system ltrim rtrim trim lower upper ssr view tables views cols xcols keys xkey xcol xasc xdesc fkeys meta lj aj aj0 ij pj asof uj ww wj wj1 fby xgroup ungroup ej save load rsave rload show csv parse eval min max avg wavg wsum sin cos tan sum",typename:"`float `double int `timestamp `timespan `datetime `time `boolean `symbol `char `byte `short `long `real `month `date `minute `second `guid"};return{aliases:["k","kdb"],k:s,l:/\b(`?)[A-Za-z0-9_]+\b/,c:[e.CLCM,e.QSM,e.CNM]}});hljs.registerLanguage("livescript",function(e){var t={keyword:"in if for while finally new do return else break catch instanceof throw try this switch continue typeof delete debugger case default function var with then unless until loop of by when and or is isnt not it that otherwise from to til fallthrough super case default function var void const let enum export import native __hasProp __extends __slice __bind __indexOf",literal:"true false null undefined yes no on off it that void",built_in:"npm require console print module global window document"},s="[A-Za-z$_](?:-[0-9A-Za-z$_]|[0-9A-Za-z$_])*",i=e.inherit(e.TM,{b:s}),n={cN:"subst",b:/#\{/,e:/}/,k:t},r={cN:"subst",b:/#[A-Za-z$_]/,e:/(?:\-[0-9A-Za-z$_]|[0-9A-Za-z$_])*/,k:t},c=[e.BNM,{cN:"number",b:"(\\b0[xX][a-fA-F0-9_]+)|(\\b\\d(\\d|_\\d)*(\\.(\\d(\\d|_\\d)*)?)?(_*[eE]([-+]\\d(_\\d|\\d)*)?)?[_a-z]*)",r:0,starts:{e:"(\\s*/)?",r:0}},{cN:"string",v:[{b:/'''/,e:/'''/,c:[e.BE]},{b:/'/,e:/'/,c:[e.BE]},{b:/"""/,e:/"""/,c:[e.BE,n,r]},{b:/"/,e:/"/,c:[e.BE,n,r]},{b:/\\/,e:/(\s|$)/,eE:!0}]},{cN:"pi",v:[{b:"//",e:"//[gim]*",c:[n,e.HCM]},{b:/\/(?![ *])(\\\/|.)*?\/[gim]*(?=\W|$)/}]},{cN:"property",b:"@"+s},{b:"``",e:"``",eB:!0,eE:!0,sL:"javascript"}];n.c=c;var a={cN:"params",b:"\\(",rB:!0,c:[{b:/\(/,e:/\)/,k:t,c:["self"].concat(c)}]};return{aliases:["ls"],k:t,i:/\/\*/,c:c.concat([e.C("\\/\\*","\\*\\/"),e.HCM,{cN:"function",c:[i,a],rB:!0,v:[{b:"("+s+"\\s*(?:=|:=)\\s*)?(\\(.*\\))?\\s*\\B\\->\\*?",e:"\\->\\*?"},{b:"("+s+"\\s*(?:=|:=)\\s*)?!?(\\(.*\\))?\\s*\\B[-~]{1,2}>\\*?",e:"[-~]{1,2}>\\*?"},{b:"("+s+"\\s*(?:=|:=)\\s*)?(\\(.*\\))?\\s*\\B!?[-~]{1,2}>\\*?",e:"!?[-~]{1,2}>\\*?"}]},{cN:"class",bK:"class",e:"$",i:/[:="\[\]]/,c:[{bK:"extends",eW:!0,i:/[:="\[\]]/,c:[i]},i]},{cN:"attribute",b:s+":",e:":",rB:!0,rE:!0,r:0}])}});hljs.registerLanguage("haxe",function(e){var r="([*]|[a-zA-Z_$][a-zA-Z0-9_$]*)";return{aliases:["hx"],k:{keyword:"break callback case cast catch class continue default do dynamic else enum extends extern for function here if implements import in inline interface never new override package private public return static super switch this throw trace try typedef untyped using var while",literal:"true false null"},c:[e.ASM,e.QSM,e.CLCM,e.CBCM,e.CNM,{cN:"class",bK:"class interface",e:"{",eE:!0,c:[{bK:"extends implements"},e.TM]},{cN:"preprocessor",b:"#",e:"$",k:"if else elseif end error"},{cN:"function",bK:"function",e:"[{;]",eE:!0,i:"\\S",c:[e.TM,{cN:"params",b:"\\(",e:"\\)",c:[e.ASM,e.QSM,e.CLCM,e.CBCM]},{cN:"type",b:":",e:r,r:10}]}]}});hljs.registerLanguage("monkey",function(e){var n={cN:"number",r:0,v:[{b:"[$][a-fA-F0-9]+"},e.NM]};return{cI:!0,k:{keyword:"public private property continue exit extern new try catch eachin not abstract final select case default const local global field end if then else elseif endif while wend repeat until forever for to step next return module inline throw",built_in:"DebugLog DebugStop Error Print ACos ACosr ASin ASinr ATan ATan2 ATan2r ATanr Abs Abs Ceil Clamp Clamp Cos Cosr Exp Floor Log Max Max Min Min Pow Sgn Sgn Sin Sinr Sqrt Tan Tanr Seed PI HALFPI TWOPI",literal:"true false null and or shl shr mod"},c:[e.C("#rem","#end"),e.C("'","$",{r:0}),{cN:"function",bK:"function method",e:"[(=:]|$",i:/\n/,c:[e.UTM]},{cN:"class",bK:"class interface",e:"$",c:[{bK:"extends implements"},e.UTM]},{cN:"variable",b:"\\b(self|super)\\b"},{cN:"preprocessor",bK:"import",e:"$"},{cN:"preprocessor",b:"\\s*#",e:"$",k:"if else elseif endif end then"},{cN:"pi",b:"^\\s*strict\\b"},{bK:"alias",e:"=",c:[e.UTM]},e.QSM,n]}});hljs.registerLanguage("bash",function(e){var t={cN:"variable",v:[{b:/\$[\w\d#@][\w\d_]*/},{b:/\$\{(.*?)}/}]},s={cN:"string",b:/"/,e:/"/,c:[e.BE,t,{cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["sh","zsh"],l:/-?[a-z\.]+/,k:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",operator:"-ne -eq -lt -gt -f -d -e -s -l -a"},c:[{cN:"shebang",b:/^#![^\n]+sh\s*$/,r:10},{cN:"function",b:/\w[\w\d_]*\s*\(\s*\)\s*\{/,rB:!0,c:[e.inherit(e.TM,{b:/\w[\w\d_]*/})],r:0},e.HCM,e.NM,s,a,t]}});hljs.registerLanguage("erlang",function(e){var r="[a-z'][a-zA-Z0-9_']*",c="("+r+":"+r+"|"+r+")",a={keyword:"after and andalso|10 band begin bnot bor bsl bzr bxor case catch cond div end fun if let not of orelse|10 query receive rem try when xor",literal:"false true"},n=e.C("%","$"),i={cN:"number",b:"\\b(\\d+#[a-fA-F0-9]+|\\d+(\\.\\d+)?([eE][-+]?\\d+)?)",r:0},b={b:"fun\\s+"+r+"/\\d+"},d={b:c+"\\(",e:"\\)",rB:!0,r:0,c:[{cN:"function_name",b:c,r:0},{b:"\\(",e:"\\)",eW:!0,rE:!0,r:0}]},o={cN:"tuple",b:"{",e:"}",r:0},t={cN:"variable",b:"\\b_([A-Z][A-Za-z0-9_]*)?",r:0},l={cN:"variable",b:"[A-Z][a-zA-Z0-9_]*",r:0},f={b:"#"+e.UIR,r:0,rB:!0,c:[{cN:"record_name",b:"#"+e.UIR,r:0},{b:"{",e:"}",r:0}]},s={bK:"fun receive if try case",e:"end",k:a};s.c=[n,b,e.inherit(e.ASM,{cN:""}),s,d,e.QSM,i,o,t,l,f];var u=[n,b,s,d,e.QSM,i,o,t,l,f];d.c[1].c=u,o.c=u,f.c[1].c=u;var v={cN:"params",b:"\\(",e:"\\)",c:u};return{aliases:["erl"],k:a,i:"(",rB:!0,i:"\\(|#|//|/\\*|\\\\|:|;",c:[v,e.inherit(e.TM,{b:r})],starts:{e:";|\\.",k:a,c:u}},n,{cN:"pp",b:"^-",e:"\\.",r:0,eE:!0,rB:!0,l:"-"+e.IR,k:"-module -record -undef -export -ifdef -ifndef -author -copyright -doc -vsn -import -include -include_lib -compile -define -else -endif -file -behaviour -behavior -spec",c:[v]},i,e.QSM,f,t,l,o,{b:/\.$/}]}});hljs.registerLanguage("kotlin",function(e){var a="val var get set class trait object public open private protected final enum if else do while for when break continue throw try catch finally import package is as in return fun override default companion reified inline volatile transient native";return{k:{typename:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing",literal:"true false null",keyword:a},c:[e.CLCM,{cN:"javadoc",b:"/\\*\\*",e:"\\*//*",r:0,c:[{cN:"javadoctag",b:"(^|\\s)@[A-Za-z]+"}]},e.CBCM,{cN:"type",b://,rB:!0,eE:!1,r:0},{cN:"function",bK:"fun",e:"[(]|$",rB:!0,eE:!0,k:a,i:/fun\s+(<.*>)?[^\s\(]+(\s+[^\s\(]+)\s*=/,r:5,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"type",b://,k:"reified",r:0},{cN:"params",b:/\(/,e:/\)/,k:a,r:0,i:/\([^\(,\s:]+,/,c:[{cN:"typename",b:/:\s*/,e:/\s*[=\)]/,eB:!0,rE:!0,r:0}]},e.CLCM,e.CBCM]},{cN:"class",bK:"class trait",e:/[:\{(]|$/,eE:!0,i:"extends implements",c:[e.UTM,{cN:"type",b://,eB:!0,eE:!0,r:0},{cN:"typename",b:/[,:]\s*/,e:/[<\(,]|$/,eB:!0,rE:!0}]},{cN:"variable",bK:"var val",e:/\s*[=:$]/,eE:!0},e.QSM,{cN:"shebang",b:"^#!/usr/bin/env",e:"$",i:"\n"},e.CNM]}});hljs.registerLanguage("stylus",function(t){var e={cN:"variable",b:"\\$"+t.IR},o={cN:"hexcolor",b:"#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})",r:10},i=["charset","css","debug","extend","font-face","for","import","include","media","mixin","page","warn","while"],r=["after","before","first-letter","first-line","active","first-child","focus","hover","lang","link","visited"],n=["a","abbr","address","article","aside","audio","b","blockquote","body","button","canvas","caption","cite","code","dd","del","details","dfn","div","dl","dt","em","fieldset","figcaption","figure","footer","form","h1","h2","h3","h4","h5","h6","header","hgroup","html","i","iframe","img","input","ins","kbd","label","legend","li","mark","menu","nav","object","ol","p","q","quote","samp","section","span","strong","summary","sup","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul","var","video"],a="[\\.\\s\\n\\[\\:,]",l=["align-content","align-items","align-self","animation","animation-delay","animation-direction","animation-duration","animation-fill-mode","animation-iteration-count","animation-name","animation-play-state","animation-timing-function","auto","backface-visibility","background","background-attachment","background-clip","background-color","background-image","background-origin","background-position","background-repeat","background-size","border","border-bottom","border-bottom-color","border-bottom-left-radius","border-bottom-right-radius","border-bottom-style","border-bottom-width","border-collapse","border-color","border-image","border-image-outset","border-image-repeat","border-image-slice","border-image-source","border-image-width","border-left","border-left-color","border-left-style","border-left-width","border-radius","border-right","border-right-color","border-right-style","border-right-width","border-spacing","border-style","border-top","border-top-color","border-top-left-radius","border-top-right-radius","border-top-style","border-top-width","border-width","bottom","box-decoration-break","box-shadow","box-sizing","break-after","break-before","break-inside","caption-side","clear","clip","clip-path","color","column-count","column-fill","column-gap","column-rule","column-rule-color","column-rule-style","column-rule-width","column-span","column-width","columns","content","counter-increment","counter-reset","cursor","direction","display","empty-cells","filter","flex","flex-basis","flex-direction","flex-flow","flex-grow","flex-shrink","flex-wrap","float","font","font-family","font-feature-settings","font-kerning","font-language-override","font-size","font-size-adjust","font-stretch","font-style","font-variant","font-variant-ligatures","font-weight","height","hyphens","icon","image-orientation","image-rendering","image-resolution","ime-mode","inherit","initial","justify-content","left","letter-spacing","line-height","list-style","list-style-image","list-style-position","list-style-type","margin","margin-bottom","margin-left","margin-right","margin-top","marks","mask","max-height","max-width","min-height","min-width","nav-down","nav-index","nav-left","nav-right","nav-up","none","normal","object-fit","object-position","opacity","order","orphans","outline","outline-color","outline-offset","outline-style","outline-width","overflow","overflow-wrap","overflow-x","overflow-y","padding","padding-bottom","padding-left","padding-right","padding-top","page-break-after","page-break-before","page-break-inside","perspective","perspective-origin","pointer-events","position","quotes","resize","right","tab-size","table-layout","text-align","text-align-last","text-decoration","text-decoration-color","text-decoration-line","text-decoration-style","text-indent","text-overflow","text-rendering","text-shadow","text-transform","text-underline-position","top","transform","transform-origin","transform-style","transition","transition-delay","transition-duration","transition-property","transition-timing-function","unicode-bidi","vertical-align","visibility","white-space","widows","width","word-break","word-spacing","word-wrap","z-index"],d=["\\{","\\}","\\?","(\\bReturn\\b)","(\\bEnd\\b)","(\\bend\\b)",";","#\\s","\\*\\s","===\\s","\\|","%"];return{aliases:["styl"],cI:!1,i:"("+d.join("|")+")",k:"if else for in",c:[t.QSM,t.ASM,t.CLCM,t.CBCM,o,{b:"\\.[a-zA-Z][a-zA-Z0-9_-]*"+a,rB:!0,c:[{cN:"class",b:"\\.[a-zA-Z][a-zA-Z0-9_-]*"}]},{b:"\\#[a-zA-Z][a-zA-Z0-9_-]*"+a,rB:!0,c:[{cN:"id",b:"\\#[a-zA-Z][a-zA-Z0-9_-]*"}]},{b:"\\b("+n.join("|")+")"+a,rB:!0,c:[{cN:"tag",b:"\\b[a-zA-Z][a-zA-Z0-9_-]*"}]},{cN:"pseudo",b:"&?:?:\\b("+r.join("|")+")"+a},{cN:"at_rule",b:"@("+i.join("|")+")\\b"},e,t.CSSNM,t.NM,{cN:"function",b:"\\b[a-zA-Z][a-zA-Z0-9_-]*\\(.*\\)",i:"[\\n]",rB:!0,c:[{cN:"title",b:"\\b[a-zA-Z][a-zA-Z0-9_-]*"},{cN:"params",b:/\(/,e:/\)/,c:[o,e,t.ASM,t.CSSNM,t.NM,t.QSM]}]},{cN:"attribute",b:"\\b("+l.reverse().join("|")+")\\b"}]}});hljs.registerLanguage("css",function(e){var c="[a-zA-Z-][a-zA-Z0-9_-]*",a={cN:"function",b:c+"\\(",rB:!0,eE:!0,e:"\\("},r={cN:"rule",b:/[A-Z\_\.\-]+\s*:/,rB:!0,e:";",eW:!0,c:[{cN:"attribute",b:/\S/,e:":",eE:!0,starts:{cN:"value",eW:!0,eE:!0,c:[a,e.CSSNM,e.QSM,e.ASM,e.CBCM,{cN:"hexcolor",b:"#[0-9A-Fa-f]+"},{cN:"important",b:"!important"}]}}]};return{cI:!0,i:/[=\/|']/,c:[e.CBCM,r,{cN:"id",b:/\#[A-Za-z0-9_-]+/},{cN:"class",b:/\.[A-Za-z0-9_-]+/,r:0},{cN:"attr_selector",b:/\[/,e:/\]/,i:"$"},{cN:"pseudo",b:/:(:)?[a-zA-Z0-9\_\-\+\(\)"']+/},{cN:"at_rule",b:"@(font-face|page)",l:"[a-z-]+",k:"font-face page"},{cN:"at_rule",b:"@",e:"[{;]",c:[{cN:"keyword",b:/\S+/},{b:/\s/,eW:!0,eE:!0,r:0,c:[a,e.ASM,e.QSM,e.CSSNM]}]},{cN:"tag",b:c,r:0},{cN:"rules",b:"{",e:"}",i:/\S/,r:0,c:[e.CBCM,r]}]}});hljs.registerLanguage("puppet",function(e){var s="augeas computer cron exec file filebucket host interface k5login macauthorization mailalias maillist mcx mount nagios_command nagios_contact nagios_contactgroup nagios_host nagios_hostdependency nagios_hostescalation nagios_hostextinfo nagios_hostgroup nagios_service firewall nagios_servicedependency nagios_serviceescalation nagios_serviceextinfo nagios_servicegroup nagios_timeperiod notify package resources router schedule scheduled_task selboolean selmodule service ssh_authorized_key sshkey stage tidy user vlan yumrepo zfs zone zpool",r="alias audit before loglevel noop require subscribe tag owner ensure group mode name|0 changes context force incl lens load_path onlyif provider returns root show_diff type_check en_address ip_address realname command environment hour monute month monthday special target weekday creates cwd ogoutput refresh refreshonly tries try_sleep umask backup checksum content ctime force ignore links mtime purge recurse recurselimit replace selinux_ignore_defaults selrange selrole seltype seluser source souirce_permissions sourceselect validate_cmd validate_replacement allowdupe attribute_membership auth_membership forcelocal gid ia_load_module members system host_aliases ip allowed_trunk_vlans description device_url duplex encapsulation etherchannel native_vlan speed principals allow_root auth_class auth_type authenticate_user k_of_n mechanisms rule session_owner shared options device fstype enable hasrestart directory present absent link atboot blockdevice device dump pass remounts poller_tag use message withpath adminfile allow_virtual allowcdrom category configfiles flavor install_options instance package_settings platform responsefile status uninstall_options vendor unless_system_user unless_uid binary control flags hasstatus manifest pattern restart running start stop allowdupe auths expiry gid groups home iterations key_membership keys managehome membership password password_max_age password_min_age profile_membership profiles project purge_ssh_keys role_membership roles salt shell uid baseurl cost descr enabled enablegroups exclude failovermethod gpgcheck gpgkey http_caching include includepkgs keepalive metadata_expire metalink mirrorlist priority protect proxy proxy_password proxy_username repo_gpgcheck s3_enabled skip_if_unavailable sslcacert sslclientcert sslclientkey sslverify mounted",a={keyword:"and case class default define else elsif false if in import enherits node or true undef unless main settings $string "+s,literal:r,built_in:"architecture augeasversion blockdevices boardmanufacturer boardproductname boardserialnumber cfkey dhcp_servers domain ec2_ ec2_userdata facterversion filesystems ldom fqdn gid hardwareisa hardwaremodel hostname id|0 interfaces ipaddress ipaddress_ ipaddress6 ipaddress6_ iphostnumber is_virtual kernel kernelmajversion kernelrelease kernelversion kernelrelease kernelversion lsbdistcodename lsbdistdescription lsbdistid lsbdistrelease lsbmajdistrelease lsbminordistrelease lsbrelease macaddress macaddress_ macosx_buildversion macosx_productname macosx_productversion macosx_productverson_major macosx_productversion_minor manufacturer memoryfree memorysize netmask metmask_ network_ operatingsystem operatingsystemmajrelease operatingsystemrelease osfamily partitions path physicalprocessorcount processor processorcount productname ps puppetversion rubysitedir rubyversion selinux selinux_config_mode selinux_config_policy selinux_current_mode selinux_current_mode selinux_enforced selinux_policyversion serialnumber sp_ sshdsakey sshecdsakey sshrsakey swapencrypted swapfree swapsize timezone type uniqueid uptime uptime_days uptime_hours uptime_seconds uuid virtual vlans xendomains zfs_version zonenae zones zpool_version"},i=e.C("#","$"),o={cN:"string",c:[e.BE],v:[{b:/'/,e:/'/},{b:/"/,e:/"/}]},n=[o,i,{cN:"keyword",bK:"class",e:"$|;",i:/=/,c:[e.inherit(e.TM,{b:"(::)?[A-Za-z_]\\w*(::\\w+)*"}),i,o]},{cN:"keyword",b:"([a-zA-Z_(::)]+ *\\{)",c:[o,i],r:0},{cN:"keyword",b:"(\\}|\\{)",r:0},{cN:"function",b:"[a-zA-Z_]+\\s*=>"},{cN:"constant",b:"(::)?(\\b[A-Z][a-z_]*(::)?)+",r:0},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0}];return{aliases:["pp"],k:a,c:n}});hljs.registerLanguage("nimrod",function(t){return{aliases:["nim"],k:{keyword:"addr and as asm bind block break|0 case|0 cast const|0 continue|0 converter discard distinct|10 div do elif else|0 end|0 enum|0 except export finally for from generic if|0 import|0 in include|0 interface is isnot|10 iterator|10 let|0 macro method|10 mixin mod nil not notin|10 object|0 of or out proc|10 ptr raise ref|10 return shl shr static template|10 try|0 tuple type|0 using|0 var|0 when while|0 with without xor yield",literal:"shared guarded stdin stdout stderr result|10 true false"},c:[{cN:"decorator",b:/{\./,e:/\.}/,r:10},{cN:"string",b:/[a-zA-Z]\w*"/,e:/"/,c:[{b:/""/}]},{cN:"string",b:/([a-zA-Z]\w*)?"""/,e:/"""/},t.QSM,{cN:"type",b:/\b[A-Z]\w+\b/,r:0},{cN:"type",b:/\b(int|int8|int16|int32|int64|uint|uint8|uint16|uint32|uint64|float|float32|float64|bool|char|string|cstring|pointer|expr|stmt|void|auto|any|range|array|openarray|varargs|seq|set|clong|culong|cchar|cschar|cshort|cint|csize|clonglong|cfloat|cdouble|clongdouble|cuchar|cushort|cuint|culonglong|cstringarray|semistatic)\b/},{cN:"number",b:/\b(0[xX][0-9a-fA-F][_0-9a-fA-F]*)('?[iIuU](8|16|32|64))?/,r:0},{cN:"number",b:/\b(0o[0-7][_0-7]*)('?[iIuUfF](8|16|32|64))?/,r:0},{cN:"number",b:/\b(0(b|B)[01][_01]*)('?[iIuUfF](8|16|32|64))?/,r:0},{cN:"number",b:/\b(\d[_\d]*)('?[iIuUfF](8|16|32|64))?/,r:0},t.HCM]}});hljs.registerLanguage("smalltalk",function(a){var r="[a-z][a-zA-Z0-9_]*",s={cN:"char",b:"\\$.{1}"},c={cN:"symbol",b:"#"+a.UIR};return{aliases:["st"],k:"self super nil true false thisContext",c:[a.C('"','"'),a.ASM,{cN:"class",b:"\\b[A-Z][A-Za-z0-9_]*",r:0},{cN:"method",b:r+":",r:0},a.CNM,c,s,{cN:"localvars",b:"\\|[ ]*"+r+"([ ]+"+r+")*[ ]*\\|",rB:!0,e:/\|/,i:/\S/,c:[{b:"(\\|[ ]*)?"+r}]},{cN:"array",b:"\\#\\(",e:"\\)",c:[a.ASM,s,a.CNM,c]}]}});hljs.registerLanguage("x86asm",function(s){return{cI:!0,l:"\\.?"+s.IR,k:{keyword:"lock rep repe repz repne repnz xaquire xrelease bnd nobnd aaa aad aam aas adc add and arpl bb0_reset bb1_reset bound bsf bsr bswap bt btc btr bts call cbw cdq cdqe clc cld cli clts cmc cmp cmpsb cmpsd cmpsq cmpsw cmpxchg cmpxchg486 cmpxchg8b cmpxchg16b cpuid cpu_read cpu_write cqo cwd cwde daa das dec div dmint emms enter equ f2xm1 fabs fadd faddp fbld fbstp fchs fclex fcmovb fcmovbe fcmove fcmovnb fcmovnbe fcmovne fcmovnu fcmovu fcom fcomi fcomip fcomp fcompp fcos fdecstp fdisi fdiv fdivp fdivr fdivrp femms feni ffree ffreep fiadd ficom ficomp fidiv fidivr fild fimul fincstp finit fist fistp fisttp fisub fisubr fld fld1 fldcw fldenv fldl2e fldl2t fldlg2 fldln2 fldpi fldz fmul fmulp fnclex fndisi fneni fninit fnop fnsave fnstcw fnstenv fnstsw fpatan fprem fprem1 fptan frndint frstor fsave fscale fsetpm fsin fsincos fsqrt fst fstcw fstenv fstp fstsw fsub fsubp fsubr fsubrp ftst fucom fucomi fucomip fucomp fucompp fxam fxch fxtract fyl2x fyl2xp1 hlt ibts icebp idiv imul in inc incbin insb insd insw int int01 int1 int03 int3 into invd invpcid invlpg invlpga iret iretd iretq iretw jcxz jecxz jrcxz jmp jmpe lahf lar lds lea leave les lfence lfs lgdt lgs lidt lldt lmsw loadall loadall286 lodsb lodsd lodsq lodsw loop loope loopne loopnz loopz lsl lss ltr mfence monitor mov movd movq movsb movsd movsq movsw movsx movsxd movzx mul mwait neg nop not or out outsb outsd outsw packssdw packsswb packuswb paddb paddd paddsb paddsiw paddsw paddusb paddusw paddw pand pandn pause paveb pavgusb pcmpeqb pcmpeqd pcmpeqw pcmpgtb pcmpgtd pcmpgtw pdistib pf2id pfacc pfadd pfcmpeq pfcmpge pfcmpgt pfmax pfmin pfmul pfrcp pfrcpit1 pfrcpit2 pfrsqit1 pfrsqrt pfsub pfsubr pi2fd pmachriw pmaddwd pmagw pmulhriw pmulhrwa pmulhrwc pmulhw pmullw pmvgezb pmvlzb pmvnzb pmvzb pop popa popad popaw popf popfd popfq popfw por prefetch prefetchw pslld psllq psllw psrad psraw psrld psrlq psrlw psubb psubd psubsb psubsiw psubsw psubusb psubusw psubw punpckhbw punpckhdq punpckhwd punpcklbw punpckldq punpcklwd push pusha pushad pushaw pushf pushfd pushfq pushfw pxor rcl rcr rdshr rdmsr rdpmc rdtsc rdtscp ret retf retn rol ror rdm rsdc rsldt rsm rsts sahf sal salc sar sbb scasb scasd scasq scasw sfence sgdt shl shld shr shrd sidt sldt skinit smi smint smintold smsw stc std sti stosb stosd stosq stosw str sub svdc svldt svts swapgs syscall sysenter sysexit sysret test ud0 ud1 ud2b ud2 ud2a umov verr verw fwait wbinvd wrshr wrmsr xadd xbts xchg xlatb xlat xor cmove cmovz cmovne cmovnz cmova cmovnbe cmovae cmovnb cmovb cmovnae cmovbe cmovna cmovg cmovnle cmovge cmovnl cmovl cmovnge cmovle cmovng cmovc cmovnc cmovo cmovno cmovs cmovns cmovp cmovpe cmovnp cmovpo je jz jne jnz ja jnbe jae jnb jb jnae jbe jna jg jnle jge jnl jl jnge jle jng jc jnc jo jno js jns jpo jnp jpe jp sete setz setne setnz seta setnbe setae setnb setnc setb setnae setcset setbe setna setg setnle setge setnl setl setnge setle setng sets setns seto setno setpe setp setpo setnp addps addss andnps andps cmpeqps cmpeqss cmpleps cmpless cmpltps cmpltss cmpneqps cmpneqss cmpnleps cmpnless cmpnltps cmpnltss cmpordps cmpordss cmpunordps cmpunordss cmpps cmpss comiss cvtpi2ps cvtps2pi cvtsi2ss cvtss2si cvttps2pi cvttss2si divps divss ldmxcsr maxps maxss minps minss movaps movhps movlhps movlps movhlps movmskps movntps movss movups mulps mulss orps rcpps rcpss rsqrtps rsqrtss shufps sqrtps sqrtss stmxcsr subps subss ucomiss unpckhps unpcklps xorps fxrstor fxrstor64 fxsave fxsave64 xgetbv xsetbv xsave xsave64 xsaveopt xsaveopt64 xrstor xrstor64 prefetchnta prefetcht0 prefetcht1 prefetcht2 maskmovq movntq pavgb pavgw pextrw pinsrw pmaxsw pmaxub pminsw pminub pmovmskb pmulhuw psadbw pshufw pf2iw pfnacc pfpnacc pi2fw pswapd maskmovdqu clflush movntdq movnti movntpd movdqa movdqu movdq2q movq2dq paddq pmuludq pshufd pshufhw pshuflw pslldq psrldq psubq punpckhqdq punpcklqdq addpd addsd andnpd andpd cmpeqpd cmpeqsd cmplepd cmplesd cmpltpd cmpltsd cmpneqpd cmpneqsd cmpnlepd cmpnlesd cmpnltpd cmpnltsd cmpordpd cmpordsd cmpunordpd cmpunordsd cmppd comisd cvtdq2pd cvtdq2ps cvtpd2dq cvtpd2pi cvtpd2ps cvtpi2pd cvtps2dq cvtps2pd cvtsd2si cvtsd2ss cvtsi2sd cvtss2sd cvttpd2pi cvttpd2dq cvttps2dq cvttsd2si divpd divsd maxpd maxsd minpd minsd movapd movhpd movlpd movmskpd movupd mulpd mulsd orpd shufpd sqrtpd sqrtsd subpd subsd ucomisd unpckhpd unpcklpd xorpd addsubpd addsubps haddpd haddps hsubpd hsubps lddqu movddup movshdup movsldup clgi stgi vmcall vmclear vmfunc vmlaunch vmload vmmcall vmptrld vmptrst vmread vmresume vmrun vmsave vmwrite vmxoff vmxon invept invvpid pabsb pabsw pabsd palignr phaddw phaddd phaddsw phsubw phsubd phsubsw pmaddubsw pmulhrsw pshufb psignb psignw psignd extrq insertq movntsd movntss lzcnt blendpd blendps blendvpd blendvps dppd dpps extractps insertps movntdqa mpsadbw packusdw pblendvb pblendw pcmpeqq pextrb pextrd pextrq phminposuw pinsrb pinsrd pinsrq pmaxsb pmaxsd pmaxud pmaxuw pminsb pminsd pminud pminuw pmovsxbw pmovsxbd pmovsxbq pmovsxwd pmovsxwq pmovsxdq pmovzxbw pmovzxbd pmovzxbq pmovzxwd pmovzxwq pmovzxdq pmuldq pmulld ptest roundpd roundps roundsd roundss crc32 pcmpestri pcmpestrm pcmpistri pcmpistrm pcmpgtq popcnt getsec pfrcpv pfrsqrtv movbe aesenc aesenclast aesdec aesdeclast aesimc aeskeygenassist vaesenc vaesenclast vaesdec vaesdeclast vaesimc vaeskeygenassist vaddpd vaddps vaddsd vaddss vaddsubpd vaddsubps vandpd vandps vandnpd vandnps vblendpd vblendps vblendvpd vblendvps vbroadcastss vbroadcastsd vbroadcastf128 vcmpeq_ospd vcmpeqpd vcmplt_ospd vcmpltpd vcmple_ospd vcmplepd vcmpunord_qpd vcmpunordpd vcmpneq_uqpd vcmpneqpd vcmpnlt_uspd vcmpnltpd vcmpnle_uspd vcmpnlepd vcmpord_qpd vcmpordpd vcmpeq_uqpd vcmpnge_uspd vcmpngepd vcmpngt_uspd vcmpngtpd vcmpfalse_oqpd vcmpfalsepd vcmpneq_oqpd vcmpge_ospd vcmpgepd vcmpgt_ospd vcmpgtpd vcmptrue_uqpd vcmptruepd vcmplt_oqpd vcmple_oqpd vcmpunord_spd vcmpneq_uspd vcmpnlt_uqpd vcmpnle_uqpd vcmpord_spd vcmpeq_uspd vcmpnge_uqpd vcmpngt_uqpd vcmpfalse_ospd vcmpneq_ospd vcmpge_oqpd vcmpgt_oqpd vcmptrue_uspd vcmppd vcmpeq_osps vcmpeqps vcmplt_osps vcmpltps vcmple_osps vcmpleps vcmpunord_qps vcmpunordps vcmpneq_uqps vcmpneqps vcmpnlt_usps vcmpnltps vcmpnle_usps vcmpnleps vcmpord_qps vcmpordps vcmpeq_uqps vcmpnge_usps vcmpngeps vcmpngt_usps vcmpngtps vcmpfalse_oqps vcmpfalseps vcmpneq_oqps vcmpge_osps vcmpgeps vcmpgt_osps vcmpgtps vcmptrue_uqps vcmptrueps vcmplt_oqps vcmple_oqps vcmpunord_sps vcmpneq_usps vcmpnlt_uqps vcmpnle_uqps vcmpord_sps vcmpeq_usps vcmpnge_uqps vcmpngt_uqps vcmpfalse_osps vcmpneq_osps vcmpge_oqps vcmpgt_oqps vcmptrue_usps vcmpps vcmpeq_ossd vcmpeqsd vcmplt_ossd vcmpltsd vcmple_ossd vcmplesd vcmpunord_qsd vcmpunordsd vcmpneq_uqsd vcmpneqsd vcmpnlt_ussd vcmpnltsd vcmpnle_ussd vcmpnlesd vcmpord_qsd vcmpordsd vcmpeq_uqsd vcmpnge_ussd vcmpngesd vcmpngt_ussd vcmpngtsd vcmpfalse_oqsd vcmpfalsesd vcmpneq_oqsd vcmpge_ossd vcmpgesd vcmpgt_ossd vcmpgtsd vcmptrue_uqsd vcmptruesd vcmplt_oqsd vcmple_oqsd vcmpunord_ssd vcmpneq_ussd vcmpnlt_uqsd vcmpnle_uqsd vcmpord_ssd vcmpeq_ussd vcmpnge_uqsd vcmpngt_uqsd vcmpfalse_ossd vcmpneq_ossd vcmpge_oqsd vcmpgt_oqsd vcmptrue_ussd vcmpsd vcmpeq_osss vcmpeqss vcmplt_osss vcmpltss vcmple_osss vcmpless vcmpunord_qss vcmpunordss vcmpneq_uqss vcmpneqss vcmpnlt_usss vcmpnltss vcmpnle_usss vcmpnless vcmpord_qss vcmpordss vcmpeq_uqss vcmpnge_usss vcmpngess vcmpngt_usss vcmpngtss vcmpfalse_oqss vcmpfalsess vcmpneq_oqss vcmpge_osss vcmpgess vcmpgt_osss vcmpgtss vcmptrue_uqss vcmptruess vcmplt_oqss vcmple_oqss vcmpunord_sss vcmpneq_usss vcmpnlt_uqss vcmpnle_uqss vcmpord_sss vcmpeq_usss vcmpnge_uqss vcmpngt_uqss vcmpfalse_osss vcmpneq_osss vcmpge_oqss vcmpgt_oqss vcmptrue_usss vcmpss vcomisd vcomiss vcvtdq2pd vcvtdq2ps vcvtpd2dq vcvtpd2ps vcvtps2dq vcvtps2pd vcvtsd2si vcvtsd2ss vcvtsi2sd vcvtsi2ss vcvtss2sd vcvtss2si vcvttpd2dq vcvttps2dq vcvttsd2si vcvttss2si vdivpd vdivps vdivsd vdivss vdppd vdpps vextractf128 vextractps vhaddpd vhaddps vhsubpd vhsubps vinsertf128 vinsertps vlddqu vldqqu vldmxcsr vmaskmovdqu vmaskmovps vmaskmovpd vmaxpd vmaxps vmaxsd vmaxss vminpd vminps vminsd vminss vmovapd vmovaps vmovd vmovq vmovddup vmovdqa vmovqqa vmovdqu vmovqqu vmovhlps vmovhpd vmovhps vmovlhps vmovlpd vmovlps vmovmskpd vmovmskps vmovntdq vmovntqq vmovntdqa vmovntpd vmovntps vmovsd vmovshdup vmovsldup vmovss vmovupd vmovups vmpsadbw vmulpd vmulps vmulsd vmulss vorpd vorps vpabsb vpabsw vpabsd vpacksswb vpackssdw vpackuswb vpackusdw vpaddb vpaddw vpaddd vpaddq vpaddsb vpaddsw vpaddusb vpaddusw vpalignr vpand vpandn vpavgb vpavgw vpblendvb vpblendw vpcmpestri vpcmpestrm vpcmpistri vpcmpistrm vpcmpeqb vpcmpeqw vpcmpeqd vpcmpeqq vpcmpgtb vpcmpgtw vpcmpgtd vpcmpgtq vpermilpd vpermilps vperm2f128 vpextrb vpextrw vpextrd vpextrq vphaddw vphaddd vphaddsw vphminposuw vphsubw vphsubd vphsubsw vpinsrb vpinsrw vpinsrd vpinsrq vpmaddwd vpmaddubsw vpmaxsb vpmaxsw vpmaxsd vpmaxub vpmaxuw vpmaxud vpminsb vpminsw vpminsd vpminub vpminuw vpminud vpmovmskb vpmovsxbw vpmovsxbd vpmovsxbq vpmovsxwd vpmovsxwq vpmovsxdq vpmovzxbw vpmovzxbd vpmovzxbq vpmovzxwd vpmovzxwq vpmovzxdq vpmulhuw vpmulhrsw vpmulhw vpmullw vpmulld vpmuludq vpmuldq vpor vpsadbw vpshufb vpshufd vpshufhw vpshuflw vpsignb vpsignw vpsignd vpslldq vpsrldq vpsllw vpslld vpsllq vpsraw vpsrad vpsrlw vpsrld vpsrlq vptest vpsubb vpsubw vpsubd vpsubq vpsubsb vpsubsw vpsubusb vpsubusw vpunpckhbw vpunpckhwd vpunpckhdq vpunpckhqdq vpunpcklbw vpunpcklwd vpunpckldq vpunpcklqdq vpxor vrcpps vrcpss vrsqrtps vrsqrtss vroundpd vroundps vroundsd vroundss vshufpd vshufps vsqrtpd vsqrtps vsqrtsd vsqrtss vstmxcsr vsubpd vsubps vsubsd vsubss vtestps vtestpd vucomisd vucomiss vunpckhpd vunpckhps vunpcklpd vunpcklps vxorpd vxorps vzeroall vzeroupper pclmullqlqdq pclmulhqlqdq pclmullqhqdq pclmulhqhqdq pclmulqdq vpclmullqlqdq vpclmulhqlqdq vpclmullqhqdq vpclmulhqhqdq vpclmulqdq vfmadd132ps vfmadd132pd vfmadd312ps vfmadd312pd vfmadd213ps vfmadd213pd vfmadd123ps vfmadd123pd vfmadd231ps vfmadd231pd vfmadd321ps vfmadd321pd vfmaddsub132ps vfmaddsub132pd vfmaddsub312ps vfmaddsub312pd vfmaddsub213ps vfmaddsub213pd vfmaddsub123ps vfmaddsub123pd vfmaddsub231ps vfmaddsub231pd vfmaddsub321ps vfmaddsub321pd vfmsub132ps vfmsub132pd vfmsub312ps vfmsub312pd vfmsub213ps vfmsub213pd vfmsub123ps vfmsub123pd vfmsub231ps vfmsub231pd vfmsub321ps vfmsub321pd vfmsubadd132ps vfmsubadd132pd vfmsubadd312ps vfmsubadd312pd vfmsubadd213ps vfmsubadd213pd vfmsubadd123ps vfmsubadd123pd vfmsubadd231ps vfmsubadd231pd vfmsubadd321ps vfmsubadd321pd vfnmadd132ps vfnmadd132pd vfnmadd312ps vfnmadd312pd vfnmadd213ps vfnmadd213pd vfnmadd123ps vfnmadd123pd vfnmadd231ps vfnmadd231pd vfnmadd321ps vfnmadd321pd vfnmsub132ps vfnmsub132pd vfnmsub312ps vfnmsub312pd vfnmsub213ps vfnmsub213pd vfnmsub123ps vfnmsub123pd vfnmsub231ps vfnmsub231pd vfnmsub321ps vfnmsub321pd vfmadd132ss vfmadd132sd vfmadd312ss vfmadd312sd vfmadd213ss vfmadd213sd vfmadd123ss vfmadd123sd vfmadd231ss vfmadd231sd vfmadd321ss vfmadd321sd vfmsub132ss vfmsub132sd vfmsub312ss vfmsub312sd vfmsub213ss vfmsub213sd vfmsub123ss vfmsub123sd vfmsub231ss vfmsub231sd vfmsub321ss vfmsub321sd vfnmadd132ss vfnmadd132sd vfnmadd312ss vfnmadd312sd vfnmadd213ss vfnmadd213sd vfnmadd123ss vfnmadd123sd vfnmadd231ss vfnmadd231sd vfnmadd321ss vfnmadd321sd vfnmsub132ss vfnmsub132sd vfnmsub312ss vfnmsub312sd vfnmsub213ss vfnmsub213sd vfnmsub123ss vfnmsub123sd vfnmsub231ss vfnmsub231sd vfnmsub321ss vfnmsub321sd rdfsbase rdgsbase rdrand wrfsbase wrgsbase vcvtph2ps vcvtps2ph adcx adox rdseed clac stac xstore xcryptecb xcryptcbc xcryptctr xcryptcfb xcryptofb montmul xsha1 xsha256 llwpcb slwpcb lwpval lwpins vfmaddpd vfmaddps vfmaddsd vfmaddss vfmaddsubpd vfmaddsubps vfmsubaddpd vfmsubaddps vfmsubpd vfmsubps vfmsubsd vfmsubss vfnmaddpd vfnmaddps vfnmaddsd vfnmaddss vfnmsubpd vfnmsubps vfnmsubsd vfnmsubss vfrczpd vfrczps vfrczsd vfrczss vpcmov vpcomb vpcomd vpcomq vpcomub vpcomud vpcomuq vpcomuw vpcomw vphaddbd vphaddbq vphaddbw vphadddq vphaddubd vphaddubq vphaddubw vphaddudq vphadduwd vphadduwq vphaddwd vphaddwq vphsubbw vphsubdq vphsubwd vpmacsdd vpmacsdqh vpmacsdql vpmacssdd vpmacssdqh vpmacssdql vpmacsswd vpmacssww vpmacswd vpmacsww vpmadcsswd vpmadcswd vpperm vprotb vprotd vprotq vprotw vpshab vpshad vpshaq vpshaw vpshlb vpshld vpshlq vpshlw vbroadcasti128 vpblendd vpbroadcastb vpbroadcastw vpbroadcastd vpbroadcastq vpermd vpermpd vpermps vpermq vperm2i128 vextracti128 vinserti128 vpmaskmovd vpmaskmovq vpsllvd vpsllvq vpsravd vpsrlvd vpsrlvq vgatherdpd vgatherqpd vgatherdps vgatherqps vpgatherdd vpgatherqd vpgatherdq vpgatherqq xabort xbegin xend xtest andn bextr blci blcic blsi blsic blcfill blsfill blcmsk blsmsk blsr blcs bzhi mulx pdep pext rorx sarx shlx shrx tzcnt tzmsk t1mskc valignd valignq vblendmpd vblendmps vbroadcastf32x4 vbroadcastf64x4 vbroadcasti32x4 vbroadcasti64x4 vcompresspd vcompressps vcvtpd2udq vcvtps2udq vcvtsd2usi vcvtss2usi vcvttpd2udq vcvttps2udq vcvttsd2usi vcvttss2usi vcvtudq2pd vcvtudq2ps vcvtusi2sd vcvtusi2ss vexpandpd vexpandps vextractf32x4 vextractf64x4 vextracti32x4 vextracti64x4 vfixupimmpd vfixupimmps vfixupimmsd vfixupimmss vgetexppd vgetexpps vgetexpsd vgetexpss vgetmantpd vgetmantps vgetmantsd vgetmantss vinsertf32x4 vinsertf64x4 vinserti32x4 vinserti64x4 vmovdqa32 vmovdqa64 vmovdqu32 vmovdqu64 vpabsq vpandd vpandnd vpandnq vpandq vpblendmd vpblendmq vpcmpltd vpcmpled vpcmpneqd vpcmpnltd vpcmpnled vpcmpd vpcmpltq vpcmpleq vpcmpneqq vpcmpnltq vpcmpnleq vpcmpq vpcmpequd vpcmpltud vpcmpleud vpcmpnequd vpcmpnltud vpcmpnleud vpcmpud vpcmpequq vpcmpltuq vpcmpleuq vpcmpnequq vpcmpnltuq vpcmpnleuq vpcmpuq vpcompressd vpcompressq vpermi2d vpermi2pd vpermi2ps vpermi2q vpermt2d vpermt2pd vpermt2ps vpermt2q vpexpandd vpexpandq vpmaxsq vpmaxuq vpminsq vpminuq vpmovdb vpmovdw vpmovqb vpmovqd vpmovqw vpmovsdb vpmovsdw vpmovsqb vpmovsqd vpmovsqw vpmovusdb vpmovusdw vpmovusqb vpmovusqd vpmovusqw vpord vporq vprold vprolq vprolvd vprolvq vprord vprorq vprorvd vprorvq vpscatterdd vpscatterdq vpscatterqd vpscatterqq vpsraq vpsravq vpternlogd vpternlogq vptestmd vptestmq vptestnmd vptestnmq vpxord vpxorq vrcp14pd vrcp14ps vrcp14sd vrcp14ss vrndscalepd vrndscaleps vrndscalesd vrndscaless vrsqrt14pd vrsqrt14ps vrsqrt14sd vrsqrt14ss vscalefpd vscalefps vscalefsd vscalefss vscatterdpd vscatterdps vscatterqpd vscatterqps vshuff32x4 vshuff64x2 vshufi32x4 vshufi64x2 kandnw kandw kmovw knotw kortestw korw kshiftlw kshiftrw kunpckbw kxnorw kxorw vpbroadcastmb2q vpbroadcastmw2d vpconflictd vpconflictq vplzcntd vplzcntq vexp2pd vexp2ps vrcp28pd vrcp28ps vrcp28sd vrcp28ss vrsqrt28pd vrsqrt28ps vrsqrt28sd vrsqrt28ss vgatherpf0dpd vgatherpf0dps vgatherpf0qpd vgatherpf0qps vgatherpf1dpd vgatherpf1dps vgatherpf1qpd vgatherpf1qps vscatterpf0dpd vscatterpf0dps vscatterpf0qpd vscatterpf0qps vscatterpf1dpd vscatterpf1dps vscatterpf1qpd vscatterpf1qps prefetchwt1 bndmk bndcl bndcu bndcn bndmov bndldx bndstx sha1rnds4 sha1nexte sha1msg1 sha1msg2 sha256rnds2 sha256msg1 sha256msg2 hint_nop0 hint_nop1 hint_nop2 hint_nop3 hint_nop4 hint_nop5 hint_nop6 hint_nop7 hint_nop8 hint_nop9 hint_nop10 hint_nop11 hint_nop12 hint_nop13 hint_nop14 hint_nop15 hint_nop16 hint_nop17 hint_nop18 hint_nop19 hint_nop20 hint_nop21 hint_nop22 hint_nop23 hint_nop24 hint_nop25 hint_nop26 hint_nop27 hint_nop28 hint_nop29 hint_nop30 hint_nop31 hint_nop32 hint_nop33 hint_nop34 hint_nop35 hint_nop36 hint_nop37 hint_nop38 hint_nop39 hint_nop40 hint_nop41 hint_nop42 hint_nop43 hint_nop44 hint_nop45 hint_nop46 hint_nop47 hint_nop48 hint_nop49 hint_nop50 hint_nop51 hint_nop52 hint_nop53 hint_nop54 hint_nop55 hint_nop56 hint_nop57 hint_nop58 hint_nop59 hint_nop60 hint_nop61 hint_nop62 hint_nop63",literal:"ip eip rip al ah bl bh cl ch dl dh sil dil bpl spl r8b r9b r10b r11b r12b r13b r14b r15b ax bx cx dx si di bp sp r8w r9w r10w r11w r12w r13w r14w r15w eax ebx ecx edx esi edi ebp esp eip r8d r9d r10d r11d r12d r13d r14d r15d rax rbx rcx rdx rsi rdi rbp rsp r8 r9 r10 r11 r12 r13 r14 r15 cs ds es fs gs ss st st0 st1 st2 st3 st4 st5 st6 st7 mm0 mm1 mm2 mm3 mm4 mm5 mm6 mm7 xmm0 xmm1 xmm2 xmm3 xmm4 xmm5 xmm6 xmm7 xmm8 xmm9 xmm10 xmm11 xmm12 xmm13 xmm14 xmm15 xmm16 xmm17 xmm18 xmm19 xmm20 xmm21 xmm22 xmm23 xmm24 xmm25 xmm26 xmm27 xmm28 xmm29 xmm30 xmm31 ymm0 ymm1 ymm2 ymm3 ymm4 ymm5 ymm6 ymm7 ymm8 ymm9 ymm10 ymm11 ymm12 ymm13 ymm14 ymm15 ymm16 ymm17 ymm18 ymm19 ymm20 ymm21 ymm22 ymm23 ymm24 ymm25 ymm26 ymm27 ymm28 ymm29 ymm30 ymm31 zmm0 zmm1 zmm2 zmm3 zmm4 zmm5 zmm6 zmm7 zmm8 zmm9 zmm10 zmm11 zmm12 zmm13 zmm14 zmm15 zmm16 zmm17 zmm18 zmm19 zmm20 zmm21 zmm22 zmm23 zmm24 zmm25 zmm26 zmm27 zmm28 zmm29 zmm30 zmm31 k0 k1 k2 k3 k4 k5 k6 k7 bnd0 bnd1 bnd2 bnd3 cr0 cr1 cr2 cr3 cr4 cr8 dr0 dr1 dr2 dr3 dr8 tr3 tr4 tr5 tr6 tr7 r0 r1 r2 r3 r4 r5 r6 r7 r0b r1b r2b r3b r4b r5b r6b r7b r0w r1w r2w r3w r4w r5w r6w r7w r0d r1d r2d r3d r4d r5d r6d r7d r0h r1h r2h r3h r0l r1l r2l r3l r4l r5l r6l r7l r8l r9l r10l r11l r12l r13l r14l r15l",pseudo:"db dw dd dq dt ddq do dy dz resb resw resd resq rest resdq reso resy resz incbin equ times",preprocessor:"%define %xdefine %+ %undef %defstr %deftok %assign %strcat %strlen %substr %rotate %elif %else %endif %ifmacro %ifctx %ifidn %ifidni %ifid %ifnum %ifstr %iftoken %ifempty %ifenv %error %warning %fatal %rep %endrep %include %push %pop %repl %pathsearch %depend %use %arg %stacksize %local %line %comment %endcomment .nolist byte word dword qword nosplit rel abs seg wrt strict near far a32 ptr __FILE__ __LINE__ __SECT__ __BITS__ __OUTPUT_FORMAT__ __DATE__ __TIME__ __DATE_NUM__ __TIME_NUM__ __UTC_DATE__ __UTC_TIME__ __UTC_DATE_NUM__ __UTC_TIME_NUM__ __PASS__ struc endstruc istruc at iend align alignb sectalign daz nodaz up down zero default option assume public ",built_in:"bits use16 use32 use64 default section segment absolute extern global common cpu float __utf16__ __utf16le__ __utf16be__ __utf32__ __utf32le__ __utf32be__ __float8__ __float16__ __float32__ __float64__ __float80m__ __float80e__ __float128l__ __float128h__ __Infinity__ __QNaN__ __SNaN__ Inf NaN QNaN SNaN float8 float16 float32 float64 float80m float80e float128l float128h __FLOAT_DAZ__ __FLOAT_ROUND__ __FLOAT__"},c:[s.C(";","$",{r:0}),{cN:"number",b:"\\b(?:([0-9][0-9_]*)?\\.[0-9_]*(?:[eE][+-]?[0-9_]+)?|(0[Xx])?[0-9][0-9_]*\\.?[0-9_]*(?:[pP](?:[+-]?[0-9_]+)?)?)\\b",r:0},{cN:"number",b:"\\$[0-9][0-9A-Fa-f]*",r:0},{cN:"number",b:"\\b(?:[0-9A-Fa-f][0-9A-Fa-f_]*[HhXx]|[0-9][0-9_]*[DdTt]?|[0-7][0-7_]*[QqOo]|[0-1][0-1_]*[BbYy])\\b"},{cN:"number",b:"\\b(?:0[HhXx][0-9A-Fa-f_]+|0[DdTt][0-9_]+|0[QqOo][0-7_]+|0[BbYy][0-1_]+)\\b"},s.QSM,{cN:"string",b:"'",e:"[^\\\\]'",r:0},{cN:"string",b:"`",e:"[^\\\\]`",r:0},{cN:"string",b:"\\.[A-Za-z0-9]+",r:0},{cN:"label",b:"^\\s*[A-Za-z._?][A-Za-z0-9_$#@~.?]*(:|\\s+label)",r:0},{cN:"label",b:"^\\s*%%[A-Za-z0-9_$#@~.?]*:",r:0},{cN:"argument",b:"%[0-9]+",r:0},{cN:"built_in",b:"%!S+",r:0}]}});hljs.registerLanguage("roboconf",function(e){var n="[a-zA-Z-_][^\n{\r\n]+\\{";return{aliases:["graph","instances"],cI:!0,k:"import",c:[{cN:"facet",b:"^facet "+n,e:"}",k:"facet installer exports children extends",c:[e.HCM]},{cN:"instance-of",b:"^instance of "+n,e:"}",k:"name count channels instance-data instance-state instance of",c:[{cN:"keyword",b:"[a-zA-Z-_]+( | )*:"},e.HCM]},{cN:"component",b:"^"+n,e:"}",l:"\\(?[a-zA-Z]+\\)?",k:"installer exports children extends imports facets alias (optional)",c:[{cN:"string",b:"\\.[a-zA-Z-_]+",e:"\\s|,|;",eE:!0},e.HCM]},e.HCM]}});hljs.registerLanguage("ruby",function(e){var c="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",r="and false then defined module in return redo if BEGIN retry end for true self when next until do begin unless END rescue nil else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",b={cN:"yardoctag",b:"@[A-Za-z]+"},a={cN:"value",b:"#<",e:">"},n=[e.C("#","$",{c:[b]}),e.C("^\\=begin","^\\=end",{c:[b],r:10}),e.C("^__END__","\\n$")],s={cN:"subst",b:"#\\{",e:"}",k:r},t={cN:"string",c:[e.BE,s],v:[{b:/'/,e:/'/},{b:/"/,e:/"/},{b:/`/,e:/`/},{b:"%[qQwWx]?\\(",e:"\\)"},{b:"%[qQwWx]?\\[",e:"\\]"},{b:"%[qQwWx]?{",e:"}"},{b:"%[qQwWx]?<",e:">"},{b:"%[qQwWx]?/",e:"/"},{b:"%[qQwWx]?%",e:"%"},{b:"%[qQwWx]?-",e:"-"},{b:"%[qQwWx]?\\|",e:"\\|"},{b:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/}]},i={cN:"params",b:"\\(",e:"\\)",k:r},d=[t,a,{cN:"class",bK:"class module",e:"$|;",i:/=/,c:[e.inherit(e.TM,{b:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{cN:"inheritance",b:"<\\s*",c:[{cN:"parent",b:"("+e.IR+"::)?"+e.IR}]}].concat(n)},{cN:"function",bK:"def",e:" |$|;",r:0,c:[e.inherit(e.TM,{b:c}),i].concat(n)},{cN:"constant",b:"(::)?(\\b[A-Z]\\w*(::)?)+",r:0},{cN:"symbol",b:e.UIR+"(\\!|\\?)?:",r:0},{cN:"symbol",b:":",c:[t,{b:c}],r:0},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{cN:"variable",b:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{b:"("+e.RSR+")\\s*",c:[a,{cN:"regexp",c:[e.BE,s],i:/\n/,v:[{b:"/",e:"/[a-z]*"},{b:"%r{",e:"}[a-z]*"},{b:"%r\\(",e:"\\)[a-z]*"},{b:"%r!",e:"![a-z]*"},{b:"%r\\[",e:"\\][a-z]*"}]}].concat(n),r:0}].concat(n);s.c=d,i.c=d;var o="[>?]>",l="[\\w#]+\\(\\w+\\):\\d+:\\d+>",u="(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>",N=[{b:/^\s*=>/,cN:"status",starts:{e:"$",c:d}},{cN:"prompt",b:"^("+o+"|"+l+"|"+u+")",starts:{e:"$",c:d}}];return{aliases:["rb","gemspec","podspec","thor","irb"],k:r,c:n.concat(N).concat(d)}});hljs.registerLanguage("typescript",function(e){return{aliases:["ts"],k:{keyword:"in if for while finally var new function|0 do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const class public private get set super interface extendsstatic constructor implements enum export import declare type protected",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document any number boolean string void"},c:[{cN:"pi",b:/^\s*('|")use strict('|")/,r:0},e.ASM,e.QSM,e.CLCM,e.CBCM,e.CNM,{b:"("+e.RSR+"|\\b(case|return|throw)\\b)\\s*",k:"return throw case",c:[e.CLCM,e.CBCM,e.RM,{b:/;/,r:0,sL:"xml"}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:/[A-Za-z$_][0-9A-Za-z$_]*/}),{cN:"params",b:/\(/,e:/\)/,c:[e.CLCM,e.CBCM],i:/["'\(]/}],i:/\[|%/,r:0},{cN:"constructor",bK:"constructor",e:/\{/,eE:!0,r:10},{cN:"module",bK:"module",e:/\{/,eE:!0},{cN:"interface",bK:"interface",e:/\{/,eE:!0},{b:/\$[(.]/},{b:"\\."+e.IR,r:0}]}});hljs.registerLanguage("handlebars",function(e){var a="each in with if else unless bindattr action collection debugger log outlet template unbound view yield";return{aliases:["hbs","html.hbs","html.handlebars"],cI:!0,sL:"xml",subLanguageMode:"continuous",c:[{cN:"expression",b:"{{",e:"}}",c:[{cN:"begin-block",b:"#[a-zA-Z- .]+",k:a},{cN:"string",b:'"',e:'"'},{cN:"end-block",b:"\\/[a-zA-Z- .]+",k:a},{cN:"variable",b:"[a-zA-Z-.]+",k:a}]}]}});hljs.registerLanguage("mercury",function(e){var i={keyword:"module use_module import_module include_module end_module initialise mutable initialize finalize finalise interface implementation pred mode func type inst solver any_pred any_func is semidet det nondet multi erroneous failure cc_nondet cc_multi typeclass instance where pragma promise external trace atomic or_else require_complete_switch require_det require_semidet require_multi require_nondet require_cc_multi require_cc_nondet require_erroneous require_failure",pragma:"inline no_inline type_spec source_file fact_table obsolete memo loop_check minimal_model terminates does_not_terminate check_termination promise_equivalent_clauses",preprocessor:"foreign_proc foreign_decl foreign_code foreign_type foreign_import_module foreign_export_enum foreign_export foreign_enum may_call_mercury will_not_call_mercury thread_safe not_thread_safe maybe_thread_safe promise_pure promise_semipure tabled_for_io local untrailed trailed attach_to_io_state can_pass_as_mercury_type stable will_not_throw_exception may_modify_trail will_not_modify_trail may_duplicate may_not_duplicate affects_liveness does_not_affect_liveness doesnt_affect_liveness no_sharing unknown_sharing sharing",built_in:"some all not if then else true fail false try catch catch_any semidet_true semidet_false semidet_fail impure_true impure semipure"},r={cN:"label",b:"XXX",e:"$",eW:!0,r:0},t=e.inherit(e.CLCM,{b:"%"}),_=e.inherit(e.CBCM,{r:0});t.c.push(r),_.c.push(r);var n={cN:"number",b:"0'.\\|0[box][0-9a-fA-F]*"},a=e.inherit(e.ASM,{r:0}),o=e.inherit(e.QSM,{r:0}),l={cN:"constant",b:"\\\\[abfnrtv]\\|\\\\x[0-9a-fA-F]*\\\\\\|%[-+# *.0-9]*[dioxXucsfeEgGp]",r:0};o.c.push(l);var s={cN:"built_in",v:[{b:"<=>"},{b:"<=",r:0},{b:"=>",r:0},{b:"/\\\\"},{b:"\\\\/"}]},c={cN:"built_in",v:[{b:":-\\|-->"},{b:"=",r:0}]};return{aliases:["m","moo"],k:i,c:[s,c,t,_,n,e.NM,a,o,{b:/:-/}]}});hljs.registerLanguage("fix",function(u){return{c:[{b:/[^\u2401\u0001]+/,e:/[\u2401\u0001]/,eE:!0,rB:!0,rE:!1,c:[{b:/([^\u2401\u0001=]+)/,e:/=([^\u2401\u0001=]+)/,rE:!0,rB:!1,cN:"attribute"},{b:/=/,e:/([\u2401\u0001])/,eE:!0,eB:!0,cN:"string"}]}],cI:!0}});hljs.registerLanguage("clojure",function(e){var t={built_in:"def cond apply if-not if-let if not not= = < > <= >= == + / * - rem quot neg? pos? delay? symbol? keyword? true? false? integer? empty? coll? list? set? ifn? fn? associative? sequential? sorted? counted? reversible? number? decimal? class? distinct? isa? float? rational? reduced? ratio? odd? even? char? seq? vector? string? map? nil? contains? zero? instance? not-every? not-any? libspec? -> ->> .. . inc compare do dotimes mapcat take remove take-while drop letfn drop-last take-last drop-while while intern condp case reduced cycle split-at split-with repeat replicate iterate range merge zipmap declare line-seq sort comparator sort-by dorun doall nthnext nthrest partition eval doseq await await-for let agent atom send send-off release-pending-sends add-watch mapv filterv remove-watch agent-error restart-agent set-error-handler error-handler set-error-mode! error-mode shutdown-agents quote var fn loop recur throw try monitor-enter monitor-exit defmacro defn defn- macroexpand macroexpand-1 for dosync and or when when-not when-let comp juxt partial sequence memoize constantly complement identity assert peek pop doto proxy defstruct first rest cons defprotocol cast coll deftype defrecord last butlast sigs reify second ffirst fnext nfirst nnext defmulti defmethod meta with-meta ns in-ns create-ns import refer keys select-keys vals key val rseq name namespace promise into transient persistent! conj! assoc! dissoc! pop! disj! use class type num float double short byte boolean bigint biginteger bigdec print-method print-dup throw-if printf format load compile get-in update-in pr pr-on newline flush read slurp read-line subvec with-open memfn time re-find re-groups rand-int rand mod locking assert-valid-fdecl alias resolve ref deref refset swap! reset! set-validator! compare-and-set! alter-meta! reset-meta! commute get-validator alter ref-set ref-history-count ref-min-history ref-max-history ensure sync io! new next conj set! to-array future future-call into-array aset gen-class reduce map filter find empty hash-map hash-set sorted-map sorted-map-by sorted-set sorted-set-by vec vector seq flatten reverse assoc dissoc list disj get union difference intersection extend extend-type extend-protocol int nth delay count concat chunk chunk-buffer chunk-append chunk-first chunk-rest max min dec unchecked-inc-int unchecked-inc unchecked-dec-inc unchecked-dec unchecked-negate unchecked-add-int unchecked-add unchecked-subtract-int unchecked-subtract chunk-next chunk-cons chunked-seq? prn vary-meta lazy-seq spread list* str find-keyword keyword symbol gensym force rationalize"},r="a-zA-Z_\\-!.?+*=<>&#'",n="["+r+"]["+r+"0-9/;:]*",a="[-+]?\\d+(\\.\\d+)?",o={b:n,r:0},s={cN:"number",b:a,r:0},i=e.inherit(e.QSM,{i:null}),c=e.C(";","$",{r:0}),d={cN:"literal",b:/\b(true|false|nil)\b/},l={cN:"collection",b:"[\\[\\{]",e:"[\\]\\}]"},m={cN:"comment",b:"\\^"+n},p=e.C("\\^\\{","\\}"),u={cN:"attribute",b:"[:]"+n},f={cN:"list",b:"\\(",e:"\\)"},h={eW:!0,r:0},y={k:t,l:n,cN:"keyword",b:n,starts:h},b=[f,i,m,p,c,u,l,s,d,o];return f.c=[e.C("comment",""),y,h],h.c=b,l.c=b,{aliases:["clj"],i:/\S/,c:[f,i,m,p,c,u,l,s,d]}});hljs.registerLanguage("perl",function(e){var t="getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qqfileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmgetsub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedirioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when",r={cN:"subst",b:"[$@]\\{",e:"\\}",k:t},s={b:"->{",e:"}"},n={cN:"variable",v:[{b:/\$\d/},{b:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{b:/[\$%@][^\s\w{]/,r:0}]},i=e.C("^(__END__|__DATA__)","\\n$",{r:5}),o=[e.BE,r,n],a=[n,e.HCM,i,e.C("^\\=\\w","\\=cut",{eW:!0}),s,{cN:"string",c:o,v:[{b:"q[qwxr]?\\s*\\(",e:"\\)",r:5},{b:"q[qwxr]?\\s*\\[",e:"\\]",r:5},{b:"q[qwxr]?\\s*\\{",e:"\\}",r:5},{b:"q[qwxr]?\\s*\\|",e:"\\|",r:5},{b:"q[qwxr]?\\s*\\<",e:"\\>",r:5},{b:"qw\\s+q",e:"q",r:5},{b:"'",e:"'",c:[e.BE]},{b:'"',e:'"'},{b:"`",e:"`",c:[e.BE]},{b:"{\\w+}",c:[],r:0},{b:"-?\\w+\\s*\\=\\>",c:[],r:0}]},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{b:"(\\/\\/|"+e.RSR+"|\\b(split|return|print|reverse|grep)\\b)\\s*",k:"split return print reverse grep",r:0,c:[e.HCM,i,{cN:"regexp",b:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",r:10},{cN:"regexp",b:"(m|qr)?/",e:"/[a-z]*",c:[e.BE],r:0}]},{cN:"sub",bK:"sub",e:"(\\s*\\(.*?\\))?[;{]",r:5},{cN:"operator",b:"-\\w\\b",r:0}];return r.c=a,s.c=a,{aliases:["pl"],k:t,c:a}});hljs.registerLanguage("twig",function(e){var t={cN:"params",b:"\\(",e:"\\)"},a="attribute block constant cycle date dump include max min parent random range source template_from_string",r={cN:"function",bK:a,r:0,c:[t]},c={cN:"filter",b:/\|[A-Za-z_]+:?/,k:"abs batch capitalize convert_encoding date date_modify default escape first format join json_encode keys last length lower merge nl2br number_format raw replace reverse round slice sort split striptags title trim upper url_encode",c:[r]},n="autoescape block do embed extends filter flush for if import include macro sandbox set spaceless use verbatim";return n=n+" "+n.split(" ").map(function(e){return"end"+e}).join(" "),{aliases:["craftcms"],cI:!0,sL:"xml",subLanguageMode:"continuous",c:[e.C(/\{#/,/#}/),{cN:"template_tag",b:/\{%/,e:/%}/,k:n,c:[c,r]},{cN:"variable",b:/\{\{/,e:/}}/,c:[c,r]}]}});hljs.registerLanguage("livecodeserver",function(e){var r={cN:"variable",b:"\\b[gtps][A-Z]+[A-Za-z0-9_\\-]*\\b|\\$_[A-Z]+",r:0},t=[e.CBCM,e.HCM,e.C("--","$"),e.C("[^:]//","$")],a=e.inherit(e.TM,{v:[{b:"\\b_*rig[A-Z]+[A-Za-z0-9_\\-]*"},{b:"\\b_[a-z0-9\\-]+"}]}),o=e.inherit(e.TM,{b:"\\b([A-Za-z0-9_\\-]+)\\b"});return{cI:!1,k:{keyword:"$_COOKIE $_FILES $_GET $_GET_BINARY $_GET_RAW $_POST $_POST_BINARY $_POST_RAW $_SESSION $_SERVER codepoint codepoints segment segments codeunit codeunits sentence sentences trueWord trueWords paragraph after byte bytes english the until http forever descending using line real8 with seventh for stdout finally element word words fourth before black ninth sixth characters chars stderr uInt1 uInt1s uInt2 uInt2s stdin string lines relative rel any fifth items from middle mid at else of catch then third it file milliseconds seconds second secs sec int1 int1s int4 int4s internet int2 int2s normal text item last long detailed effective uInt4 uInt4s repeat end repeat URL in try into switch to words https token binfile each tenth as ticks tick system real4 by dateItems without char character ascending eighth whole dateTime numeric short first ftp integer abbreviated abbr abbrev private case while if",constant:"SIX TEN FORMFEED NINE ZERO NONE SPACE FOUR FALSE COLON CRLF PI COMMA ENDOFFILE EOF EIGHT FIVE QUOTE EMPTY ONE TRUE RETURN CR LINEFEED RIGHT BACKSLASH NULL SEVEN TAB THREE TWO six ten formfeed nine zero none space four false colon crlf pi comma endoffile eof eight five quote empty one true return cr linefeed right backslash null seven tab three two RIVERSION RISTATE FILE_READ_MODE FILE_WRITE_MODE FILE_WRITE_MODE DIR_WRITE_MODE FILE_READ_UMASK FILE_WRITE_UMASK DIR_READ_UMASK DIR_WRITE_UMASK",operator:"div mod wrap and or bitAnd bitNot bitOr bitXor among not in a an within contains ends with begins the keys of keys",built_in:"put abs acos aliasReference annuity arrayDecode arrayEncode asin atan atan2 average avg avgDev base64Decode base64Encode baseConvert binaryDecode binaryEncode byteOffset byteToNum cachedURL cachedURLs charToNum cipherNames codepointOffset codepointProperty codepointToNum codeunitOffset commandNames compound compress constantNames cos date dateFormat decompress directories diskSpace DNSServers exp exp1 exp2 exp10 extents files flushEvents folders format functionNames geometricMean global globals hasMemory harmonicMean hostAddress hostAddressToName hostName hostNameToAddress isNumber ISOToMac itemOffset keys len length libURLErrorData libUrlFormData libURLftpCommand libURLLastHTTPHeaders libURLLastRHHeaders libUrlMultipartFormAddPart libUrlMultipartFormData libURLVersion lineOffset ln ln1 localNames log log2 log10 longFilePath lower macToISO matchChunk matchText matrixMultiply max md5Digest median merge millisec millisecs millisecond milliseconds min monthNames nativeCharToNum normalizeText num number numToByte numToChar numToCodepoint numToNativeChar offset open openfiles openProcesses openProcessIDs openSockets paragraphOffset paramCount param params peerAddress pendingMessages platform popStdDev populationStandardDeviation populationVariance popVariance processID random randomBytes replaceText result revCreateXMLTree revCreateXMLTreeFromFile revCurrentRecord revCurrentRecordIsFirst revCurrentRecordIsLast revDatabaseColumnCount revDatabaseColumnIsNull revDatabaseColumnLengths revDatabaseColumnNames revDatabaseColumnNamed revDatabaseColumnNumbered revDatabaseColumnTypes revDatabaseConnectResult revDatabaseCursors revDatabaseID revDatabaseTableNames revDatabaseType revDataFromQuery revdb_closeCursor revdb_columnbynumber revdb_columncount revdb_columnisnull revdb_columnlengths revdb_columnnames revdb_columntypes revdb_commit revdb_connect revdb_connections revdb_connectionerr revdb_currentrecord revdb_cursorconnection revdb_cursorerr revdb_cursors revdb_dbtype revdb_disconnect revdb_execute revdb_iseof revdb_isbof revdb_movefirst revdb_movelast revdb_movenext revdb_moveprev revdb_query revdb_querylist revdb_recordcount revdb_rollback revdb_tablenames revGetDatabaseDriverPath revNumberOfRecords revOpenDatabase revOpenDatabases revQueryDatabase revQueryDatabaseBlob revQueryResult revQueryIsAtStart revQueryIsAtEnd revUnixFromMacPath revXMLAttribute revXMLAttributes revXMLAttributeValues revXMLChildContents revXMLChildNames revXMLCreateTreeFromFileWithNamespaces revXMLCreateTreeWithNamespaces revXMLDataFromXPathQuery revXMLEvaluateXPath revXMLFirstChild revXMLMatchingNode revXMLNextSibling revXMLNodeContents revXMLNumberOfChildren revXMLParent revXMLPreviousSibling revXMLRootNode revXMLRPC_CreateRequest revXMLRPC_Documents revXMLRPC_Error revXMLRPC_GetHost revXMLRPC_GetMethod revXMLRPC_GetParam revXMLText revXMLRPC_Execute revXMLRPC_GetParamCount revXMLRPC_GetParamNode revXMLRPC_GetParamType revXMLRPC_GetPath revXMLRPC_GetPort revXMLRPC_GetProtocol revXMLRPC_GetRequest revXMLRPC_GetResponse revXMLRPC_GetSocket revXMLTree revXMLTrees revXMLValidateDTD revZipDescribeItem revZipEnumerateItems revZipOpenArchives round sampVariance sec secs seconds sentenceOffset sha1Digest shell shortFilePath sin specialFolderPath sqrt standardDeviation statRound stdDev sum sysError systemVersion tan tempName textDecode textEncode tick ticks time to tokenOffset toLower toUpper transpose truewordOffset trunc uniDecode uniEncode upper URLDecode URLEncode URLStatus uuid value variableNames variance version waitDepth weekdayNames wordOffset xsltApplyStylesheet xsltApplyStylesheetFromFile xsltLoadStylesheet xsltLoadStylesheetFromFile add breakpoint cancel clear local variable file word line folder directory URL close socket process combine constant convert create new alias folder directory decrypt delete variable word line folder directory URL dispatch divide do encrypt filter get include intersect kill libURLDownloadToFile libURLFollowHttpRedirects libURLftpUpload libURLftpUploadFile libURLresetAll libUrlSetAuthCallback libURLSetCustomHTTPHeaders libUrlSetExpect100 libURLSetFTPListCommand libURLSetFTPMode libURLSetFTPStopTime libURLSetStatusCallback load multiply socket prepare process post seek rel relative read from process rename replace require resetAll resolve revAddXMLNode revAppendXML revCloseCursor revCloseDatabase revCommitDatabase revCopyFile revCopyFolder revCopyXMLNode revDeleteFolder revDeleteXMLNode revDeleteAllXMLTrees revDeleteXMLTree revExecuteSQL revGoURL revInsertXMLNode revMoveFolder revMoveToFirstRecord revMoveToLastRecord revMoveToNextRecord revMoveToPreviousRecord revMoveToRecord revMoveXMLNode revPutIntoXMLNode revRollBackDatabase revSetDatabaseDriverPath revSetXMLAttribute revXMLRPC_AddParam revXMLRPC_DeleteAllDocuments revXMLAddDTD revXMLRPC_Free revXMLRPC_FreeAll revXMLRPC_DeleteDocument revXMLRPC_DeleteParam revXMLRPC_SetHost revXMLRPC_SetMethod revXMLRPC_SetPort revXMLRPC_SetProtocol revXMLRPC_SetSocket revZipAddItemWithData revZipAddItemWithFile revZipAddUncompressedItemWithData revZipAddUncompressedItemWithFile revZipCancel revZipCloseArchive revZipDeleteItem revZipExtractItemToFile revZipExtractItemToVariable revZipSetProgressCallback revZipRenameItem revZipReplaceItemWithData revZipReplaceItemWithFile revZipOpenArchive send set sort split start stop subtract union unload wait write"},c:[r,{cN:"keyword",b:"\\bend\\sif\\b"},{cN:"function",bK:"function",e:"$",c:[r,o,e.ASM,e.QSM,e.BNM,e.CNM,a]},{cN:"function",bK:"end",e:"$",c:[o,a]},{cN:"command",bK:"command on",e:"$",c:[r,o,e.ASM,e.QSM,e.BNM,e.CNM,a]},{cN:"command",bK:"end",e:"$",c:[o,a]},{cN:"preprocessor",b:"<\\?rev|<\\?lc|<\\?livecode",r:10},{cN:"preprocessor",b:"<\\?"},{cN:"preprocessor",b:"\\?>"},e.ASM,e.QSM,e.BNM,e.CNM,a].concat(t),i:";$|^\\[|^="}});hljs.registerLanguage("step21",function(e){var r="[A-Z_][A-Z0-9_.]*",i="END-ISO-10303-21;",l={literal:"",built_in:"",keyword:"HEADER ENDSEC DATA"},s={cN:"preprocessor",b:"ISO-10303-21;",r:10},t=[e.CLCM,e.CBCM,e.C("/\\*\\*!","\\*/"),e.CNM,e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null}),{cN:"string",b:"'",e:"'"},{cN:"label",v:[{b:"#",e:"\\d+",i:"\\W"}]}];return{aliases:["p21","step","stp"],cI:!0,l:r,k:l,c:[{cN:"preprocessor",b:i,r:10},s].concat(t)}});hljs.registerLanguage("cpp",function(t){var i={keyword:"false int float while private char catch export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const struct for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using true class asm case typeid short reinterpret_cast|10 default double register explicit signed typename try this switch continue wchar_t inline delete alignof char16_t char32_t constexpr decltype noexcept nullptr static_assert thread_local restrict _Bool complex _Complex _Imaginary intmax_t uintmax_t int8_t uint8_t int16_t uint16_t int32_t uint32_t int64_t uint64_t int_least8_t uint_least8_t int_least16_t uint_least16_t int_least32_t uint_least32_t int_least64_t uint_least64_t int_fast8_t uint_fast8_t int_fast16_t uint_fast16_t int_fast32_t uint_fast32_t int_fast64_t uint_fast64_t intptr_t uintptr_t atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong atomic_wchar_t atomic_char16_t atomic_char32_t atomic_intmax_t atomic_uintmax_t atomic_intptr_t atomic_uintptr_t atomic_size_t atomic_ptrdiff_t atomic_int_least8_t atomic_int_least16_t atomic_int_least32_t atomic_int_least64_t atomic_uint_least8_t atomic_uint_least16_t atomic_uint_least32_t atomic_uint_least64_t atomic_int_fast8_t atomic_int_fast16_t atomic_int_fast32_t atomic_int_fast64_t atomic_uint_fast8_t atomic_uint_fast16_t atomic_uint_fast32_t atomic_uint_fast64_t",built_in:"std string cin cout cerr clog stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr abort abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf"};return{aliases:["c","cc","h","c++","h++","hpp"],k:i,i:""]',k:"include",i:"\\n"},t.CLCM]},{b:"\\b(deque|list|queue|stack|vector|map|set|bitset|multiset|multimap|unordered_map|unordered_set|unordered_multiset|unordered_multimap|array)\\s*<",e:">",k:i,c:["self"]},{b:t.IR+"::",k:i},{bK:"new throw return else",r:0},{cN:"function",b:"("+t.IR+"\\s+)+"+t.IR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:i,c:[{b:t.IR+"\\s*\\(",rB:!0,c:[t.TM],r:0},{cN:"params",b:/\(/,e:/\)/,k:i,r:0,c:[t.CBCM]},t.CLCM,t.CBCM]}]}});hljs.registerLanguage("vala",function(e){return{k:{keyword:"char uchar unichar int uint long ulong short ushort int8 int16 int32 int64 uint8 uint16 uint32 uint64 float double bool struct enum string void weak unowned owned async signal static abstract interface override while do for foreach else switch case break default return try catch public private protected internal using new this get set const stdout stdin stderr var",built_in:"DBus GLib CCode Gee Object",literal:"false true null"},c:[{cN:"class",bK:"class interface delegate namespace",e:"{",eE:!0,i:"[^,:\\n\\s\\.]",c:[e.UTM]},e.CLCM,e.CBCM,{cN:"string",b:'"""',e:'"""',r:5},e.ASM,e.QSM,e.CNM,{cN:"preprocessor",b:"^#",e:"$",r:2},{cN:"constant",b:" [A-Z_]+ ",r:0}]}});hljs.registerLanguage("http",function(t){return{aliases:["https"],i:"\\S",c:[{cN:"status",b:"^HTTP/[0-9\\.]+",e:"$",c:[{cN:"number",b:"\\b\\d{3}\\b"}]},{cN:"request",b:"^[A-Z]+ (.*?) HTTP/[0-9\\.]+$",rB:!0,e:"$",c:[{cN:"string",b:" ",e:" ",eB:!0,eE:!0}]},{cN:"attribute",b:"^\\w",e:": ",eE:!0,i:"\\n|\\s|=",starts:{cN:"string",e:"$"}},{b:"\\n\\n",starts:{sL:"",eW:!0}}]}});hljs.registerLanguage("avrasm",function(r){return{cI:!0,l:"\\.?"+r.IR,k:{keyword:"adc add adiw and andi asr bclr bld brbc brbs brcc brcs break breq brge brhc brhs brid brie brlo brlt brmi brne brpl brsh brtc brts brvc brvs bset bst call cbi cbr clc clh cli cln clr cls clt clv clz com cp cpc cpi cpse dec eicall eijmp elpm eor fmul fmuls fmulsu icall ijmp in inc jmp ld ldd ldi lds lpm lsl lsr mov movw mul muls mulsu neg nop or ori out pop push rcall ret reti rjmp rol ror sbc sbr sbrc sbrs sec seh sbi sbci sbic sbis sbiw sei sen ser ses set sev sez sleep spm st std sts sub subi swap tst wdr",built_in:"r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r10 r11 r12 r13 r14 r15 r16 r17 r18 r19 r20 r21 r22 r23 r24 r25 r26 r27 r28 r29 r30 r31 x|0 xh xl y|0 yh yl z|0 zh zl ucsr1c udr1 ucsr1a ucsr1b ubrr1l ubrr1h ucsr0c ubrr0h tccr3c tccr3a tccr3b tcnt3h tcnt3l ocr3ah ocr3al ocr3bh ocr3bl ocr3ch ocr3cl icr3h icr3l etimsk etifr tccr1c ocr1ch ocr1cl twcr twdr twar twsr twbr osccal xmcra xmcrb eicra spmcsr spmcr portg ddrg ping portf ddrf sreg sph spl xdiv rampz eicrb eimsk gimsk gicr eifr gifr timsk tifr mcucr mcucsr tccr0 tcnt0 ocr0 assr tccr1a tccr1b tcnt1h tcnt1l ocr1ah ocr1al ocr1bh ocr1bl icr1h icr1l tccr2 tcnt2 ocr2 ocdr wdtcr sfior eearh eearl eedr eecr porta ddra pina portb ddrb pinb portc ddrc pinc portd ddrd pind spdr spsr spcr udr0 ucsr0a ucsr0b ubrr0l acsr admux adcsr adch adcl porte ddre pine pinf",preprocessor:".byte .cseg .db .def .device .dseg .dw .endmacro .equ .eseg .exit .include .list .listmac .macro .nolist .org .set"},c:[r.CBCM,r.C(";","$",{r:0}),r.CNM,r.BNM,{cN:"number",b:"\\b(\\$[a-zA-Z0-9]+|0o[0-7]+)"},r.QSM,{cN:"string",b:"'",e:"[^\\\\]'",i:"[^\\\\][^']"},{cN:"label",b:"^[A-Za-z0-9_.$]+:"},{cN:"preprocessor",b:"#",e:"$"},{cN:"localvars",b:"@[0-9]+"}]}});hljs.registerLanguage("aspectj",function(e){var t="false synchronized int abstract float private char boolean static null if const for true while long throw strictfp finally protected import native final return void enum else extends implements break transient new catch instanceof byte super volatile case assert short package default double public try this switch continue throws privileged aspectOf adviceexecution proceed cflowbelow cflow initialization preinitialization staticinitialization withincode target within execution getWithinTypeName handler thisJoinPoint thisJoinPointStaticPart thisEnclosingJoinPointStaticPart declare parents warning error soft precedence thisAspectInstance",i="get set args call";return{k:t,i:/<\//,c:[{cN:"javadoc",b:"/\\*\\*",e:"\\*/",r:0,c:[{cN:"javadoctag",b:"(^|\\s)@[A-Za-z]+"}]},e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"aspect",bK:"aspect",e:/[{;=]/,eE:!0,i:/[:;"\[\]]/,c:[{bK:"extends implements pertypewithin perthis pertarget percflowbelow percflow issingleton"},e.UTM,{b:/\([^\)]*/,e:/[)]+/,k:t+" "+i,eE:!1}]},{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,r:0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"pointcut after before around throwing returning",e:/[)]/,eE:!1,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",rB:!0,c:[e.UTM]}]},{b:/[:]/,rB:!0,e:/[{;]/,r:0,eE:!1,k:t,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",k:t+" "+i},e.QSM]},{bK:"new throw",r:0},{cN:"function",b:/\w+ +\w+(\.)?\w+\s*\([^\)]*\)\s*((throws)[\w\s,]+)?[\{;]/,rB:!0,e:/[{;=]/,k:t,eE:!0,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,r:0,k:t,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},e.CNM,{cN:"annotation",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("rib",function(e){return{k:"ArchiveRecord AreaLightSource Atmosphere Attribute AttributeBegin AttributeEnd Basis Begin Blobby Bound Clipping ClippingPlane Color ColorSamples ConcatTransform Cone CoordinateSystem CoordSysTransform CropWindow Curves Cylinder DepthOfField Detail DetailRange Disk Displacement Display End ErrorHandler Exposure Exterior Format FrameAspectRatio FrameBegin FrameEnd GeneralPolygon GeometricApproximation Geometry Hider Hyperboloid Identity Illuminate Imager Interior LightSource MakeCubeFaceEnvironment MakeLatLongEnvironment MakeShadow MakeTexture Matte MotionBegin MotionEnd NuPatch ObjectBegin ObjectEnd ObjectInstance Opacity Option Orientation Paraboloid Patch PatchMesh Perspective PixelFilter PixelSamples PixelVariance Points PointsGeneralPolygons PointsPolygons Polygon Procedural Projection Quantize ReadArchive RelativeDetail ReverseOrientation Rotate Scale ScreenWindow ShadingInterpolation ShadingRate Shutter Sides Skew SolidBegin SolidEnd Sphere SubdivisionMesh Surface TextureCoordinates Torus Transform TransformBegin TransformEnd TransformPoints Translate TrimCurve WorldBegin WorldEnd",i:">>|\.\.\.) /},b={cN:"string",c:[e.BE],v:[{b:/(u|b)?r?'''/,e:/'''/,c:[r],r:10},{b:/(u|b)?r?"""/,e:/"""/,c:[r],r:10},{b:/(u|r|ur)'/,e:/'/,r:10},{b:/(u|r|ur)"/,e:/"/,r:10},{b:/(b|br)'/,e:/'/},{b:/(b|br)"/,e:/"/},e.ASM,e.QSM]},l={cN:"number",r:0,v:[{b:e.BNR+"[lLjJ]?"},{b:"\\b(0o[0-7]+)[lLjJ]?"},{b:e.CNR+"[lLjJ]?"}]},c={cN:"params",b:/\(/,e:/\)/,c:["self",r,l,b]};return{aliases:["py","gyp"],k:{keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda nonlocal|10 None True False",built_in:"Ellipsis NotImplemented"},i:/(<\/|->|\?)/,c:[r,l,b,e.HCM,{v:[{cN:"function",bK:"def",r:10},{cN:"class",bK:"class"}],e:/:/,i:/[${=;\n,]/,c:[e.UTM,c]},{cN:"decorator",b:/@/,e:/$/},{b:/\b(print|exec)\(/}]}});hljs.registerLanguage("axapta",function(e){return{k:"false int abstract private char boolean static null if for true while long throw finally protected final return void enum else break new catch byte super case short default double public try this switch continue reverse firstfast firstonly forupdate nofetch sum avg minof maxof count order group by asc desc index hint like dispaly edit client server ttsbegin ttscommit str real date container anytype common div mod",c:[e.CLCM,e.CBCM,e.ASM,e.QSM,e.CNM,{cN:"preprocessor",b:"#",e:"$"},{cN:"class",bK:"class interface",e:"{",eE:!0,i:":",c:[{bK:"extends implements"},e.UTM]}]}});hljs.registerLanguage("nix",function(e){var t={keyword:"rec with let in inherit assert if else then",constant:"true false or and null",built_in:"import abort baseNameOf dirOf isNull builtins map removeAttrs throw toString derivation"},i={cN:"subst",b:/\$\{/,e:/}/,k:t},r={cN:"variable",b:/[a-zA-Z0-9-_]+(\s*=)/},n={cN:"string",b:"''",e:"''",c:[i]},s={cN:"string",b:'"',e:'"',c:[i]},a=[e.NM,e.HCM,e.CBCM,n,s,r];return i.c=a,{aliases:["nixos"],k:t,c:a}});hljs.registerLanguage("diff",function(e){return{aliases:["patch"],c:[{cN:"chunk",r:10,v:[{b:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{b:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{b:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{cN:"header",v:[{b:/Index: /,e:/$/},{b:/=====/,e:/=====$/},{b:/^\-\-\-/,e:/$/},{b:/^\*{3} /,e:/$/},{b:/^\+\+\+/,e:/$/},{b:/\*{5}/,e:/\*{5}$/}]},{cN:"addition",b:"^\\+",e:"$"},{cN:"deletion",b:"^\\-",e:"$"},{cN:"change",b:"^\\!",e:"$"}]}});hljs.registerLanguage("parser3",function(r){var e=r.C("{","}",{c:["self"]});return{sL:"xml",r:0,c:[r.C("^#","$"),r.C("\\^rem{","}",{r:10,c:[e]}),{cN:"preprocessor",b:"^@(?:BASE|USE|CLASS|OPTIONS)$",r:10},{cN:"title",b:"@[\\w\\-]+\\[[\\w^;\\-]*\\](?:\\[[\\w^;\\-]*\\])?(?:.*)$"},{cN:"variable",b:"\\$\\{?[\\w\\-\\.\\:]+\\}?"},{cN:"keyword",b:"\\^[\\w\\-\\.\\:]+"},{cN:"number",b:"\\^#[0-9a-fA-F]+"},r.CNM]}});hljs.registerLanguage("django",function(e){var t={cN:"filter",b:/\|[A-Za-z]+:?/,k:"truncatewords removetags linebreaksbr yesno get_digit timesince random striptags filesizeformat escape linebreaks length_is ljust rjust cut urlize fix_ampersands title floatformat capfirst pprint divisibleby add make_list unordered_list urlencode timeuntil urlizetrunc wordcount stringformat linenumbers slice date dictsort dictsortreversed default_if_none pluralize lower join center default truncatewords_html upper length phone2numeric wordwrap time addslashes slugify first escapejs force_escape iriencode last safe safeseq truncatechars localize unlocalize localtime utc timezone",c:[{cN:"argument",b:/"/,e:/"/},{cN:"argument",b:/'/,e:/'/}]};return{aliases:["jinja"],cI:!0,sL:"xml",subLanguageMode:"continuous",c:[e.C(/\{%\s*comment\s*%}/,/\{%\s*endcomment\s*%}/),e.C(/\{#/,/#}/),{cN:"template_tag",b:/\{%/,e:/%}/,k:"comment endcomment load templatetag ifchanged endifchanged if endif firstof for endfor in ifnotequal endifnotequal widthratio extends include spaceless endspaceless regroup by as ifequal endifequal ssi now with cycle url filter endfilter debug block endblock else autoescape endautoescape csrf_token empty elif endwith static trans blocktrans endblocktrans get_static_prefix get_media_prefix plural get_current_language language get_available_languages get_current_language_bidi get_language_info get_language_info_list localize endlocalize localtime endlocaltime timezone endtimezone get_current_timezone verbatim",c:[t]},{cN:"variable",b:/\{\{/,e:/}}/,c:[t]}]}});hljs.registerLanguage("rust",function(e){var t=e.inherit(e.CBCM);return t.c.push("self"),{aliases:["rs"],k:{keyword:"alignof as be box break const continue crate do else enum extern false fn for if impl in let loop match mod mut offsetof once priv proc pub pure ref return self sizeof static struct super trait true type typeof unsafe unsized use virtual while yield int i8 i16 i32 i64 uint u8 u32 u64 float f32 f64 str char bool",built_in:"assert! assert_eq! bitflags! bytes! cfg! col! concat! concat_idents! debug_assert! debug_assert_eq! env! panic! file! format! format_args! include_bin! include_str! line! local_data_key! module_path! option_env! print! println! select! stringify! try! unimplemented! unreachable! vec! write! writeln!"},l:e.IR+"!?",i:""}]}});hljs.registerLanguage("vhdl",function(e){var t="\\d(_|\\d)*",r="[eE][-+]?"+t,n=t+"(\\."+t+")?("+r+")?",o="\\w+",i=t+"#"+o+"(\\."+o+")?#("+r+")?",a="\\b("+i+"|"+n+")";return{cI:!0,k:{keyword:"abs access after alias all and architecture array assert attribute begin block body buffer bus case component configuration constant context cover disconnect downto default else elsif end entity exit fairness file for force function generate generic group guarded if impure in inertial inout is label library linkage literal loop map mod nand new next nor not null of on open or others out package port postponed procedure process property protected pure range record register reject release rem report restrict restrict_guarantee return rol ror select sequence severity shared signal sla sll sra srl strong subtype then to transport type unaffected units until use variable vmode vprop vunit wait when while with xnor xor",typename:"boolean bit character severity_level integer time delay_length natural positive string bit_vector file_open_kind file_open_status std_ulogic std_ulogic_vector std_logic std_logic_vector unsigned signed boolean_vector integer_vector real_vector time_vector"},i:"{",c:[e.CBCM,e.C("--","$"),e.QSM,{cN:"number",b:a,r:0},{cN:"literal",b:"'(U|X|0|1|Z|W|L|H|-)'",c:[e.BE]},{cN:"attribute",b:"'[A-Za-z](_?[A-Za-z0-9])*",c:[e.BE]}]}});hljs.registerLanguage("ocaml",function(e){return{aliases:["ml"],k:{keyword:"and as assert asr begin class constraint do done downto else end exception external for fun function functor if in include inherit! inherit initializer land lazy let lor lsl lsr lxor match method!|10 method mod module mutable new object of open! open or private rec sig struct then to try type val! val virtual when while with parser value",built_in:"array bool bytes char exn|5 float int int32 int64 list lazy_t|5 nativeint|5 string unit in_channel out_channel ref",literal:"true false"},i:/\/\/|>>/,l:"[a-z_]\\w*!?",c:[{cN:"literal",b:"\\[(\\|\\|)?\\]|\\(\\)"},e.C("\\(\\*","\\*\\)",{c:["self"]}),{cN:"symbol",b:"'[A-Za-z_](?!')[\\w']*"},{cN:"tag",b:"`[A-Z][\\w']*"},{cN:"type",b:"\\b[A-Z][\\w']*",r:0},{b:"[a-z_]\\w*'[\\w']*"},e.inherit(e.ASM,{cN:"char",r:0}),e.inherit(e.QSM,{i:null}),{cN:"number",b:"\\b(0[xX][a-fA-F0-9_]+[Lln]?|0[oO][0-7_]+[Lln]?|0[bB][01_]+[Lln]?|[0-9][0-9_]*([Lln]|(\\.[0-9_]*)?([eE][-+]?[0-9_]+)?)?)",r:0},{b:/[-=]>/}]}});hljs.registerLanguage("cmake",function(e){return{aliases:["cmake.in"],cI:!0,k:{keyword:"add_custom_command add_custom_target add_definitions add_dependencies add_executable add_library add_subdirectory add_test aux_source_directory break build_command cmake_minimum_required cmake_policy configure_file create_test_sourcelist define_property else elseif enable_language enable_testing endforeach endfunction endif endmacro endwhile execute_process export find_file find_library find_package find_path find_program fltk_wrap_ui foreach function get_cmake_property get_directory_property get_filename_component get_property get_source_file_property get_target_property get_test_property if include include_directories include_external_msproject include_regular_expression install link_directories load_cache load_command macro mark_as_advanced message option output_required_files project qt_wrap_cpp qt_wrap_ui remove_definitions return separate_arguments set set_directory_properties set_property set_source_files_properties set_target_properties set_tests_properties site_name source_group string target_link_libraries try_compile try_run unset variable_watch while build_name exec_program export_library_dependencies install_files install_programs install_targets link_libraries make_directory remove subdir_depends subdirs use_mangled_mesa utility_source variable_requires write_file qt5_use_modules qt5_use_package qt5_wrap_cpp on off true false and or",operator:"equal less greater strless strgreater strequal matches"},c:[{cN:"envvar",b:"\\${",e:"}"},e.HCM,e.QSM,e.NM]}});hljs.registerLanguage("1c",function(c){var e="[a-zA-Zа-яА-Я][a-zA-Z0-9_а-яА-Я]*",r="возврат дата для если и или иначе иначеесли исключение конецесли конецпопытки конецпроцедуры конецфункции конеццикла константа не перейти перем перечисление по пока попытка прервать продолжить процедура строка тогда фс функция цикл число экспорт",t="ansitooem oemtoansi ввестивидсубконто ввестидату ввестизначение ввестиперечисление ввестипериод ввестиплансчетов ввестистроку ввестичисло вопрос восстановитьзначение врег выбранныйплансчетов вызватьисключение датагод датамесяц датачисло добавитьмесяц завершитьработусистемы заголовоксистемы записьжурналарегистрации запуститьприложение зафиксироватьтранзакцию значениевстроку значениевстрокувнутр значениевфайл значениеизстроки значениеизстрокивнутр значениеизфайла имякомпьютера имяпользователя каталогвременныхфайлов каталогиб каталогпользователя каталогпрограммы кодсимв командасистемы конгода конецпериодаби конецрассчитанногопериодаби конецстандартногоинтервала конквартала конмесяца коннедели лев лог лог10 макс максимальноеколичествосубконто мин монопольныйрежим названиеинтерфейса названиенабораправ назначитьвид назначитьсчет найти найтипомеченныенаудаление найтиссылки началопериодаби началостандартногоинтервала начатьтранзакцию начгода начквартала начмесяца начнедели номерднягода номерднянедели номернеделигода нрег обработкаожидания окр описаниеошибки основнойжурналрасчетов основнойплансчетов основнойязык открытьформу открытьформумодально отменитьтранзакцию очиститьокносообщений периодстр полноеимяпользователя получитьвремята получитьдатута получитьдокументта получитьзначенияотбора получитьпозициюта получитьпустоезначение получитьта прав праводоступа предупреждение префиксавтонумерации пустаястрока пустоезначение рабочаядаттьпустоезначение рабочаядата разделительстраниц разделительстрок разм разобратьпозициюдокумента рассчитатьрегистрына рассчитатьрегистрыпо сигнал симв символтабуляции создатьобъект сокрл сокрлп сокрп сообщить состояние сохранитьзначение сред статусвозврата стрдлина стрзаменить стрколичествострок стрполучитьстроку стрчисловхождений сформироватьпозициюдокумента счетпокоду текущаядата текущеевремя типзначения типзначениястр удалитьобъекты установитьтана установитьтапо фиксшаблон формат цел шаблон",i={cN:"dquote",b:'""'},n={cN:"string",b:'"',e:'"|$',c:[i]},a={cN:"string",b:"\\|",e:'"|$',c:[i]};return{cI:!0,l:e,k:{keyword:r,built_in:t},c:[c.CLCM,c.NM,n,a,{cN:"function",b:"(процедура|функция)",e:"$",l:e,k:"процедура функция",c:[c.inherit(c.TM,{b:e}),{cN:"tail",eW:!0,c:[{cN:"params",b:"\\(",e:"\\)",l:e,k:"знач",c:[n,a]},{cN:"export",b:"экспорт",eW:!0,l:e,k:"экспорт",c:[c.CLCM]}]},c.CLCM]},{cN:"preprocessor",b:"#",e:"$"},{cN:"date",b:"'\\d{2}\\.\\d{2}\\.(\\d{2}|\\d{4})'"}]}});hljs.registerLanguage("tcl",function(e){return{aliases:["tk"],k:"after append apply array auto_execok auto_import auto_load auto_mkindex auto_mkindex_old auto_qualify auto_reset bgerror binary break catch cd chan clock close concat continue dde dict encoding eof error eval exec exit expr fblocked fconfigure fcopy file fileevent filename flush for foreach format gets glob global history http if incr info interp join lappend|10 lassign|10 lindex|10 linsert|10 list llength|10 load lrange|10 lrepeat|10 lreplace|10 lreverse|10 lsearch|10 lset|10 lsort|10 mathfunc mathop memory msgcat namespace open package parray pid pkg::create pkg_mkIndex platform platform::shell proc puts pwd read refchan regexp registry regsub|10 rename return safe scan seek set socket source split string subst switch tcl_endOfWord tcl_findLibrary tcl_startOfNextWord tcl_startOfPreviousWord tcl_wordBreakAfter tcl_wordBreakBefore tcltest tclvars tell time tm trace unknown unload unset update uplevel upvar variable vwait while",c:[e.C(";[ \\t]*#","$"),e.C("^[ \\t]*#","$"),{bK:"proc",e:"[\\{]",eE:!0,c:[{cN:"symbol",b:"[ \\t\\n\\r]+(::)?[a-zA-Z_]((::)?[a-zA-Z0-9_])*",e:"[ \\t\\n\\r]",eW:!0,eE:!0}]},{cN:"variable",eE:!0,v:[{b:"\\$(\\{)?(::)?[a-zA-Z_]((::)?[a-zA-Z0-9_])*\\(([a-zA-Z0-9_])*\\)",e:"[^a-zA-Z0-9_\\}\\$]"},{b:"\\$(\\{)?(::)?[a-zA-Z_]((::)?[a-zA-Z0-9_])*",e:"(\\))?[^a-zA-Z0-9_\\}\\$]"}]},{cN:"string",c:[e.BE],v:[e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null})]},{cN:"number",v:[e.BNM,e.CNM]}]}});hljs.registerLanguage("groovy",function(e){return{k:{typename:"byte short char int long boolean float double void",literal:"true false null",keyword:"def as in assert trait super this abstract static volatile transient public private protected synchronized final class interface enum if else for while switch case break default continue throw throws try catch finally implements extends new import package return instanceof"},c:[e.CLCM,{cN:"javadoc",b:"/\\*\\*",e:"\\*//*",r:0,c:[{cN:"javadoctag",b:"(^|\\s)@[A-Za-z]+"}]},e.CBCM,{cN:"string",b:'"""',e:'"""'},{cN:"string",b:"'''",e:"'''"},{cN:"string",b:"\\$/",e:"/\\$",r:10},e.ASM,{cN:"regexp",b:/~?\/[^\/\n]+\//,c:[e.BE]},e.QSM,{cN:"shebang",b:"^#!/usr/bin/env",e:"$",i:"\n"},e.BNM,{cN:"class",bK:"class interface trait enum",e:"{",i:":",c:[{bK:"extends implements"},e.UTM]},e.CNM,{cN:"annotation",b:"@[A-Za-z]+"},{cN:"string",b:/[^\?]{0}[A-Za-z0-9_$]+ *:/},{b:/\?/,e:/\:/},{cN:"label",b:"^\\s*[A-Za-z0-9_$]+:",r:0}]}});hljs.registerLanguage("erlang-repl",function(r){return{k:{special_functions:"spawn spawn_link self",reserved:"after and andalso|10 band begin bnot bor bsl bsr bxor case catch cond div end fun if let not of or orelse|10 query receive rem try when xor"},c:[{cN:"prompt",b:"^[0-9]+> ",r:10},r.C("%","$"),{cN:"number",b:"\\b(\\d+#[a-fA-F0-9]+|\\d+(\\.\\d+)?([eE][-+]?\\d+)?)",r:0},r.ASM,r.QSM,{cN:"constant",b:"\\?(::)?([A-Z]\\w*(::)?)+"},{cN:"arrow",b:"->"},{cN:"ok",b:"ok"},{cN:"exclamation_mark",b:"!"},{cN:"function_or_atom",b:"(\\b[a-z'][a-zA-Z0-9_']*:[a-z'][a-zA-Z0-9_']*)|(\\b[a-z'][a-zA-Z0-9_']*)",r:0},{cN:"variable",b:"[A-Z][a-zA-Z0-9_']*",r:0}]}});hljs.registerLanguage("nginx",function(e){var r={cN:"variable",v:[{b:/\$\d+/},{b:/\$\{/,e:/}/},{b:"[\\$\\@]"+e.UIR}]},b={eW:!0,l:"[a-z/_]+",k:{built_in:"on off yes no true false none blocked debug info notice warn error crit select break last permanent redirect kqueue rtsig epoll poll /dev/poll"},r:0,i:"=>",c:[e.HCM,{cN:"string",c:[e.BE,r],v:[{b:/"/,e:/"/},{b:/'/,e:/'/}]},{cN:"url",b:"([a-z]+):/",e:"\\s",eW:!0,eE:!0,c:[r]},{cN:"regexp",c:[e.BE,r],v:[{b:"\\s\\^",e:"\\s|{|;",rE:!0},{b:"~\\*?\\s+",e:"\\s|{|;",rE:!0},{b:"\\*(\\.[a-z\\-]+)+"},{b:"([a-z\\-]+\\.)+\\*"}]},{cN:"number",b:"\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?\\b"},{cN:"number",b:"\\b\\d+[kKmMgGdshdwy]*\\b",r:0},r]};return{aliases:["nginxconf"],c:[e.HCM,{b:e.UIR+"\\s",e:";|{",rB:!0,c:[{cN:"title",b:e.UIR,starts:b}],r:0}],i:"[^\\s\\}]"}});hljs.registerLanguage("mathematica",function(e){return{aliases:["mma"],l:"(\\$|\\b)"+e.IR+"\\b",k:"AbelianGroup Abort AbortKernels AbortProtect Above Abs Absolute AbsoluteCorrelation AbsoluteCorrelationFunction AbsoluteCurrentValue AbsoluteDashing AbsoluteFileName AbsoluteOptions AbsolutePointSize AbsoluteThickness AbsoluteTime AbsoluteTiming AccountingForm Accumulate Accuracy AccuracyGoal ActionDelay ActionMenu ActionMenuBox ActionMenuBoxOptions Active ActiveItem ActiveStyle AcyclicGraphQ AddOnHelpPath AddTo AdjacencyGraph AdjacencyList AdjacencyMatrix AdjustmentBox AdjustmentBoxOptions AdjustTimeSeriesForecast AffineTransform After AiryAi AiryAiPrime AiryAiZero AiryBi AiryBiPrime AiryBiZero AlgebraicIntegerQ AlgebraicNumber AlgebraicNumberDenominator AlgebraicNumberNorm AlgebraicNumberPolynomial AlgebraicNumberTrace AlgebraicRules AlgebraicRulesData Algebraics AlgebraicUnitQ Alignment AlignmentMarker AlignmentPoint All AllowedDimensions AllowGroupClose AllowInlineCells AllowKernelInitialization AllowReverseGroupClose AllowScriptLevelChange AlphaChannel AlternatingGroup AlternativeHypothesis Alternatives AmbientLight Analytic AnchoredSearch And AndersonDarlingTest AngerJ AngleBracket AngularGauge Animate AnimationCycleOffset AnimationCycleRepetitions AnimationDirection AnimationDisplayTime AnimationRate AnimationRepetitions AnimationRunning Animator AnimatorBox AnimatorBoxOptions AnimatorElements Annotation Annuity AnnuityDue Antialiasing Antisymmetric Apart ApartSquareFree Appearance AppearanceElements AppellF1 Append AppendTo Apply ArcCos ArcCosh ArcCot ArcCoth ArcCsc ArcCsch ArcSec ArcSech ArcSin ArcSinDistribution ArcSinh ArcTan ArcTanh Arg ArgMax ArgMin ArgumentCountQ ARIMAProcess ArithmeticGeometricMean ARMAProcess ARProcess Array ArrayComponents ArrayDepth ArrayFlatten ArrayPad ArrayPlot ArrayQ ArrayReshape ArrayRules Arrays Arrow Arrow3DBox ArrowBox Arrowheads AspectRatio AspectRatioFixed Assert Assuming Assumptions AstronomicalData Asynchronous AsynchronousTaskObject AsynchronousTasks AtomQ Attributes AugmentedSymmetricPolynomial AutoAction AutoDelete AutoEvaluateEvents AutoGeneratedPackage AutoIndent AutoIndentSpacings AutoItalicWords AutoloadPath AutoMatch Automatic AutomaticImageSize AutoMultiplicationSymbol AutoNumberFormatting AutoOpenNotebooks AutoOpenPalettes AutorunSequencing AutoScaling AutoScroll AutoSpacing AutoStyleOptions AutoStyleWords Axes AxesEdge AxesLabel AxesOrigin AxesStyle Axis BabyMonsterGroupB Back Background BackgroundTasksSettings Backslash Backsubstitution Backward Band BandpassFilter BandstopFilter BarabasiAlbertGraphDistribution BarChart BarChart3D BarLegend BarlowProschanImportance BarnesG BarOrigin BarSpacing BartlettHannWindow BartlettWindow BaseForm Baseline BaselinePosition BaseStyle BatesDistribution BattleLemarieWavelet Because BeckmannDistribution Beep Before Begin BeginDialogPacket BeginFrontEndInteractionPacket BeginPackage BellB BellY Below BenfordDistribution BeniniDistribution BenktanderGibratDistribution BenktanderWeibullDistribution BernoulliB BernoulliDistribution BernoulliGraphDistribution BernoulliProcess BernsteinBasis BesselFilterModel BesselI BesselJ BesselJZero BesselK BesselY BesselYZero Beta BetaBinomialDistribution BetaDistribution BetaNegativeBinomialDistribution BetaPrimeDistribution BetaRegularized BetweennessCentrality BezierCurve BezierCurve3DBox BezierCurve3DBoxOptions BezierCurveBox BezierCurveBoxOptions BezierFunction BilateralFilter Binarize BinaryFormat BinaryImageQ BinaryRead BinaryReadList BinaryWrite BinCounts BinLists Binomial BinomialDistribution BinomialProcess BinormalDistribution BiorthogonalSplineWavelet BipartiteGraphQ BirnbaumImportance BirnbaumSaundersDistribution BitAnd BitClear BitGet BitLength BitNot BitOr BitSet BitShiftLeft BitShiftRight BitXor Black BlackmanHarrisWindow BlackmanNuttallWindow BlackmanWindow Blank BlankForm BlankNullSequence BlankSequence Blend Block BlockRandom BlomqvistBeta BlomqvistBetaTest Blue Blur BodePlot BohmanWindow Bold Bookmarks Boole BooleanConsecutiveFunction BooleanConvert BooleanCountingFunction BooleanFunction BooleanGraph BooleanMaxterms BooleanMinimize BooleanMinterms Booleans BooleanTable BooleanVariables BorderDimensions BorelTannerDistribution Bottom BottomHatTransform BoundaryStyle Bounds Box BoxBaselineShift BoxData BoxDimensions Boxed Boxes BoxForm BoxFormFormatTypes BoxFrame BoxID BoxMargins BoxMatrix BoxRatios BoxRotation BoxRotationPoint BoxStyle BoxWhiskerChart Bra BracketingBar BraKet BrayCurtisDistance BreadthFirstScan Break Brown BrownForsytheTest BrownianBridgeProcess BrowserCategory BSplineBasis BSplineCurve BSplineCurve3DBox BSplineCurveBox BSplineCurveBoxOptions BSplineFunction BSplineSurface BSplineSurface3DBox BubbleChart BubbleChart3D BubbleScale BubbleSizes BulletGauge BusinessDayQ ButterflyGraph ButterworthFilterModel Button ButtonBar ButtonBox ButtonBoxOptions ButtonCell ButtonContents ButtonData ButtonEvaluator ButtonExpandable ButtonFrame ButtonFunction ButtonMargins ButtonMinHeight ButtonNote ButtonNotebook ButtonSource ButtonStyle ButtonStyleMenuListing Byte ByteCount ByteOrdering C CachedValue CacheGraphics CalendarData CalendarType CallPacket CanberraDistance Cancel CancelButton CandlestickChart Cap CapForm CapitalDifferentialD CardinalBSplineBasis CarmichaelLambda Cases Cashflow Casoratian Catalan CatalanNumber Catch CauchyDistribution CauchyWindow CayleyGraph CDF CDFDeploy CDFInformation CDFWavelet Ceiling Cell CellAutoOverwrite CellBaseline CellBoundingBox CellBracketOptions CellChangeTimes CellContents CellContext CellDingbat CellDynamicExpression CellEditDuplicate CellElementsBoundingBox CellElementSpacings CellEpilog CellEvaluationDuplicate CellEvaluationFunction CellEventActions CellFrame CellFrameColor CellFrameLabelMargins CellFrameLabels CellFrameMargins CellGroup CellGroupData CellGrouping CellGroupingRules CellHorizontalScrolling CellID CellLabel CellLabelAutoDelete CellLabelMargins CellLabelPositioning CellMargins CellObject CellOpen CellPrint CellProlog Cells CellSize CellStyle CellTags CellularAutomaton CensoredDistribution Censoring Center CenterDot CentralMoment CentralMomentGeneratingFunction CForm ChampernowneNumber ChanVeseBinarize Character CharacterEncoding CharacterEncodingsPath CharacteristicFunction CharacteristicPolynomial CharacterRange Characters ChartBaseStyle ChartElementData ChartElementDataFunction ChartElementFunction ChartElements ChartLabels ChartLayout ChartLegends ChartStyle Chebyshev1FilterModel Chebyshev2FilterModel ChebyshevDistance ChebyshevT ChebyshevU Check CheckAbort CheckAll Checkbox CheckboxBar CheckboxBox CheckboxBoxOptions ChemicalData ChessboardDistance ChiDistribution ChineseRemainder ChiSquareDistribution ChoiceButtons ChoiceDialog CholeskyDecomposition Chop Circle CircleBox CircleDot CircleMinus CirclePlus CircleTimes CirculantGraph CityData Clear ClearAll ClearAttributes ClearSystemCache ClebschGordan ClickPane Clip ClipboardNotebook ClipFill ClippingStyle ClipPlanes ClipRange Clock ClockGauge ClockwiseContourIntegral Close Closed CloseKernels ClosenessCentrality Closing ClosingAutoSave ClosingEvent ClusteringComponents CMYKColor Coarse Coefficient CoefficientArrays CoefficientDomain CoefficientList CoefficientRules CoifletWavelet Collect Colon ColonForm ColorCombine ColorConvert ColorData ColorDataFunction ColorFunction ColorFunctionScaling Colorize ColorNegate ColorOutput ColorProfileData ColorQuantize ColorReplace ColorRules ColorSelectorSettings ColorSeparate ColorSetter ColorSetterBox ColorSetterBoxOptions ColorSlider ColorSpace Column ColumnAlignments ColumnBackgrounds ColumnForm ColumnLines ColumnsEqual ColumnSpacings ColumnWidths CommonDefaultFormatTypes Commonest CommonestFilter CommonUnits CommunityBoundaryStyle CommunityGraphPlot CommunityLabels CommunityRegionStyle CompatibleUnitQ CompilationOptions CompilationTarget Compile Compiled CompiledFunction Complement CompleteGraph CompleteGraphQ CompleteKaryTree CompletionsListPacket Complex Complexes ComplexExpand ComplexInfinity ComplexityFunction ComponentMeasurements ComponentwiseContextMenu Compose ComposeList ComposeSeries Composition CompoundExpression CompoundPoissonDistribution CompoundPoissonProcess CompoundRenewalProcess Compress CompressedData Condition ConditionalExpression Conditioned Cone ConeBox ConfidenceLevel ConfidenceRange ConfidenceTransform ConfigurationPath Congruent Conjugate ConjugateTranspose Conjunction Connect ConnectedComponents ConnectedGraphQ ConnesWindow ConoverTest ConsoleMessage ConsoleMessagePacket ConsolePrint Constant ConstantArray Constants ConstrainedMax ConstrainedMin ContentPadding ContentsBoundingBox ContentSelectable ContentSize Context ContextMenu Contexts ContextToFilename ContextToFileName Continuation Continue ContinuedFraction ContinuedFractionK ContinuousAction ContinuousMarkovProcess ContinuousTimeModelQ ContinuousWaveletData ContinuousWaveletTransform ContourDetect ContourGraphics ContourIntegral ContourLabels ContourLines ContourPlot ContourPlot3D Contours ContourShading ContourSmoothing ContourStyle ContraharmonicMean Control ControlActive ControlAlignment ControllabilityGramian ControllabilityMatrix ControllableDecomposition ControllableModelQ ControllerDuration ControllerInformation ControllerInformationData ControllerLinking ControllerManipulate ControllerMethod ControllerPath ControllerState ControlPlacement ControlsRendering ControlType Convergents ConversionOptions ConversionRules ConvertToBitmapPacket ConvertToPostScript ConvertToPostScriptPacket Convolve ConwayGroupCo1 ConwayGroupCo2 ConwayGroupCo3 CoordinateChartData CoordinatesToolOptions CoordinateTransform CoordinateTransformData CoprimeQ Coproduct CopulaDistribution Copyable CopyDirectory CopyFile CopyTag CopyToClipboard CornerFilter CornerNeighbors Correlation CorrelationDistance CorrelationFunction CorrelationTest Cos Cosh CoshIntegral CosineDistance CosineWindow CosIntegral Cot Coth Count CounterAssignments CounterBox CounterBoxOptions CounterClockwiseContourIntegral CounterEvaluator CounterFunction CounterIncrements CounterStyle CounterStyleMenuListing CountRoots CountryData Covariance CovarianceEstimatorFunction CovarianceFunction CoxianDistribution CoxIngersollRossProcess CoxModel CoxModelFit CramerVonMisesTest CreateArchive CreateDialog CreateDirectory CreateDocument CreateIntermediateDirectories CreatePalette CreatePalettePacket CreateScheduledTask CreateTemporary CreateWindow CriticalityFailureImportance CriticalitySuccessImportance CriticalSection Cross CrossingDetect CrossMatrix Csc Csch CubeRoot Cubics Cuboid CuboidBox Cumulant CumulantGeneratingFunction Cup CupCap Curl CurlyDoubleQuote CurlyQuote CurrentImage CurrentlySpeakingPacket CurrentValue CurvatureFlowFilter CurveClosed Cyan CycleGraph CycleIndexPolynomial Cycles CyclicGroup Cyclotomic Cylinder CylinderBox CylindricalDecomposition D DagumDistribution DamerauLevenshteinDistance DampingFactor Darker Dashed Dashing DataCompression DataDistribution DataRange DataReversed Date DateDelimiters DateDifference DateFunction DateList DateListLogPlot DateListPlot DatePattern DatePlus DateRange DateString DateTicksFormat DaubechiesWavelet DavisDistribution DawsonF DayCount DayCountConvention DayMatchQ DayName DayPlus DayRange DayRound DeBruijnGraph Debug DebugTag Decimal DeclareKnownSymbols DeclarePackage Decompose Decrement DedekindEta Default DefaultAxesStyle DefaultBaseStyle DefaultBoxStyle DefaultButton DefaultColor DefaultControlPlacement DefaultDuplicateCellStyle DefaultDuration DefaultElement DefaultFaceGridsStyle DefaultFieldHintStyle DefaultFont DefaultFontProperties DefaultFormatType DefaultFormatTypeForStyle DefaultFrameStyle DefaultFrameTicksStyle DefaultGridLinesStyle DefaultInlineFormatType DefaultInputFormatType DefaultLabelStyle DefaultMenuStyle DefaultNaturalLanguage DefaultNewCellStyle DefaultNewInlineCellStyle DefaultNotebook DefaultOptions DefaultOutputFormatType DefaultStyle DefaultStyleDefinitions DefaultTextFormatType DefaultTextInlineFormatType DefaultTicksStyle DefaultTooltipStyle DefaultValues Defer DefineExternal DefineInputStreamMethod DefineOutputStreamMethod Definition Degree DegreeCentrality DegreeGraphDistribution DegreeLexicographic DegreeReverseLexicographic Deinitialization Del Deletable Delete DeleteBorderComponents DeleteCases DeleteContents DeleteDirectory DeleteDuplicates DeleteFile DeleteSmallComponents DeleteWithContents DeletionWarning Delimiter DelimiterFlashTime DelimiterMatching Delimiters Denominator DensityGraphics DensityHistogram DensityPlot DependentVariables Deploy Deployed Depth DepthFirstScan Derivative DerivativeFilter DescriptorStateSpace DesignMatrix Det DGaussianWavelet DiacriticalPositioning Diagonal DiagonalMatrix Dialog DialogIndent DialogInput DialogLevel DialogNotebook DialogProlog DialogReturn DialogSymbols Diamond DiamondMatrix DiceDissimilarity DictionaryLookup DifferenceDelta DifferenceOrder DifferenceRoot DifferenceRootReduce Differences DifferentialD DifferentialRoot DifferentialRootReduce DifferentiatorFilter DigitBlock DigitBlockMinimum DigitCharacter DigitCount DigitQ DihedralGroup Dilation Dimensions DiracComb DiracDelta DirectedEdge DirectedEdges DirectedGraph DirectedGraphQ DirectedInfinity Direction Directive Directory DirectoryName DirectoryQ DirectoryStack DirichletCharacter DirichletConvolve DirichletDistribution DirichletL DirichletTransform DirichletWindow DisableConsolePrintPacket DiscreteChirpZTransform DiscreteConvolve DiscreteDelta DiscreteHadamardTransform DiscreteIndicator DiscreteLQEstimatorGains DiscreteLQRegulatorGains DiscreteLyapunovSolve DiscreteMarkovProcess DiscretePlot DiscretePlot3D DiscreteRatio DiscreteRiccatiSolve DiscreteShift DiscreteTimeModelQ DiscreteUniformDistribution DiscreteVariables DiscreteWaveletData DiscreteWaveletPacketTransform DiscreteWaveletTransform Discriminant Disjunction Disk DiskBox DiskMatrix Dispatch DispersionEstimatorFunction Display DisplayAllSteps DisplayEndPacket DisplayFlushImagePacket DisplayForm DisplayFunction DisplayPacket DisplayRules DisplaySetSizePacket DisplayString DisplayTemporary DisplayWith DisplayWithRef DisplayWithVariable DistanceFunction DistanceTransform Distribute Distributed DistributedContexts DistributeDefinitions DistributionChart DistributionDomain DistributionFitTest DistributionParameterAssumptions DistributionParameterQ Dithering Div Divergence Divide DivideBy Dividers Divisible Divisors DivisorSigma DivisorSum DMSList DMSString Do DockedCells DocumentNotebook DominantColors DOSTextFormat Dot DotDashed DotEqual Dotted DoubleBracketingBar DoubleContourIntegral DoubleDownArrow DoubleLeftArrow DoubleLeftRightArrow DoubleLeftTee DoubleLongLeftArrow DoubleLongLeftRightArrow DoubleLongRightArrow DoubleRightArrow DoubleRightTee DoubleUpArrow DoubleUpDownArrow DoubleVerticalBar DoublyInfinite Down DownArrow DownArrowBar DownArrowUpArrow DownLeftRightVector DownLeftTeeVector DownLeftVector DownLeftVectorBar DownRightTeeVector DownRightVector DownRightVectorBar Downsample DownTee DownTeeArrow DownValues DragAndDrop DrawEdges DrawFrontFaces DrawHighlighted Drop DSolve Dt DualLinearProgramming DualSystemsModel DumpGet DumpSave DuplicateFreeQ Dynamic DynamicBox DynamicBoxOptions DynamicEvaluationTimeout DynamicLocation DynamicModule DynamicModuleBox DynamicModuleBoxOptions DynamicModuleParent DynamicModuleValues DynamicName DynamicNamespace DynamicReference DynamicSetting DynamicUpdating DynamicWrapper DynamicWrapperBox DynamicWrapperBoxOptions E EccentricityCentrality EdgeAdd EdgeBetweennessCentrality EdgeCapacity EdgeCapForm EdgeColor EdgeConnectivity EdgeCost EdgeCount EdgeCoverQ EdgeDashing EdgeDelete EdgeDetect EdgeForm EdgeIndex EdgeJoinForm EdgeLabeling EdgeLabels EdgeLabelStyle EdgeList EdgeOpacity EdgeQ EdgeRenderingFunction EdgeRules EdgeShapeFunction EdgeStyle EdgeThickness EdgeWeight Editable EditButtonSettings EditCellTagsSettings EditDistance EffectiveInterest Eigensystem Eigenvalues EigenvectorCentrality Eigenvectors Element ElementData Eliminate EliminationOrder EllipticE EllipticExp EllipticExpPrime EllipticF EllipticFilterModel EllipticK EllipticLog EllipticNomeQ EllipticPi EllipticReducedHalfPeriods EllipticTheta EllipticThetaPrime EmitSound EmphasizeSyntaxErrors EmpiricalDistribution Empty EmptyGraphQ EnableConsolePrintPacket Enabled Encode End EndAdd EndDialogPacket EndFrontEndInteractionPacket EndOfFile EndOfLine EndOfString EndPackage EngineeringForm Enter EnterExpressionPacket EnterTextPacket Entropy EntropyFilter Environment Epilog Equal EqualColumns EqualRows EqualTilde EquatedTo Equilibrium EquirippleFilterKernel Equivalent Erf Erfc Erfi ErlangB ErlangC ErlangDistribution Erosion ErrorBox ErrorBoxOptions ErrorNorm ErrorPacket ErrorsDialogSettings EstimatedDistribution EstimatedProcess EstimatorGains EstimatorRegulator EuclideanDistance EulerE EulerGamma EulerianGraphQ EulerPhi Evaluatable Evaluate Evaluated EvaluatePacket EvaluationCell EvaluationCompletionAction EvaluationElements EvaluationMode EvaluationMonitor EvaluationNotebook EvaluationObject EvaluationOrder Evaluator EvaluatorNames EvenQ EventData EventEvaluator EventHandler EventHandlerTag EventLabels ExactBlackmanWindow ExactNumberQ ExactRootIsolation ExampleData Except ExcludedForms ExcludePods Exclusions ExclusionsStyle Exists Exit ExitDialog Exp Expand ExpandAll ExpandDenominator ExpandFileName ExpandNumerator Expectation ExpectationE ExpectedValue ExpGammaDistribution ExpIntegralE ExpIntegralEi Exponent ExponentFunction ExponentialDistribution ExponentialFamily ExponentialGeneratingFunction ExponentialMovingAverage ExponentialPowerDistribution ExponentPosition ExponentStep Export ExportAutoReplacements ExportPacket ExportString Expression ExpressionCell ExpressionPacket ExpToTrig ExtendedGCD Extension ExtentElementFunction ExtentMarkers ExtentSize ExternalCall ExternalDataCharacterEncoding Extract ExtractArchive ExtremeValueDistribution FaceForm FaceGrids FaceGridsStyle Factor FactorComplete Factorial Factorial2 FactorialMoment FactorialMomentGeneratingFunction FactorialPower FactorInteger FactorList FactorSquareFree FactorSquareFreeList FactorTerms FactorTermsList Fail FailureDistribution False FARIMAProcess FEDisableConsolePrintPacket FeedbackSector FeedbackSectorStyle FeedbackType FEEnableConsolePrintPacket Fibonacci FieldHint FieldHintStyle FieldMasked FieldSize File FileBaseName FileByteCount FileDate FileExistsQ FileExtension FileFormat FileHash FileInformation FileName FileNameDepth FileNameDialogSettings FileNameDrop FileNameJoin FileNames FileNameSetter FileNameSplit FileNameTake FilePrint FileType FilledCurve FilledCurveBox Filling FillingStyle FillingTransform FilterRules FinancialBond FinancialData FinancialDerivative FinancialIndicator Find FindArgMax FindArgMin FindClique FindClusters FindCurvePath FindDistributionParameters FindDivisions FindEdgeCover FindEdgeCut FindEulerianCycle FindFaces FindFile FindFit FindGeneratingFunction FindGeoLocation FindGeometricTransform FindGraphCommunities FindGraphIsomorphism FindGraphPartition FindHamiltonianCycle FindIndependentEdgeSet FindIndependentVertexSet FindInstance FindIntegerNullVector FindKClan FindKClique FindKClub FindKPlex FindLibrary FindLinearRecurrence FindList FindMaximum FindMaximumFlow FindMaxValue FindMinimum FindMinimumCostFlow FindMinimumCut FindMinValue FindPermutation FindPostmanTour FindProcessParameters FindRoot FindSequenceFunction FindSettings FindShortestPath FindShortestTour FindThreshold FindVertexCover FindVertexCut Fine FinishDynamic FiniteAbelianGroupCount FiniteGroupCount FiniteGroupData First FirstPassageTimeDistribution FischerGroupFi22 FischerGroupFi23 FischerGroupFi24Prime FisherHypergeometricDistribution FisherRatioTest FisherZDistribution Fit FitAll FittedModel FixedPoint FixedPointList FlashSelection Flat Flatten FlattenAt FlatTopWindow FlipView Floor FlushPrintOutputPacket Fold FoldList Font FontColor FontFamily FontForm FontName FontOpacity FontPostScriptName FontProperties FontReencoding FontSize FontSlant FontSubstitutions FontTracking FontVariations FontWeight For ForAll Format FormatRules FormatType FormatTypeAutoConvert FormatValues FormBox FormBoxOptions FortranForm Forward ForwardBackward Fourier FourierCoefficient FourierCosCoefficient FourierCosSeries FourierCosTransform FourierDCT FourierDCTFilter FourierDCTMatrix FourierDST FourierDSTMatrix FourierMatrix FourierParameters FourierSequenceTransform FourierSeries FourierSinCoefficient FourierSinSeries FourierSinTransform FourierTransform FourierTrigSeries FractionalBrownianMotionProcess FractionalPart FractionBox FractionBoxOptions FractionLine Frame FrameBox FrameBoxOptions Framed FrameInset FrameLabel Frameless FrameMargins FrameStyle FrameTicks FrameTicksStyle FRatioDistribution FrechetDistribution FreeQ FrequencySamplingFilterKernel FresnelC FresnelS Friday FrobeniusNumber FrobeniusSolve FromCharacterCode FromCoefficientRules FromContinuedFraction FromDate FromDigits FromDMS Front FrontEndDynamicExpression FrontEndEventActions FrontEndExecute FrontEndObject FrontEndResource FrontEndResourceString FrontEndStackSize FrontEndToken FrontEndTokenExecute FrontEndValueCache FrontEndVersion FrontFaceColor FrontFaceOpacity Full FullAxes FullDefinition FullForm FullGraphics FullOptions FullSimplify Function FunctionExpand FunctionInterpolation FunctionSpace FussellVeselyImportance GaborFilter GaborMatrix GaborWavelet GainMargins GainPhaseMargins Gamma GammaDistribution GammaRegularized GapPenalty Gather GatherBy GaugeFaceElementFunction GaugeFaceStyle GaugeFrameElementFunction GaugeFrameSize GaugeFrameStyle GaugeLabels GaugeMarkers GaugeStyle GaussianFilter GaussianIntegers GaussianMatrix GaussianWindow GCD GegenbauerC General GeneralizedLinearModelFit GenerateConditions GeneratedCell GeneratedParameters GeneratingFunction Generic GenericCylindricalDecomposition GenomeData GenomeLookup GeodesicClosing GeodesicDilation GeodesicErosion GeodesicOpening GeoDestination GeodesyData GeoDirection GeoDistance GeoGridPosition GeometricBrownianMotionProcess GeometricDistribution GeometricMean GeometricMeanFilter GeometricTransformation GeometricTransformation3DBox GeometricTransformation3DBoxOptions GeometricTransformationBox GeometricTransformationBoxOptions GeoPosition GeoPositionENU GeoPositionXYZ GeoProjectionData GestureHandler GestureHandlerTag Get GetBoundingBoxSizePacket GetContext GetEnvironment GetFileName GetFrontEndOptionsDataPacket GetLinebreakInformationPacket GetMenusPacket GetPageBreakInformationPacket Glaisher GlobalClusteringCoefficient GlobalPreferences GlobalSession Glow GoldenRatio GompertzMakehamDistribution GoodmanKruskalGamma GoodmanKruskalGammaTest Goto Grad Gradient GradientFilter GradientOrientationFilter Graph GraphAssortativity GraphCenter GraphComplement GraphData GraphDensity GraphDiameter GraphDifference GraphDisjointUnion GraphDistance GraphDistanceMatrix GraphElementData GraphEmbedding GraphHighlight GraphHighlightStyle GraphHub Graphics Graphics3D Graphics3DBox Graphics3DBoxOptions GraphicsArray GraphicsBaseline GraphicsBox GraphicsBoxOptions GraphicsColor GraphicsColumn GraphicsComplex GraphicsComplex3DBox GraphicsComplex3DBoxOptions GraphicsComplexBox GraphicsComplexBoxOptions GraphicsContents GraphicsData GraphicsGrid GraphicsGridBox GraphicsGroup GraphicsGroup3DBox GraphicsGroup3DBoxOptions GraphicsGroupBox GraphicsGroupBoxOptions GraphicsGrouping GraphicsHighlightColor GraphicsRow GraphicsSpacing GraphicsStyle GraphIntersection GraphLayout GraphLinkEfficiency GraphPeriphery GraphPlot GraphPlot3D GraphPower GraphPropertyDistribution GraphQ GraphRadius GraphReciprocity GraphRoot GraphStyle GraphUnion Gray GrayLevel GreatCircleDistance Greater GreaterEqual GreaterEqualLess GreaterFullEqual GreaterGreater GreaterLess GreaterSlantEqual GreaterTilde Green Grid GridBaseline GridBox GridBoxAlignment GridBoxBackground GridBoxDividers GridBoxFrame GridBoxItemSize GridBoxItemStyle GridBoxOptions GridBoxSpacings GridCreationSettings GridDefaultElement GridElementStyleOptions GridFrame GridFrameMargins GridGraph GridLines GridLinesStyle GroebnerBasis GroupActionBase GroupCentralizer GroupElementFromWord GroupElementPosition GroupElementQ GroupElements GroupElementToWord GroupGenerators GroupMultiplicationTable GroupOrbits GroupOrder GroupPageBreakWithin GroupSetwiseStabilizer GroupStabilizer GroupStabilizerChain Gudermannian GumbelDistribution HaarWavelet HadamardMatrix HalfNormalDistribution HamiltonianGraphQ HammingDistance HammingWindow HankelH1 HankelH2 HankelMatrix HannPoissonWindow HannWindow HaradaNortonGroupHN HararyGraph HarmonicMean HarmonicMeanFilter HarmonicNumber Hash HashTable Haversine HazardFunction Head HeadCompose Heads HeavisideLambda HeavisidePi HeavisideTheta HeldGroupHe HeldPart HelpBrowserLookup HelpBrowserNotebook HelpBrowserSettings HermiteDecomposition HermiteH HermitianMatrixQ HessenbergDecomposition Hessian HexadecimalCharacter Hexahedron HexahedronBox HexahedronBoxOptions HiddenSurface HighlightGraph HighlightImage HighpassFilter HigmanSimsGroupHS HilbertFilter HilbertMatrix Histogram Histogram3D HistogramDistribution HistogramList HistogramTransform HistogramTransformInterpolation HitMissTransform HITSCentrality HodgeDual HoeffdingD HoeffdingDTest Hold HoldAll HoldAllComplete HoldComplete HoldFirst HoldForm HoldPattern HoldRest HolidayCalendar HomeDirectory HomePage Horizontal HorizontalForm HorizontalGauge HorizontalScrollPosition HornerForm HotellingTSquareDistribution HoytDistribution HTMLSave Hue HumpDownHump HumpEqual HurwitzLerchPhi HurwitzZeta HyperbolicDistribution HypercubeGraph HyperexponentialDistribution Hyperfactorial Hypergeometric0F1 Hypergeometric0F1Regularized Hypergeometric1F1 Hypergeometric1F1Regularized Hypergeometric2F1 Hypergeometric2F1Regularized HypergeometricDistribution HypergeometricPFQ HypergeometricPFQRegularized HypergeometricU Hyperlink HyperlinkCreationSettings Hyphenation HyphenationOptions HypoexponentialDistribution HypothesisTestData I Identity IdentityMatrix If IgnoreCase Im Image Image3D Image3DSlices ImageAccumulate ImageAdd ImageAdjust ImageAlign ImageApply ImageAspectRatio ImageAssemble ImageCache ImageCacheValid ImageCapture ImageChannels ImageClip ImageColorSpace ImageCompose ImageConvolve ImageCooccurrence ImageCorners ImageCorrelate ImageCorrespondingPoints ImageCrop ImageData ImageDataPacket ImageDeconvolve ImageDemosaic ImageDifference ImageDimensions ImageDistance ImageEffect ImageFeatureTrack ImageFileApply ImageFileFilter ImageFileScan ImageFilter ImageForestingComponents ImageForwardTransformation ImageHistogram ImageKeypoints ImageLevels ImageLines ImageMargins ImageMarkers ImageMeasurements ImageMultiply ImageOffset ImagePad ImagePadding ImagePartition ImagePeriodogram ImagePerspectiveTransformation ImageQ ImageRangeCache ImageReflect ImageRegion ImageResize ImageResolution ImageRotate ImageRotated ImageScaled ImageScan ImageSize ImageSizeAction ImageSizeCache ImageSizeMultipliers ImageSizeRaw ImageSubtract ImageTake ImageTransformation ImageTrim ImageType ImageValue ImageValuePositions Implies Import ImportAutoReplacements ImportString ImprovementImportance In IncidenceGraph IncidenceList IncidenceMatrix IncludeConstantBasis IncludeFileExtension IncludePods IncludeSingularTerm Increment Indent IndentingNewlineSpacings IndentMaxFraction IndependenceTest IndependentEdgeSetQ IndependentUnit IndependentVertexSetQ Indeterminate IndexCreationOptions Indexed IndexGraph IndexTag Inequality InexactNumberQ InexactNumbers Infinity Infix Information Inherited InheritScope Initialization InitializationCell InitializationCellEvaluation InitializationCellWarning InlineCounterAssignments InlineCounterIncrements InlineRules Inner Inpaint Input InputAliases InputAssumptions InputAutoReplacements InputField InputFieldBox InputFieldBoxOptions InputForm InputGrouping InputNamePacket InputNotebook InputPacket InputSettings InputStream InputString InputStringPacket InputToBoxFormPacket Insert InsertionPointObject InsertResults Inset Inset3DBox Inset3DBoxOptions InsetBox InsetBoxOptions Install InstallService InString Integer IntegerDigits IntegerExponent IntegerLength IntegerPart IntegerPartitions IntegerQ Integers IntegerString Integral Integrate Interactive InteractiveTradingChart Interlaced Interleaving InternallyBalancedDecomposition InterpolatingFunction InterpolatingPolynomial Interpolation InterpolationOrder InterpolationPoints InterpolationPrecision Interpretation InterpretationBox InterpretationBoxOptions InterpretationFunction InterpretTemplate InterquartileRange Interrupt InterruptSettings Intersection Interval IntervalIntersection IntervalMemberQ IntervalUnion Inverse InverseBetaRegularized InverseCDF InverseChiSquareDistribution InverseContinuousWaveletTransform InverseDistanceTransform InverseEllipticNomeQ InverseErf InverseErfc InverseFourier InverseFourierCosTransform InverseFourierSequenceTransform InverseFourierSinTransform InverseFourierTransform InverseFunction InverseFunctions InverseGammaDistribution InverseGammaRegularized InverseGaussianDistribution InverseGudermannian InverseHaversine InverseJacobiCD InverseJacobiCN InverseJacobiCS InverseJacobiDC InverseJacobiDN InverseJacobiDS InverseJacobiNC InverseJacobiND InverseJacobiNS InverseJacobiSC InverseJacobiSD InverseJacobiSN InverseLaplaceTransform InversePermutation InverseRadon InverseSeries InverseSurvivalFunction InverseWaveletTransform InverseWeierstrassP InverseZTransform Invisible InvisibleApplication InvisibleTimes IrreduciblePolynomialQ IsolatingInterval IsomorphicGraphQ IsotopeData Italic Item ItemBox ItemBoxOptions ItemSize ItemStyle ItoProcess JaccardDissimilarity JacobiAmplitude Jacobian JacobiCD JacobiCN JacobiCS JacobiDC JacobiDN JacobiDS JacobiNC JacobiND JacobiNS JacobiP JacobiSC JacobiSD JacobiSN JacobiSymbol JacobiZeta JankoGroupJ1 JankoGroupJ2 JankoGroupJ3 JankoGroupJ4 JarqueBeraALMTest JohnsonDistribution Join Joined JoinedCurve JoinedCurveBox JoinForm JordanDecomposition JordanModelDecomposition K KagiChart KaiserBesselWindow KaiserWindow KalmanEstimator KalmanFilter KarhunenLoeveDecomposition KaryTree KatzCentrality KCoreComponents KDistribution KelvinBei KelvinBer KelvinKei KelvinKer KendallTau KendallTauTest KernelExecute KernelMixtureDistribution KernelObject Kernels Ket Khinchin KirchhoffGraph KirchhoffMatrix KleinInvariantJ KnightTourGraph KnotData KnownUnitQ KolmogorovSmirnovTest KroneckerDelta KroneckerModelDecomposition KroneckerProduct KroneckerSymbol KuiperTest KumaraswamyDistribution Kurtosis KuwaharaFilter Label Labeled LabeledSlider LabelingFunction LabelStyle LaguerreL LambdaComponents LambertW LanczosWindow LandauDistribution Language LanguageCategory LaplaceDistribution LaplaceTransform Laplacian LaplacianFilter LaplacianGaussianFilter Large Larger Last Latitude LatitudeLongitude LatticeData LatticeReduce Launch LaunchKernels LayeredGraphPlot LayerSizeFunction LayoutInformation LCM LeafCount LeapYearQ LeastSquares LeastSquaresFilterKernel Left LeftArrow LeftArrowBar LeftArrowRightArrow LeftDownTeeVector LeftDownVector LeftDownVectorBar LeftRightArrow LeftRightVector LeftTee LeftTeeArrow LeftTeeVector LeftTriangle LeftTriangleBar LeftTriangleEqual LeftUpDownVector LeftUpTeeVector LeftUpVector LeftUpVectorBar LeftVector LeftVectorBar LegendAppearance Legended LegendFunction LegendLabel LegendLayout LegendMargins LegendMarkers LegendMarkerSize LegendreP LegendreQ LegendreType Length LengthWhile LerchPhi Less LessEqual LessEqualGreater LessFullEqual LessGreater LessLess LessSlantEqual LessTilde LetterCharacter LetterQ Level LeveneTest LeviCivitaTensor LevyDistribution Lexicographic LibraryFunction LibraryFunctionError LibraryFunctionInformation LibraryFunctionLoad LibraryFunctionUnload LibraryLoad LibraryUnload LicenseID LiftingFilterData LiftingWaveletTransform LightBlue LightBrown LightCyan Lighter LightGray LightGreen Lighting LightingAngle LightMagenta LightOrange LightPink LightPurple LightRed LightSources LightYellow Likelihood Limit LimitsPositioning LimitsPositioningTokens LindleyDistribution Line Line3DBox LinearFilter LinearFractionalTransform LinearModelFit LinearOffsetFunction LinearProgramming LinearRecurrence LinearSolve LinearSolveFunction LineBox LineBreak LinebreakAdjustments LineBreakChart LineBreakWithin LineColor LineForm LineGraph LineIndent LineIndentMaxFraction LineIntegralConvolutionPlot LineIntegralConvolutionScale LineLegend LineOpacity LineSpacing LineWrapParts LinkActivate LinkClose LinkConnect LinkConnectedQ LinkCreate LinkError LinkFlush LinkFunction LinkHost LinkInterrupt LinkLaunch LinkMode LinkObject LinkOpen LinkOptions LinkPatterns LinkProtocol LinkRead LinkReadHeld LinkReadyQ Links LinkWrite LinkWriteHeld LiouvilleLambda List Listable ListAnimate ListContourPlot ListContourPlot3D ListConvolve ListCorrelate ListCurvePathPlot ListDeconvolve ListDensityPlot Listen ListFourierSequenceTransform ListInterpolation ListLineIntegralConvolutionPlot ListLinePlot ListLogLinearPlot ListLogLogPlot ListLogPlot ListPicker ListPickerBox ListPickerBoxBackground ListPickerBoxOptions ListPlay ListPlot ListPlot3D ListPointPlot3D ListPolarPlot ListQ ListStreamDensityPlot ListStreamPlot ListSurfacePlot3D ListVectorDensityPlot ListVectorPlot ListVectorPlot3D ListZTransform Literal LiteralSearch LocalClusteringCoefficient LocalizeVariables LocationEquivalenceTest LocationTest Locator LocatorAutoCreate LocatorBox LocatorBoxOptions LocatorCentering LocatorPane LocatorPaneBox LocatorPaneBoxOptions LocatorRegion Locked Log Log10 Log2 LogBarnesG LogGamma LogGammaDistribution LogicalExpand LogIntegral LogisticDistribution LogitModelFit LogLikelihood LogLinearPlot LogLogisticDistribution LogLogPlot LogMultinormalDistribution LogNormalDistribution LogPlot LogRankTest LogSeriesDistribution LongEqual Longest LongestAscendingSequence LongestCommonSequence LongestCommonSequencePositions LongestCommonSubsequence LongestCommonSubsequencePositions LongestMatch LongForm Longitude LongLeftArrow LongLeftRightArrow LongRightArrow Loopback LoopFreeGraphQ LowerCaseQ LowerLeftArrow LowerRightArrow LowerTriangularize LowpassFilter LQEstimatorGains LQGRegulator LQOutputRegulatorGains LQRegulatorGains LUBackSubstitution LucasL LuccioSamiComponents LUDecomposition LyapunovSolve LyonsGroupLy MachineID MachineName MachineNumberQ MachinePrecision MacintoshSystemPageSetup Magenta Magnification Magnify MainSolve MaintainDynamicCaches Majority MakeBoxes MakeExpression MakeRules MangoldtLambda ManhattanDistance Manipulate Manipulator MannWhitneyTest MantissaExponent Manual Map MapAll MapAt MapIndexed MAProcess MapThread MarcumQ MardiaCombinedTest MardiaKurtosisTest MardiaSkewnessTest MarginalDistribution MarkovProcessProperties Masking MatchingDissimilarity MatchLocalNameQ MatchLocalNames MatchQ Material MathematicaNotation MathieuC MathieuCharacteristicA MathieuCharacteristicB MathieuCharacteristicExponent MathieuCPrime MathieuGroupM11 MathieuGroupM12 MathieuGroupM22 MathieuGroupM23 MathieuGroupM24 MathieuS MathieuSPrime MathMLForm MathMLText Matrices MatrixExp MatrixForm MatrixFunction MatrixLog MatrixPlot MatrixPower MatrixQ MatrixRank Max MaxBend MaxDetect MaxExtraBandwidths MaxExtraConditions MaxFeatures MaxFilter Maximize MaxIterations MaxMemoryUsed MaxMixtureKernels MaxPlotPoints MaxPoints MaxRecursion MaxStableDistribution MaxStepFraction MaxSteps MaxStepSize MaxValue MaxwellDistribution McLaughlinGroupMcL Mean MeanClusteringCoefficient MeanDegreeConnectivity MeanDeviation MeanFilter MeanGraphDistance MeanNeighborDegree MeanShift MeanShiftFilter Median MedianDeviation MedianFilter Medium MeijerG MeixnerDistribution MemberQ MemoryConstrained MemoryInUse Menu MenuAppearance MenuCommandKey MenuEvaluator MenuItem MenuPacket MenuSortingValue MenuStyle MenuView MergeDifferences Mesh MeshFunctions MeshRange MeshShading MeshStyle Message MessageDialog MessageList MessageName MessageOptions MessagePacket Messages MessagesNotebook MetaCharacters MetaInformation Method MethodOptions MexicanHatWavelet MeyerWavelet Min MinDetect MinFilter MinimalPolynomial MinimalStateSpaceModel Minimize Minors MinRecursion MinSize MinStableDistribution Minus MinusPlus MinValue Missing MissingDataMethod MittagLefflerE MixedRadix MixedRadixQuantity MixtureDistribution Mod Modal Mode Modular ModularLambda Module Modulus MoebiusMu Moment Momentary MomentConvert MomentEvaluate MomentGeneratingFunction Monday Monitor MonomialList MonomialOrder MonsterGroupM MorletWavelet MorphologicalBinarize MorphologicalBranchPoints MorphologicalComponents MorphologicalEulerNumber MorphologicalGraph MorphologicalPerimeter MorphologicalTransform Most MouseAnnotation MouseAppearance MouseAppearanceTag MouseButtons Mouseover MousePointerNote MousePosition MovingAverage MovingMedian MoyalDistribution MultiedgeStyle MultilaunchWarning MultiLetterItalics MultiLetterStyle MultilineFunction Multinomial MultinomialDistribution MultinormalDistribution MultiplicativeOrder Multiplicity Multiselection MultivariateHypergeometricDistribution MultivariatePoissonDistribution MultivariateTDistribution N NakagamiDistribution NameQ Names NamespaceBox Nand NArgMax NArgMin NBernoulliB NCache NDSolve NDSolveValue Nearest NearestFunction NeedCurrentFrontEndPackagePacket NeedCurrentFrontEndSymbolsPacket NeedlemanWunschSimilarity Needs Negative NegativeBinomialDistribution NegativeMultinomialDistribution NeighborhoodGraph Nest NestedGreaterGreater NestedLessLess NestedScriptRules NestList NestWhile NestWhileList NevilleThetaC NevilleThetaD NevilleThetaN NevilleThetaS NewPrimitiveStyle NExpectation Next NextPrime NHoldAll NHoldFirst NHoldRest NicholsGridLines NicholsPlot NIntegrate NMaximize NMaxValue NMinimize NMinValue NominalVariables NonAssociative NoncentralBetaDistribution NoncentralChiSquareDistribution NoncentralFRatioDistribution NoncentralStudentTDistribution NonCommutativeMultiply NonConstants None NonlinearModelFit NonlocalMeansFilter NonNegative NonPositive Nor NorlundB Norm Normal NormalDistribution NormalGrouping Normalize NormalizedSquaredEuclideanDistance NormalsFunction NormFunction Not NotCongruent NotCupCap NotDoubleVerticalBar Notebook NotebookApply NotebookAutoSave NotebookClose NotebookConvertSettings NotebookCreate NotebookCreateReturnObject NotebookDefault NotebookDelete NotebookDirectory NotebookDynamicExpression NotebookEvaluate NotebookEventActions NotebookFileName NotebookFind NotebookFindReturnObject NotebookGet NotebookGetLayoutInformationPacket NotebookGetMisspellingsPacket NotebookInformation NotebookInterfaceObject NotebookLocate NotebookObject NotebookOpen NotebookOpenReturnObject NotebookPath NotebookPrint NotebookPut NotebookPutReturnObject NotebookRead NotebookResetGeneratedCells Notebooks NotebookSave NotebookSaveAs NotebookSelection NotebookSetupLayoutInformationPacket NotebooksMenu NotebookWrite NotElement NotEqualTilde NotExists NotGreater NotGreaterEqual NotGreaterFullEqual NotGreaterGreater NotGreaterLess NotGreaterSlantEqual NotGreaterTilde NotHumpDownHump NotHumpEqual NotLeftTriangle NotLeftTriangleBar NotLeftTriangleEqual NotLess NotLessEqual NotLessFullEqual NotLessGreater NotLessLess NotLessSlantEqual NotLessTilde NotNestedGreaterGreater NotNestedLessLess NotPrecedes NotPrecedesEqual NotPrecedesSlantEqual NotPrecedesTilde NotReverseElement NotRightTriangle NotRightTriangleBar NotRightTriangleEqual NotSquareSubset NotSquareSubsetEqual NotSquareSuperset NotSquareSupersetEqual NotSubset NotSubsetEqual NotSucceeds NotSucceedsEqual NotSucceedsSlantEqual NotSucceedsTilde NotSuperset NotSupersetEqual NotTilde NotTildeEqual NotTildeFullEqual NotTildeTilde NotVerticalBar NProbability NProduct NProductFactors NRoots NSolve NSum NSumTerms Null NullRecords NullSpace NullWords Number NumberFieldClassNumber NumberFieldDiscriminant NumberFieldFundamentalUnits NumberFieldIntegralBasis NumberFieldNormRepresentatives NumberFieldRegulator NumberFieldRootsOfUnity NumberFieldSignature NumberForm NumberFormat NumberMarks NumberMultiplier NumberPadding NumberPoint NumberQ NumberSeparator NumberSigns NumberString Numerator NumericFunction NumericQ NuttallWindow NValues NyquistGridLines NyquistPlot O ObservabilityGramian ObservabilityMatrix ObservableDecomposition ObservableModelQ OddQ Off Offset OLEData On ONanGroupON OneIdentity Opacity Open OpenAppend Opener OpenerBox OpenerBoxOptions OpenerView OpenFunctionInspectorPacket Opening OpenRead OpenSpecialOptions OpenTemporary OpenWrite Operate OperatingSystem OptimumFlowData Optional OptionInspectorSettings OptionQ Options OptionsPacket OptionsPattern OptionValue OptionValueBox OptionValueBoxOptions Or Orange Order OrderDistribution OrderedQ Ordering Orderless OrnsteinUhlenbeckProcess Orthogonalize Out Outer OutputAutoOverwrite OutputControllabilityMatrix OutputControllableModelQ OutputForm OutputFormData OutputGrouping OutputMathEditExpression OutputNamePacket OutputResponse OutputSizeLimit OutputStream Over OverBar OverDot Overflow OverHat Overlaps Overlay OverlayBox OverlayBoxOptions Overscript OverscriptBox OverscriptBoxOptions OverTilde OverVector OwenT OwnValues PackingMethod PaddedForm Padding PadeApproximant PadLeft PadRight PageBreakAbove PageBreakBelow PageBreakWithin PageFooterLines PageFooters PageHeaderLines PageHeaders PageHeight PageRankCentrality PageWidth PairedBarChart PairedHistogram PairedSmoothHistogram PairedTTest PairedZTest PaletteNotebook PalettePath Pane PaneBox PaneBoxOptions Panel PanelBox PanelBoxOptions Paneled PaneSelector PaneSelectorBox PaneSelectorBoxOptions PaperWidth ParabolicCylinderD ParagraphIndent ParagraphSpacing ParallelArray ParallelCombine ParallelDo ParallelEvaluate Parallelization Parallelize ParallelMap ParallelNeeds ParallelProduct ParallelSubmit ParallelSum ParallelTable ParallelTry Parameter ParameterEstimator ParameterMixtureDistribution ParameterVariables ParametricFunction ParametricNDSolve ParametricNDSolveValue ParametricPlot ParametricPlot3D ParentConnect ParentDirectory ParentForm Parenthesize ParentList ParetoDistribution Part PartialCorrelationFunction PartialD ParticleData Partition PartitionsP PartitionsQ ParzenWindow PascalDistribution PassEventsDown PassEventsUp Paste PasteBoxFormInlineCells PasteButton Path PathGraph PathGraphQ Pattern PatternSequence PatternTest PauliMatrix PaulWavelet Pause PausedTime PDF PearsonChiSquareTest PearsonCorrelationTest PearsonDistribution PerformanceGoal PeriodicInterpolation Periodogram PeriodogramArray PermutationCycles PermutationCyclesQ PermutationGroup PermutationLength PermutationList PermutationListQ PermutationMax PermutationMin PermutationOrder PermutationPower PermutationProduct PermutationReplace Permutations PermutationSupport Permute PeronaMalikFilter Perpendicular PERTDistribution PetersenGraph PhaseMargins Pi Pick PIDData PIDDerivativeFilter PIDFeedforward PIDTune Piecewise PiecewiseExpand PieChart PieChart3D PillaiTrace PillaiTraceTest Pink Pivoting PixelConstrained PixelValue PixelValuePositions Placed Placeholder PlaceholderReplace Plain PlanarGraphQ Play PlayRange Plot Plot3D Plot3Matrix PlotDivision PlotJoined PlotLabel PlotLayout PlotLegends PlotMarkers PlotPoints PlotRange PlotRangeClipping PlotRangePadding PlotRegion PlotStyle Plus PlusMinus Pochhammer PodStates PodWidth Point Point3DBox PointBox PointFigureChart PointForm PointLegend PointSize PoissonConsulDistribution PoissonDistribution PoissonProcess PoissonWindow PolarAxes PolarAxesOrigin PolarGridLines PolarPlot PolarTicks PoleZeroMarkers PolyaAeppliDistribution PolyGamma Polygon Polygon3DBox Polygon3DBoxOptions PolygonBox PolygonBoxOptions PolygonHoleScale PolygonIntersections PolygonScale PolyhedronData PolyLog PolynomialExtendedGCD PolynomialForm PolynomialGCD PolynomialLCM PolynomialMod PolynomialQ PolynomialQuotient PolynomialQuotientRemainder PolynomialReduce PolynomialRemainder Polynomials PopupMenu PopupMenuBox PopupMenuBoxOptions PopupView PopupWindow Position Positive PositiveDefiniteMatrixQ PossibleZeroQ Postfix PostScript Power PowerDistribution PowerExpand PowerMod PowerModList PowerSpectralDensity PowersRepresentations PowerSymmetricPolynomial Precedence PrecedenceForm Precedes PrecedesEqual PrecedesSlantEqual PrecedesTilde Precision PrecisionGoal PreDecrement PredictionRoot PreemptProtect PreferencesPath Prefix PreIncrement Prepend PrependTo PreserveImageOptions Previous PriceGraphDistribution PrimaryPlaceholder Prime PrimeNu PrimeOmega PrimePi PrimePowerQ PrimeQ Primes PrimeZetaP PrimitiveRoot PrincipalComponents PrincipalValue Print PrintAction PrintForm PrintingCopies PrintingOptions PrintingPageRange PrintingStartingPageNumber PrintingStyleEnvironment PrintPrecision PrintTemporary Prism PrismBox PrismBoxOptions PrivateCellOptions PrivateEvaluationOptions PrivateFontOptions PrivateFrontEndOptions PrivateNotebookOptions PrivatePaths Probability ProbabilityDistribution ProbabilityPlot ProbabilityPr ProbabilityScalePlot ProbitModelFit ProcessEstimator ProcessParameterAssumptions ProcessParameterQ ProcessStateDomain ProcessTimeDomain Product ProductDistribution ProductLog ProgressIndicator ProgressIndicatorBox ProgressIndicatorBoxOptions Projection Prolog PromptForm Properties Property PropertyList PropertyValue Proportion Proportional Protect Protected ProteinData Pruning PseudoInverse Purple Put PutAppend Pyramid PyramidBox PyramidBoxOptions QBinomial QFactorial QGamma QHypergeometricPFQ QPochhammer QPolyGamma QRDecomposition QuadraticIrrationalQ Quantile QuantilePlot Quantity QuantityForm QuantityMagnitude QuantityQ QuantityUnit Quartics QuartileDeviation Quartiles QuartileSkewness QueueingNetworkProcess QueueingProcess QueueProperties Quiet Quit Quotient QuotientRemainder RadialityCentrality RadicalBox RadicalBoxOptions RadioButton RadioButtonBar RadioButtonBox RadioButtonBoxOptions Radon RamanujanTau RamanujanTauL RamanujanTauTheta RamanujanTauZ Random RandomChoice RandomComplex RandomFunction RandomGraph RandomImage RandomInteger RandomPermutation RandomPrime RandomReal RandomSample RandomSeed RandomVariate RandomWalkProcess Range RangeFilter RangeSpecification RankedMax RankedMin Raster Raster3D Raster3DBox Raster3DBoxOptions RasterArray RasterBox RasterBoxOptions Rasterize RasterSize Rational RationalFunctions Rationalize Rationals Ratios Raw RawArray RawBoxes RawData RawMedium RayleighDistribution Re Read ReadList ReadProtected Real RealBlockDiagonalForm RealDigits RealExponent Reals Reap Record RecordLists RecordSeparators Rectangle RectangleBox RectangleBoxOptions RectangleChart RectangleChart3D RecurrenceFilter RecurrenceTable RecurringDigitsForm Red Reduce RefBox ReferenceLineStyle ReferenceMarkers ReferenceMarkerStyle Refine ReflectionMatrix ReflectionTransform Refresh RefreshRate RegionBinarize RegionFunction RegionPlot RegionPlot3D RegularExpression Regularization Reinstall Release ReleaseHold ReliabilityDistribution ReliefImage ReliefPlot Remove RemoveAlphaChannel RemoveAsynchronousTask Removed RemoveInputStreamMethod RemoveOutputStreamMethod RemoveProperty RemoveScheduledTask RenameDirectory RenameFile RenderAll RenderingOptions RenewalProcess RenkoChart Repeated RepeatedNull RepeatedString Replace ReplaceAll ReplaceHeldPart ReplaceImageValue ReplaceList ReplacePart ReplacePixelValue ReplaceRepeated Resampling Rescale RescalingTransform ResetDirectory ResetMenusPacket ResetScheduledTask Residue Resolve Rest Resultant ResumePacket Return ReturnExpressionPacket ReturnInputFormPacket ReturnPacket ReturnTextPacket Reverse ReverseBiorthogonalSplineWavelet ReverseElement ReverseEquilibrium ReverseGraph ReverseUpEquilibrium RevolutionAxis RevolutionPlot3D RGBColor RiccatiSolve RiceDistribution RidgeFilter RiemannR RiemannSiegelTheta RiemannSiegelZ Riffle Right RightArrow RightArrowBar RightArrowLeftArrow RightCosetRepresentative RightDownTeeVector RightDownVector RightDownVectorBar RightTee RightTeeArrow RightTeeVector RightTriangle RightTriangleBar RightTriangleEqual RightUpDownVector RightUpTeeVector RightUpVector RightUpVectorBar RightVector RightVectorBar RiskAchievementImportance RiskReductionImportance RogersTanimotoDissimilarity Root RootApproximant RootIntervals RootLocusPlot RootMeanSquare RootOfUnityQ RootReduce Roots RootSum Rotate RotateLabel RotateLeft RotateRight RotationAction RotationBox RotationBoxOptions RotationMatrix RotationTransform Round RoundImplies RoundingRadius Row RowAlignments RowBackgrounds RowBox RowHeights RowLines RowMinHeight RowReduce RowsEqual RowSpacings RSolve RudvalisGroupRu Rule RuleCondition RuleDelayed RuleForm RulerUnits Run RunScheduledTask RunThrough RuntimeAttributes RuntimeOptions RussellRaoDissimilarity SameQ SameTest SampleDepth SampledSoundFunction SampledSoundList SampleRate SamplingPeriod SARIMAProcess SARMAProcess SatisfiabilityCount SatisfiabilityInstances SatisfiableQ Saturday Save Saveable SaveAutoDelete SaveDefinitions SawtoothWave Scale Scaled ScaleDivisions ScaledMousePosition ScaleOrigin ScalePadding ScaleRanges ScaleRangeStyle ScalingFunctions ScalingMatrix ScalingTransform Scan ScheduledTaskActiveQ ScheduledTaskData ScheduledTaskObject ScheduledTasks SchurDecomposition ScientificForm ScreenRectangle ScreenStyleEnvironment ScriptBaselineShifts ScriptLevel ScriptMinSize ScriptRules ScriptSizeMultipliers Scrollbars ScrollingOptions ScrollPosition Sec Sech SechDistribution SectionGrouping SectorChart SectorChart3D SectorOrigin SectorSpacing SeedRandom Select Selectable SelectComponents SelectedCells SelectedNotebook Selection SelectionAnimate SelectionCell SelectionCellCreateCell SelectionCellDefaultStyle SelectionCellParentStyle SelectionCreateCell SelectionDebuggerTag SelectionDuplicateCell SelectionEvaluate SelectionEvaluateCreateCell SelectionMove SelectionPlaceholder SelectionSetStyle SelectWithContents SelfLoops SelfLoopStyle SemialgebraicComponentInstances SendMail Sequence SequenceAlignment SequenceForm SequenceHold SequenceLimit Series SeriesCoefficient SeriesData SessionTime Set SetAccuracy SetAlphaChannel SetAttributes Setbacks SetBoxFormNamesPacket SetDelayed SetDirectory SetEnvironment SetEvaluationNotebook SetFileDate SetFileLoadingContext SetNotebookStatusLine SetOptions SetOptionsPacket SetPrecision SetProperty SetSelectedNotebook SetSharedFunction SetSharedVariable SetSpeechParametersPacket SetStreamPosition SetSystemOptions Setter SetterBar SetterBox SetterBoxOptions Setting SetValue Shading Shallow ShannonWavelet ShapiroWilkTest Share Sharpen ShearingMatrix ShearingTransform ShenCastanMatrix Short ShortDownArrow Shortest ShortestMatch ShortestPathFunction ShortLeftArrow ShortRightArrow ShortUpArrow Show ShowAutoStyles ShowCellBracket ShowCellLabel ShowCellTags ShowClosedCellArea ShowContents ShowControls ShowCursorTracker ShowGroupOpenCloseIcon ShowGroupOpener ShowInvisibleCharacters ShowPageBreaks ShowPredictiveInterface ShowSelection ShowShortBoxForm ShowSpecialCharacters ShowStringCharacters ShowSyntaxStyles ShrinkingDelay ShrinkWrapBoundingBox SiegelTheta SiegelTukeyTest Sign Signature SignedRankTest SignificanceLevel SignPadding SignTest SimilarityRules SimpleGraph SimpleGraphQ Simplify Sin Sinc SinghMaddalaDistribution SingleEvaluation SingleLetterItalics SingleLetterStyle SingularValueDecomposition SingularValueList SingularValuePlot SingularValues Sinh SinhIntegral SinIntegral SixJSymbol Skeleton SkeletonTransform SkellamDistribution Skewness SkewNormalDistribution Skip SliceDistribution Slider Slider2D Slider2DBox Slider2DBoxOptions SliderBox SliderBoxOptions SlideView Slot SlotSequence Small SmallCircle Smaller SmithDelayCompensator SmithWatermanSimilarity SmoothDensityHistogram SmoothHistogram SmoothHistogram3D SmoothKernelDistribution SocialMediaData Socket SokalSneathDissimilarity Solve SolveAlways SolveDelayed Sort SortBy Sound SoundAndGraphics SoundNote SoundVolume Sow Space SpaceForm Spacer Spacings Span SpanAdjustments SpanCharacterRounding SpanFromAbove SpanFromBoth SpanFromLeft SpanLineThickness SpanMaxSize SpanMinSize SpanningCharacters SpanSymmetric SparseArray SpatialGraphDistribution Speak SpeakTextPacket SpearmanRankTest SpearmanRho Spectrogram SpectrogramArray Specularity SpellingCorrection SpellingDictionaries SpellingDictionariesPath SpellingOptions SpellingSuggestionsPacket Sphere SphereBox SphericalBesselJ SphericalBesselY SphericalHankelH1 SphericalHankelH2 SphericalHarmonicY SphericalPlot3D SphericalRegion SpheroidalEigenvalue SpheroidalJoiningFactor SpheroidalPS SpheroidalPSPrime SpheroidalQS SpheroidalQSPrime SpheroidalRadialFactor SpheroidalS1 SpheroidalS1Prime SpheroidalS2 SpheroidalS2Prime Splice SplicedDistribution SplineClosed SplineDegree SplineKnots SplineWeights Split SplitBy SpokenString Sqrt SqrtBox SqrtBoxOptions Square SquaredEuclideanDistance SquareFreeQ SquareIntersection SquaresR SquareSubset SquareSubsetEqual SquareSuperset SquareSupersetEqual SquareUnion SquareWave StabilityMargins StabilityMarginsStyle StableDistribution Stack StackBegin StackComplete StackInhibit StandardDeviation StandardDeviationFilter StandardForm Standardize StandbyDistribution Star StarGraph StartAsynchronousTask StartingStepSize StartOfLine StartOfString StartScheduledTask StartupSound StateDimensions StateFeedbackGains StateOutputEstimator StateResponse StateSpaceModel StateSpaceRealization StateSpaceTransform StationaryDistribution StationaryWaveletPacketTransform StationaryWaveletTransform StatusArea StatusCentrality StepMonitor StieltjesGamma StirlingS1 StirlingS2 StopAsynchronousTask StopScheduledTask StrataVariables StratonovichProcess StreamColorFunction StreamColorFunctionScaling StreamDensityPlot StreamPlot StreamPoints StreamPosition Streams StreamScale StreamStyle String StringBreak StringByteCount StringCases StringCount StringDrop StringExpression StringForm StringFormat StringFreeQ StringInsert StringJoin StringLength StringMatchQ StringPosition StringQ StringReplace StringReplaceList StringReplacePart StringReverse StringRotateLeft StringRotateRight StringSkeleton StringSplit StringTake StringToStream StringTrim StripBoxes StripOnInput StripWrapperBoxes StrokeForm StructuralImportance StructuredArray StructuredSelection StruveH StruveL Stub StudentTDistribution Style StyleBox StyleBoxAutoDelete StyleBoxOptions StyleData StyleDefinitions StyleForm StyleKeyMapping StyleMenuListing StyleNameDialogSettings StyleNames StylePrint StyleSheetPath Subfactorial Subgraph SubMinus SubPlus SubresultantPolynomialRemainders SubresultantPolynomials Subresultants Subscript SubscriptBox SubscriptBoxOptions Subscripted Subset SubsetEqual Subsets SubStar Subsuperscript SubsuperscriptBox SubsuperscriptBoxOptions Subtract SubtractFrom SubValues Succeeds SucceedsEqual SucceedsSlantEqual SucceedsTilde SuchThat Sum SumConvergence Sunday SuperDagger SuperMinus SuperPlus Superscript SuperscriptBox SuperscriptBoxOptions Superset SupersetEqual SuperStar Surd SurdForm SurfaceColor SurfaceGraphics SurvivalDistribution SurvivalFunction SurvivalModel SurvivalModelFit SuspendPacket SuzukiDistribution SuzukiGroupSuz SwatchLegend Switch Symbol SymbolName SymletWavelet Symmetric SymmetricGroup SymmetricMatrixQ SymmetricPolynomial SymmetricReduction Symmetrize SymmetrizedArray SymmetrizedArrayRules SymmetrizedDependentComponents SymmetrizedIndependentComponents SymmetrizedReplacePart SynchronousInitialization SynchronousUpdating Syntax SyntaxForm SyntaxInformation SyntaxLength SyntaxPacket SyntaxQ SystemDialogInput SystemException SystemHelpPath SystemInformation SystemInformationData SystemOpen SystemOptions SystemsModelDelay SystemsModelDelayApproximate SystemsModelDelete SystemsModelDimensions SystemsModelExtract SystemsModelFeedbackConnect SystemsModelLabels SystemsModelOrder SystemsModelParallelConnect SystemsModelSeriesConnect SystemsModelStateFeedbackConnect SystemStub Tab TabFilling Table TableAlignments TableDepth TableDirections TableForm TableHeadings TableSpacing TableView TableViewBox TabSpacings TabView TabViewBox TabViewBoxOptions TagBox TagBoxNote TagBoxOptions TaggingRules TagSet TagSetDelayed TagStyle TagUnset Take TakeWhile Tally Tan Tanh TargetFunctions TargetUnits TautologyQ TelegraphProcess TemplateBox TemplateBoxOptions TemplateSlotSequence TemporalData Temporary TemporaryVariable TensorContract TensorDimensions TensorExpand TensorProduct TensorQ TensorRank TensorReduce TensorSymmetry TensorTranspose TensorWedge Tetrahedron TetrahedronBox TetrahedronBoxOptions TeXForm TeXSave Text Text3DBox Text3DBoxOptions TextAlignment TextBand TextBoundingBox TextBox TextCell TextClipboardType TextData TextForm TextJustification TextLine TextPacket TextParagraph TextRecognize TextRendering TextStyle Texture TextureCoordinateFunction TextureCoordinateScaling Therefore ThermometerGauge Thick Thickness Thin Thinning ThisLink ThompsonGroupTh Thread ThreeJSymbol Threshold Through Throw Thumbnail Thursday Ticks TicksStyle Tilde TildeEqual TildeFullEqual TildeTilde TimeConstrained TimeConstraint Times TimesBy TimeSeriesForecast TimeSeriesInvertibility TimeUsed TimeValue TimeZone Timing Tiny TitleGrouping TitsGroupT ToBoxes ToCharacterCode ToColor ToContinuousTimeModel ToDate ToDiscreteTimeModel ToeplitzMatrix ToExpression ToFileName Together Toggle ToggleFalse Toggler TogglerBar TogglerBox TogglerBoxOptions ToHeldExpression ToInvertibleTimeSeries TokenWords Tolerance ToLowerCase ToNumberField TooBig Tooltip TooltipBox TooltipBoxOptions TooltipDelay TooltipStyle Top TopHatTransform TopologicalSort ToRadicals ToRules ToString Total TotalHeight TotalVariationFilter TotalWidth TouchscreenAutoZoom TouchscreenControlPlacement ToUpperCase Tr Trace TraceAbove TraceAction TraceBackward TraceDepth TraceDialog TraceForward TraceInternal TraceLevel TraceOff TraceOn TraceOriginal TracePrint TraceScan TrackedSymbols TradingChart TraditionalForm TraditionalFunctionNotation TraditionalNotation TraditionalOrder TransferFunctionCancel TransferFunctionExpand TransferFunctionFactor TransferFunctionModel TransferFunctionPoles TransferFunctionTransform TransferFunctionZeros TransformationFunction TransformationFunctions TransformationMatrix TransformedDistribution TransformedField Translate TranslationTransform TransparentColor Transpose TreeForm TreeGraph TreeGraphQ TreePlot TrendStyle TriangleWave TriangularDistribution Trig TrigExpand TrigFactor TrigFactorList Trigger TrigReduce TrigToExp TrimmedMean True TrueQ TruncatedDistribution TsallisQExponentialDistribution TsallisQGaussianDistribution TTest Tube TubeBezierCurveBox TubeBezierCurveBoxOptions TubeBox TubeBSplineCurveBox TubeBSplineCurveBoxOptions Tuesday TukeyLambdaDistribution TukeyWindow Tuples TuranGraph TuringMachine Transparent UnateQ Uncompress Undefined UnderBar Underflow Underlined Underoverscript UnderoverscriptBox UnderoverscriptBoxOptions Underscript UnderscriptBox UnderscriptBoxOptions UndirectedEdge UndirectedGraph UndirectedGraphQ UndocumentedTestFEParserPacket UndocumentedTestGetSelectionPacket Unequal Unevaluated UniformDistribution UniformGraphDistribution UniformSumDistribution Uninstall Union UnionPlus Unique UnitBox UnitConvert UnitDimensions Unitize UnitRootTest UnitSimplify UnitStep UnitTriangle UnitVector Unprotect UnsameQ UnsavedVariables Unset UnsetShared UntrackedVariables Up UpArrow UpArrowBar UpArrowDownArrow Update UpdateDynamicObjects UpdateDynamicObjectsSynchronous UpdateInterval UpDownArrow UpEquilibrium UpperCaseQ UpperLeftArrow UpperRightArrow UpperTriangularize Upsample UpSet UpSetDelayed UpTee UpTeeArrow UpValues URL URLFetch URLFetchAsynchronous URLSave URLSaveAsynchronous UseGraphicsRange Using UsingFrontEnd V2Get ValidationLength Value ValueBox ValueBoxOptions ValueForm ValueQ ValuesData Variables Variance VarianceEquivalenceTest VarianceEstimatorFunction VarianceGammaDistribution VarianceTest VectorAngle VectorColorFunction VectorColorFunctionScaling VectorDensityPlot VectorGlyphData VectorPlot VectorPlot3D VectorPoints VectorQ Vectors VectorScale VectorStyle Vee Verbatim Verbose VerboseConvertToPostScriptPacket VerifyConvergence VerifySolutions VerifyTestAssumptions Version VersionNumber VertexAdd VertexCapacity VertexColors VertexComponent VertexConnectivity VertexCoordinateRules VertexCoordinates VertexCorrelationSimilarity VertexCosineSimilarity VertexCount VertexCoverQ VertexDataCoordinates VertexDegree VertexDelete VertexDiceSimilarity VertexEccentricity VertexInComponent VertexInDegree VertexIndex VertexJaccardSimilarity VertexLabeling VertexLabels VertexLabelStyle VertexList VertexNormals VertexOutComponent VertexOutDegree VertexQ VertexRenderingFunction VertexReplace VertexShape VertexShapeFunction VertexSize VertexStyle VertexTextureCoordinates VertexWeight Vertical VerticalBar VerticalForm VerticalGauge VerticalSeparator VerticalSlider VerticalTilde ViewAngle ViewCenter ViewMatrix ViewPoint ViewPointSelectorSettings ViewPort ViewRange ViewVector ViewVertical VirtualGroupData Visible VisibleCell VoigtDistribution VonMisesDistribution WaitAll WaitAsynchronousTask WaitNext WaitUntil WakebyDistribution WalleniusHypergeometricDistribution WaringYuleDistribution WatershedComponents WatsonUSquareTest WattsStrogatzGraphDistribution WaveletBestBasis WaveletFilterCoefficients WaveletImagePlot WaveletListPlot WaveletMapIndexed WaveletMatrixPlot WaveletPhi WaveletPsi WaveletScale WaveletScalogram WaveletThreshold WeaklyConnectedComponents WeaklyConnectedGraphQ WeakStationarity WeatherData WeberE Wedge Wednesday WeibullDistribution WeierstrassHalfPeriods WeierstrassInvariants WeierstrassP WeierstrassPPrime WeierstrassSigma WeierstrassZeta WeightedAdjacencyGraph WeightedAdjacencyMatrix WeightedData WeightedGraphQ Weights WelchWindow WheelGraph WhenEvent Which While White Whitespace WhitespaceCharacter WhittakerM WhittakerW WienerFilter WienerProcess WignerD WignerSemicircleDistribution WilksW WilksWTest WindowClickSelect WindowElements WindowFloating WindowFrame WindowFrameElements WindowMargins WindowMovable WindowOpacity WindowSelected WindowSize WindowStatusArea WindowTitle WindowToolbars WindowWidth With WolframAlpha WolframAlphaDate WolframAlphaQuantity WolframAlphaResult Word WordBoundary WordCharacter WordData WordSearch WordSeparators WorkingPrecision Write WriteString Wronskian XMLElement XMLObject Xnor Xor Yellow YuleDissimilarity ZernikeR ZeroSymmetric ZeroTest ZeroWidthTimes Zeta ZetaZero ZipfDistribution ZTest ZTransform $Aborted $ActivationGroupID $ActivationKey $ActivationUserRegistered $AddOnsDirectory $AssertFunction $Assumptions $AsynchronousTask $BaseDirectory $BatchInput $BatchOutput $BoxForms $ByteOrdering $Canceled $CharacterEncoding $CharacterEncodings $CommandLine $CompilationTarget $ConditionHold $ConfiguredKernels $Context $ContextPath $ControlActiveSetting $CreationDate $CurrentLink $DateStringFormat $DefaultFont $DefaultFrontEnd $DefaultImagingDevice $DefaultPath $Display $DisplayFunction $DistributedContexts $DynamicEvaluation $Echo $Epilog $ExportFormats $Failed $FinancialDataSource $FormatType $FrontEnd $FrontEndSession $GeoLocation $HistoryLength $HomeDirectory $HTTPCookies $IgnoreEOF $ImagingDevices $ImportFormats $InitialDirectory $Input $InputFileName $InputStreamMethods $Inspector $InstallationDate $InstallationDirectory $InterfaceEnvironment $IterationLimit $KernelCount $KernelID $Language $LaunchDirectory $LibraryPath $LicenseExpirationDate $LicenseID $LicenseProcesses $LicenseServer $LicenseSubprocesses $LicenseType $Line $Linked $LinkSupported $LoadedFiles $MachineAddresses $MachineDomain $MachineDomains $MachineEpsilon $MachineID $MachineName $MachinePrecision $MachineType $MaxExtraPrecision $MaxLicenseProcesses $MaxLicenseSubprocesses $MaxMachineNumber $MaxNumber $MaxPiecewiseCases $MaxPrecision $MaxRootDegree $MessageGroups $MessageList $MessagePrePrint $Messages $MinMachineNumber $MinNumber $MinorReleaseNumber $MinPrecision $ModuleNumber $NetworkLicense $NewMessage $NewSymbol $Notebooks $NumberMarks $Off $OperatingSystem $Output $OutputForms $OutputSizeLimit $OutputStreamMethods $Packages $ParentLink $ParentProcessID $PasswordFile $PatchLevelID $Path $PathnameSeparator $PerformanceGoal $PipeSupported $Post $Pre $PreferencesDirectory $PrePrint $PreRead $PrintForms $PrintLiteral $ProcessID $ProcessorCount $ProcessorType $ProductInformation $ProgramName $RandomState $RecursionLimit $ReleaseNumber $RootDirectory $ScheduledTask $ScriptCommandLine $SessionID $SetParentLink $SharedFunctions $SharedVariables $SoundDisplay $SoundDisplayFunction $SuppressInputFormHeads $SynchronousEvaluation $SyntaxHandler $System $SystemCharacterEncoding $SystemID $SystemWordLength $TemporaryDirectory $TemporaryPrefix $TextStyle $TimedOut $TimeUnit $TimeZone $TopDirectory $TraceOff $TraceOn $TracePattern $TracePostAction $TracePreAction $Urgent $UserAddOnsDirectory $UserBaseDirectory $UserDocumentsDirectory $UserName $Version $VersionNumber", +c:[{cN:"comment",b:/\(\*/,e:/\*\)/},e.ASM,e.QSM,e.CNM,{cN:"list",b:/\{/,e:/\}/,i:/:/}]}});hljs.registerLanguage("fsharp",function(e){var t={b:"<",e:">",c:[e.inherit(e.TM,{b:/'[a-zA-Z0-9_]+/})]};return{aliases:["fs"],k:"yield! return! let! do!abstract and as assert base begin class default delegate do done downcast downto elif else end exception extern false finally for fun function global if in inherit inline interface internal lazy let match member module mutable namespace new null of open or override private public rec return sig static struct then to true try type upcast use val void when while with yield",c:[{cN:"string",b:'@"',e:'"',c:[{b:'""'}]},{cN:"string",b:'"""',e:'"""'},e.C("\\(\\*","\\*\\)"),{cN:"class",bK:"type",e:"\\(|=|$",eE:!0,c:[e.UTM,t]},{cN:"annotation",b:"\\[<",e:">\\]",r:10},{cN:"attribute",b:"\\B('[A-Za-z])\\b",c:[e.BE]},e.CLCM,e.inherit(e.QSM,{i:null}),e.CNM]}});hljs.registerLanguage("verilog",function(e){return{aliases:["v"],cI:!0,k:{keyword:"always and assign begin buf bufif0 bufif1 case casex casez cmos deassign default defparam disable edge else end endcase endfunction endmodule endprimitive endspecify endtable endtask event for force forever fork function if ifnone initial inout input join macromodule module nand negedge nmos nor not notif0 notif1 or output parameter pmos posedge primitive pulldown pullup rcmos release repeat rnmos rpmos rtran rtranif0 rtranif1 specify specparam table task timescale tran tranif0 tranif1 wait while xnor xor",typename:"highz0 highz1 integer large medium pull0 pull1 real realtime reg scalared signed small strong0 strong1 supply0 supply0 supply1 supply1 time tri tri0 tri1 triand trior trireg vectored wand weak0 weak1 wire wor"},c:[e.CBCM,e.CLCM,e.QSM,{cN:"number",b:"\\b(\\d+'(b|h|o|d|B|H|O|D))?[0-9xzXZ]+",c:[e.BE],r:0},{cN:"typename",b:"\\.\\w+",r:0},{cN:"value",b:"#\\((?!parameter).+\\)"},{cN:"keyword",b:"\\+|-|\\*|/|%|<|>|=|#|`|\\!|&|\\||@|:|\\^|~|\\{|\\}",r:0}]}});hljs.registerLanguage("dos",function(e){var r=e.C(/@?rem\b/,/$/,{r:10}),t={cN:"label",b:"^\\s*[A-Za-z._?][A-Za-z0-9_$#@~.?]*(:|\\s+label)",r:0};return{aliases:["bat","cmd"],cI:!0,k:{flow:"if else goto for in do call exit not exist errorlevel defined",operator:"equ neq lss leq gtr geq",keyword:"shift cd dir echo setlocal endlocal set pause copy",stream:"prn nul lpt3 lpt2 lpt1 con com4 com3 com2 com1 aux",winutils:"ping net ipconfig taskkill xcopy ren del",built_in:"append assoc at attrib break cacls cd chcp chdir chkdsk chkntfs cls cmd color comp compact convert date dir diskcomp diskcopy doskey erase fs find findstr format ftype graftabl help keyb label md mkdir mode more move path pause print popd pushd promt rd recover rem rename replace restore rmdir shiftsort start subst time title tree type ver verify vol"},c:[{cN:"envvar",b:/%%[^ ]|%[^ ]+?%|![^ ]+?!/},{cN:"function",b:t.b,e:"goto:eof",c:[e.inherit(e.TM,{b:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),r]},{cN:"number",b:"\\b\\d+",r:0},r]}});hljs.registerLanguage("gherkin",function(e){return{aliases:["feature"],k:"Feature Background Ability Business Need Scenario Scenarios Scenario Outline Scenario Template Examples Given And Then But When",c:[{cN:"keyword",b:"\\*"},e.C("@[^@\r\n ]+","$"),{cN:"string",b:"\\|",e:"\\$"},{cN:"variable",b:"<",e:">"},e.HCM,{cN:"string",b:'"""',e:'"""'},e.QSM]}});hljs.registerLanguage("xml",function(t){var e="[A-Za-z0-9\\._:-]+",s={b:/<\?(php)?(?!\w)/,e:/\?>/,sL:"php",subLanguageMode:"continuous"},c={eW:!0,i:/]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xsl","plist"],cI:!0,c:[{cN:"doctype",b:"",r:10,c:[{b:"\\[",e:"\\]"}]},t.C("",{r:10}),{cN:"cdata",b:"<\\!\\[CDATA\\[",e:"\\]\\]>",r:10},{cN:"tag",b:"|$)",e:">",k:{title:"style"},c:[c],starts:{e:"",rE:!0,sL:"css"}},{cN:"tag",b:"|$)",e:">",k:{title:"script"},c:[c],starts:{e:"",rE:!0,sL:""}},s,{cN:"pi",b:/<\?\w+/,e:/\?>/,r:10},{cN:"tag",b:"",c:[{cN:"title",b:/[^ \/><\n\t]+/,r:0},c]}]}});hljs.registerLanguage("autohotkey",function(e){var r={cN:"escape",b:"`[\\s\\S]"},c=e.C(";","$",{r:0}),n=[{cN:"built_in",b:"A_[a-zA-Z0-9]+"},{cN:"built_in",bK:"ComSpec Clipboard ClipboardAll ErrorLevel"}];return{cI:!0,k:{keyword:"Break Continue Else Gosub If Loop Return While",literal:"A true false NOT AND OR"},c:n.concat([r,e.inherit(e.QSM,{c:[r]}),c,{cN:"number",b:e.NR,r:0},{cN:"var_expand",b:"%",e:"%",i:"\\n",c:[r]},{cN:"label",c:[r],v:[{b:'^[^\\n";]+::(?!=)'},{b:'^[^\\n";]+:(?!=)',r:0}]},{b:",\\s*,",r:10}])}});hljs.registerLanguage("r",function(e){var r="([a-zA-Z]|\\.[a-zA-Z.])[a-zA-Z0-9._]*";return{c:[e.HCM,{b:r,l:r,k:{keyword:"function if in break next repeat else for return switch while try tryCatch stop warning require library attach detach source setMethod setGeneric setGroupGeneric setClass ...",literal:"NULL NA TRUE FALSE T F Inf NaN NA_integer_|10 NA_real_|10 NA_character_|10 NA_complex_|10"},r:0},{cN:"number",b:"0[xX][0-9a-fA-F]+[Li]?\\b",r:0},{cN:"number",b:"\\d+(?:[eE][+\\-]?\\d*)?L\\b",r:0},{cN:"number",b:"\\d+\\.(?!\\d)(?:i\\b)?",r:0},{cN:"number",b:"\\d+(?:\\.\\d*)?(?:[eE][+\\-]?\\d*)?i?\\b",r:0},{cN:"number",b:"\\.\\d+(?:[eE][+\\-]?\\d*)?i?\\b",r:0},{b:"`",e:"`",r:0},{cN:"string",c:[e.BE],v:[{b:'"',e:'"'},{b:"'",e:"'"}]}]}});hljs.registerLanguage("cs",function(e){var r="abstract as base bool break byte case catch char checked const continue decimal dynamic default delegate do double else enum event explicit extern false finally fixed float for foreach goto if implicit in int interface internal is lock long null when object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this true try typeof uint ulong unchecked unsafe ushort using virtual volatile void while async protected public private internal ascending descending from get group into join let orderby partial select set value var where yield",t=e.IR+"(<"+e.IR+">)?";return{aliases:["csharp"],k:r,i:/::/,c:[e.C("///","$",{rB:!0,c:[{cN:"xmlDocTag",v:[{b:"///",r:0},{b:""},{b:""}]}]}),e.CLCM,e.CBCM,{cN:"preprocessor",b:"#",e:"$",k:"if else elif endif define undef warning error line region endregion pragma checksum"},{cN:"string",b:'@"',e:'"',c:[{b:'""'}]},e.ASM,e.QSM,e.CNM,{bK:"class namespace interface",e:/[{;=]/,i:/[^\s:]/,c:[e.TM,e.CLCM,e.CBCM]},{bK:"new return throw await",r:0},{cN:"function",b:"("+t+"\\s+)+"+e.IR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:r,c:[{b:e.IR+"\\s*\\(",rB:!0,c:[e.TM],r:0},{cN:"params",b:/\(/,e:/\)/,k:r,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]}]}});hljs.registerLanguage("nsis",function(e){var t={cN:"symbol",b:"\\$(ADMINTOOLS|APPDATA|CDBURN_AREA|CMDLINE|COMMONFILES32|COMMONFILES64|COMMONFILES|COOKIES|DESKTOP|DOCUMENTS|EXEDIR|EXEFILE|EXEPATH|FAVORITES|FONTS|HISTORY|HWNDPARENT|INSTDIR|INTERNET_CACHE|LANGUAGE|LOCALAPPDATA|MUSIC|NETHOOD|OUTDIR|PICTURES|PLUGINSDIR|PRINTHOOD|PROFILE|PROGRAMFILES32|PROGRAMFILES64|PROGRAMFILES|QUICKLAUNCH|RECENT|RESOURCES_LOCALIZED|RESOURCES|SENDTO|SMPROGRAMS|SMSTARTUP|STARTMENU|SYSDIR|TEMP|TEMPLATES|VIDEOS|WINDIR)"},n={cN:"constant",b:"\\$+{[a-zA-Z0-9_]+}"},i={cN:"variable",b:"\\$+[a-zA-Z0-9_]+",i:"\\(\\){}"},r={cN:"constant",b:"\\$+\\([a-zA-Z0-9_]+\\)"},o={cN:"params",b:"(ARCHIVE|FILE_ATTRIBUTE_ARCHIVE|FILE_ATTRIBUTE_NORMAL|FILE_ATTRIBUTE_OFFLINE|FILE_ATTRIBUTE_READONLY|FILE_ATTRIBUTE_SYSTEM|FILE_ATTRIBUTE_TEMPORARY|HKCR|HKCU|HKDD|HKEY_CLASSES_ROOT|HKEY_CURRENT_CONFIG|HKEY_CURRENT_USER|HKEY_DYN_DATA|HKEY_LOCAL_MACHINE|HKEY_PERFORMANCE_DATA|HKEY_USERS|HKLM|HKPD|HKU|IDABORT|IDCANCEL|IDIGNORE|IDNO|IDOK|IDRETRY|IDYES|MB_ABORTRETRYIGNORE|MB_DEFBUTTON1|MB_DEFBUTTON2|MB_DEFBUTTON3|MB_DEFBUTTON4|MB_ICONEXCLAMATION|MB_ICONINFORMATION|MB_ICONQUESTION|MB_ICONSTOP|MB_OK|MB_OKCANCEL|MB_RETRYCANCEL|MB_RIGHT|MB_RTLREADING|MB_SETFOREGROUND|MB_TOPMOST|MB_USERICON|MB_YESNO|NORMAL|OFFLINE|READONLY|SHCTX|SHELL_CONTEXT|SYSTEM|TEMPORARY)"},l={cN:"constant",b:"\\!(addincludedir|addplugindir|appendfile|cd|define|delfile|echo|else|endif|error|execute|finalize|getdllversionsystem|ifdef|ifmacrodef|ifmacrondef|ifndef|if|include|insertmacro|macroend|macro|makensis|packhdr|searchparse|searchreplace|tempfile|undef|verbose|warning)"};return{cI:!1,k:{keyword:"Abort AddBrandingImage AddSize AllowRootDirInstall AllowSkipFiles AutoCloseWindow BGFont BGGradient BrandingText BringToFront Call CallInstDLL Caption ChangeUI CheckBitmap ClearErrors CompletedText ComponentText CopyFiles CRCCheck CreateDirectory CreateFont CreateShortCut Delete DeleteINISec DeleteINIStr DeleteRegKey DeleteRegValue DetailPrint DetailsButtonText DirText DirVar DirVerify EnableWindow EnumRegKey EnumRegValue Exch Exec ExecShell ExecWait ExpandEnvStrings File FileBufSize FileClose FileErrorText FileOpen FileRead FileReadByte FileReadUTF16LE FileReadWord FileSeek FileWrite FileWriteByte FileWriteUTF16LE FileWriteWord FindClose FindFirst FindNext FindWindow FlushINI FunctionEnd GetCurInstType GetCurrentAddress GetDlgItem GetDLLVersion GetDLLVersionLocal GetErrorLevel GetFileTime GetFileTimeLocal GetFullPathName GetFunctionAddress GetInstDirError GetLabelAddress GetTempFileName Goto HideWindow Icon IfAbort IfErrors IfFileExists IfRebootFlag IfSilent InitPluginsDir InstallButtonText InstallColors InstallDir InstallDirRegKey InstProgressFlags InstType InstTypeGetText InstTypeSetText IntCmp IntCmpU IntFmt IntOp IsWindow LangString LicenseBkColor LicenseData LicenseForceSelection LicenseLangString LicenseText LoadLanguageFile LockWindow LogSet LogText ManifestDPIAware ManifestSupportedOS MessageBox MiscButtonText Name Nop OutFile Page PageCallbacks PageExEnd Pop Push Quit ReadEnvStr ReadINIStr ReadRegDWORD ReadRegStr Reboot RegDLL Rename RequestExecutionLevel ReserveFile Return RMDir SearchPath SectionEnd SectionGetFlags SectionGetInstTypes SectionGetSize SectionGetText SectionGroupEnd SectionIn SectionSetFlags SectionSetInstTypes SectionSetSize SectionSetText SendMessage SetAutoClose SetBrandingImage SetCompress SetCompressor SetCompressorDictSize SetCtlColors SetCurInstType SetDatablockOptimize SetDateSave SetDetailsPrint SetDetailsView SetErrorLevel SetErrors SetFileAttributes SetFont SetOutPath SetOverwrite SetPluginUnload SetRebootFlag SetRegView SetShellVarContext SetSilent ShowInstDetails ShowUninstDetails ShowWindow SilentInstall SilentUnInstall Sleep SpaceTexts StrCmp StrCmpS StrCpy StrLen SubCaption SubSectionEnd Unicode UninstallButtonText UninstallCaption UninstallIcon UninstallSubCaption UninstallText UninstPage UnRegDLL Var VIAddVersionKey VIFileVersion VIProductVersion WindowIcon WriteINIStr WriteRegBin WriteRegDWORD WriteRegExpandStr WriteRegStr WriteUninstaller XPStyle",literal:"admin all auto both colored current false force hide highest lastused leave listonly none normal notset off on open print show silent silentlog smooth textonly true user "},c:[e.HCM,e.CBCM,{cN:"string",b:'"',e:'"',i:"\\n",c:[{cN:"symbol",b:"\\$(\\\\(n|r|t)|\\$)"},t,n,i,r]},e.C(";","$",{r:0}),{cN:"function",bK:"Function PageEx Section SectionGroup SubSection",e:"$"},l,n,i,r,o,e.NM,{cN:"literal",b:e.IR+"::"+e.IR}]}});hljs.registerLanguage("less",function(e){var r="[\\w-]+",t="("+r+"|@{"+r+"})",a=[],c=[],n=function(e){return{cN:"string",b:"~?"+e+".*?"+e}},i=function(e,r,t){return{cN:e,b:r,r:t}},s=function(r,t,a){return e.inherit({cN:r,b:t+"\\(",e:"\\(",rB:!0,eE:!0,r:0},a)},b={b:"\\(",e:"\\)",c:c,r:0};c.push(e.CLCM,e.CBCM,n("'"),n('"'),e.CSSNM,i("hexcolor","#[0-9A-Fa-f]+\\b"),s("function","(url|data-uri)",{starts:{cN:"string",e:"[\\)\\n]",eE:!0}}),s("function",r),b,i("variable","@@?"+r,10),i("variable","@{"+r+"}"),i("built_in","~?`[^`]*?`"),{cN:"attribute",b:r+"\\s*:",e:":",rB:!0,eE:!0});var o=c.concat({b:"{",e:"}",c:a}),u={bK:"when",eW:!0,c:[{bK:"and not"}].concat(c)},C={cN:"attribute",b:t,e:":",eE:!0,c:[e.CLCM,e.CBCM],i:/\S/,starts:{e:"[;}]",rE:!0,c:c,i:"[<=$]"}},l={cN:"at_rule",b:"@(import|media|charset|font-face|(-[a-z]+-)?keyframes|supports|document|namespace|page|viewport|host)\\b",starts:{e:"[;{}]",rE:!0,c:c,r:0}},d={cN:"variable",v:[{b:"@"+r+"\\s*:",r:15},{b:"@"+r}],starts:{e:"[;}]",rE:!0,c:o}},p={v:[{b:"[\\.#:&\\[]",e:"[;{}]"},{b:t+"[^;]*{",e:"{"}],rB:!0,rE:!0,i:"[<='$\"]",c:[e.CLCM,e.CBCM,u,i("keyword","all\\b"),i("variable","@{"+r+"}"),i("tag",t+"%?",0),i("id","#"+t),i("class","\\."+t,0),i("keyword","&",0),s("pseudo",":not"),s("keyword",":extend"),i("pseudo","::?"+t),{cN:"attr_selector",b:"\\[",e:"\\]"},{b:"\\(",e:"\\)",c:o},{b:"!important"}]};return a.push(e.CLCM,e.CBCM,l,d,p,C),{cI:!0,i:"[=>'/<($\"]",c:a}});hljs.registerLanguage("pf",function(t){var o={cN:"variable",b:/\$[\w\d#@][\w\d_]*/},e={cN:"variable",b://};return{aliases:["pf.conf"],l:/[a-z0-9_<>-]+/,k:{built_in:"block match pass load anchor|5 antispoof|10 set table",keyword:"in out log quick on rdomain inet inet6 proto from port os to routeallow-opts divert-packet divert-reply divert-to flags group icmp-typeicmp6-type label once probability recieved-on rtable prio queuetos tag tagged user keep fragment for os dropaf-to|10 binat-to|10 nat-to|10 rdr-to|10 bitmask least-stats random round-robinsource-hash static-portdup-to reply-to route-toparent bandwidth default min max qlimitblock-policy debug fingerprints hostid limit loginterface optimizationreassemble ruleset-optimization basic none profile skip state-defaultsstate-policy timeoutconst counters persistno modulate synproxy state|5 floating if-bound no-sync pflow|10 sloppysource-track global rule max-src-nodes max-src-states max-src-connmax-src-conn-rate overload flushscrub|5 max-mss min-ttl no-df|10 random-id",literal:"all any no-route self urpf-failed egress|5 unknown"},c:[t.HCM,t.NM,t.QSM,o,e]}});hljs.registerLanguage("lasso",function(e){var r="[a-zA-Z_][a-zA-Z0-9_.]*",a="<\\?(lasso(script)?|=)",t="\\]|\\?>",s={literal:"true false none minimal full all void and or not bw nbw ew new cn ncn lt lte gt gte eq neq rx nrx ft",built_in:"array date decimal duration integer map pair string tag xml null boolean bytes keyword list locale queue set stack staticarray local var variable global data self inherited",keyword:"error_code error_msg error_pop error_push error_reset cache database_names database_schemanames database_tablenames define_tag define_type email_batch encode_set html_comment handle handle_error header if inline iterate ljax_target link link_currentaction link_currentgroup link_currentrecord link_detail link_firstgroup link_firstrecord link_lastgroup link_lastrecord link_nextgroup link_nextrecord link_prevgroup link_prevrecord log loop namespace_using output_none portal private protect records referer referrer repeating resultset rows search_args search_arguments select sort_args sort_arguments thread_atomic value_list while abort case else if_empty if_false if_null if_true loop_abort loop_continue loop_count params params_up return return_value run_children soap_definetag soap_lastrequest soap_lastresponse tag_name ascending average by define descending do equals frozen group handle_failure import in into join let match max min on order parent protected provide public require returnhome skip split_thread sum take thread to trait type where with yield yieldhome"},n=e.C("",{r:0}),o={cN:"preprocessor",b:"\\[noprocess\\]",starts:{cN:"markup",e:"\\[/noprocess\\]",rE:!0,c:[n]}},i={cN:"preprocessor",b:"\\[/noprocess|"+a},l={cN:"variable",b:"'"+r+"'"},c=[e.CLCM,{cN:"javadoc",b:"/\\*\\*!",e:"\\*/",c:[e.PWM]},e.CBCM,e.inherit(e.CNM,{b:e.CNR+"|(-?infinity|nan)\\b"}),e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null}),{cN:"string",b:"`",e:"`"},{cN:"variable",v:[{b:"[#$]"+r},{b:"#",e:"\\d+",i:"\\W"}]},{cN:"tag",b:"::\\s*",e:r,i:"\\W"},{cN:"attribute",v:[{b:"-"+e.UIR,r:0},{b:"(\\.\\.\\.)"}]},{cN:"subst",v:[{b:"->\\s*",c:[l]},{b:":=|/(?!\\w)=?|[-+*%=<>&|!?\\\\]+",r:0}]},{cN:"built_in",b:"\\.\\.?\\s*",r:0,c:[l]},{cN:"class",bK:"define",rE:!0,e:"\\(|=>",c:[e.inherit(e.TM,{b:e.UIR+"(=(?!>))?"})]}];return{aliases:["ls","lassoscript"],cI:!0,l:r+"|&[lg]t;",k:s,c:[{cN:"preprocessor",b:t,r:0,starts:{cN:"markup",e:"\\[|"+a,rE:!0,r:0,c:[n]}},o,i,{cN:"preprocessor",b:"\\[no_square_brackets",starts:{e:"\\[/no_square_brackets\\]",l:r+"|&[lg]t;",k:s,c:[{cN:"preprocessor",b:t,r:0,starts:{cN:"markup",e:"\\[noprocess\\]|"+a,rE:!0,c:[n]}},o,i].concat(c)}},{cN:"preprocessor",b:"\\[",r:0},{cN:"shebang",b:"^#!.+lasso9\\b",r:10}].concat(c)}});hljs.registerLanguage("prolog",function(c){var r={cN:"atom",b:/[a-z][A-Za-z0-9_]*/,r:0},b={cN:"name",v:[{b:/[A-Z][a-zA-Z0-9_]*/},{b:/_[A-Za-z0-9_]*/}],r:0},a={b:/\(/,e:/\)/,r:0},e={b:/\[/,e:/\]/},n={cN:"comment",b:/%/,e:/$/,c:[c.PWM]},t={cN:"string",b:/`/,e:/`/,c:[c.BE]},g={cN:"string",b:/0\'(\\\'|.)/},N={cN:"string",b:/0\'\\s/},o={b:/:-/},s=[r,b,a,o,e,n,c.CBCM,c.QSM,c.ASM,t,g,N,c.CNM];return a.c=s,e.c=s,{c:s.concat([{b:/\.$/}])}});hljs.registerLanguage("oxygene",function(e){var r="abstract add and array as asc aspect assembly async begin break block by case class concat const copy constructor continue create default delegate desc distinct div do downto dynamic each else empty end ensure enum equals event except exit extension external false final finalize finalizer finally flags for forward from function future global group has if implementation implements implies in index inherited inline interface into invariants is iterator join locked locking loop matching method mod module namespace nested new nil not notify nullable of old on operator or order out override parallel params partial pinned private procedure property protected public queryable raise read readonly record reintroduce remove repeat require result reverse sealed select self sequence set shl shr skip static step soft take then to true try tuple type union unit unsafe until uses using var virtual raises volatile where while with write xor yield await mapped deprecated stdcall cdecl pascal register safecall overload library platform reference packed strict published autoreleasepool selector strong weak unretained",t=e.C("{","}",{r:0}),a=e.C("\\(\\*","\\*\\)",{r:10}),n={cN:"string",b:"'",e:"'",c:[{b:"''"}]},o={cN:"string",b:"(#\\d+)+"},i={cN:"function",bK:"function constructor destructor procedure method",e:"[:;]",k:"function constructor|10 destructor|10 procedure|10 method|10",c:[e.TM,{cN:"params",b:"\\(",e:"\\)",k:r,c:[n,o]},t,a]};return{cI:!0,k:r,i:'("|\\$[G-Zg-z]|\\/\\*||->)',c:[t,a,e.CLCM,n,o,e.NM,i,{cN:"class",b:"=\\bclass\\b",e:"end;",k:r,c:[n,o,t,a,e.CLCM,i]}]}});hljs.registerLanguage("applescript",function(e){var t=e.inherit(e.QSM,{i:""}),r={cN:"params",b:"\\(",e:"\\)",c:["self",e.CNM,t]},o=e.C("--","$"),n=e.C("\\(\\*","\\*\\)",{c:["self",o]}),a=[o,n,e.HCM];return{aliases:["osascript"],k:{keyword:"about above after against and around as at back before beginning behind below beneath beside between but by considering contain contains continue copy div does eighth else end equal equals error every exit fifth first for fourth from front get given global if ignoring in into is it its last local me middle mod my ninth not of on onto or over prop property put ref reference repeat returning script second set seventh since sixth some tell tenth that the|0 then third through thru timeout times to transaction try until where while whose with without",constant:"AppleScript false linefeed return pi quote result space tab true",type:"alias application boolean class constant date file integer list number real record string text",command:"activate beep count delay launch log offset read round run say summarize write",property:"character characters contents day frontmost id item length month name paragraph paragraphs rest reverse running time version weekday word words year"},c:[t,e.CNM,{cN:"type",b:"\\bPOSIX file\\b"},{cN:"command",b:"\\b(clipboard info|the clipboard|info for|list (disks|folder)|mount volume|path to|(close|open for) access|(get|set) eof|current date|do shell script|get volume settings|random number|set volume|system attribute|system info|time to GMT|(load|run|store) script|scripting components|ASCII (character|number)|localized string|choose (application|color|file|file name|folder|from list|remote application|URL)|display (alert|dialog))\\b|^\\s*return\\b"},{cN:"constant",b:"\\b(text item delimiters|current application|missing value)\\b"},{cN:"keyword",b:"\\b(apart from|aside from|instead of|out of|greater than|isn't|(doesn't|does not) (equal|come before|come after|contain)|(greater|less) than( or equal)?|(starts?|ends|begins?) with|contained by|comes (before|after)|a (ref|reference))\\b"},{cN:"property",b:"\\b(POSIX path|(date|time) string|quoted form)\\b"},{cN:"function_start",bK:"on",i:"[${=;\\n]",c:[e.UTM,r]}].concat(a),i:"//|->|=>"}});hljs.registerLanguage("makefile",function(e){var a={cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]};return{aliases:["mk","mak"],c:[e.HCM,{b:/^\w+\s*\W*=/,rB:!0,r:0,starts:{cN:"constant",e:/\s*\W*=/,eE:!0,starts:{e:/$/,r:0,c:[a]}}},{cN:"title",b:/^[\w]+:\s*$/},{cN:"phony",b:/^\.PHONY:/,e:/$/,k:".PHONY",l:/[\.\w]+/},{b:/^\t+/,e:/$/,r:0,c:[e.QSM,a]}]}});hljs.registerLanguage("dust",function(e){var a="if eq ne lt lte gt gte select default math sep";return{aliases:["dst"],cI:!0,sL:"xml",subLanguageMode:"continuous",c:[{cN:"expression",b:"{",e:"}",r:0,c:[{cN:"begin-block",b:"#[a-zA-Z- .]+",k:a},{cN:"string",b:'"',e:'"'},{cN:"end-block",b:"\\/[a-zA-Z- .]+",k:a},{cN:"variable",b:"[a-zA-Z-.]+",k:a,r:0}]}]}});hljs.registerLanguage("clojure-repl",function(e){return{c:[{cN:"prompt",b:/^([\w.-]+|\s*#_)=>/,starts:{e:/$/,sL:"clojure",subLanguageMode:"continuous"}}]}});hljs.registerLanguage("dart",function(e){var t={cN:"subst",b:"\\$\\{",e:"}",k:"true false null this is new super"},r={cN:"string",v:[{b:"r'''",e:"'''"},{b:'r"""',e:'"""'},{b:"r'",e:"'",i:"\\n"},{b:'r"',e:'"',i:"\\n"},{b:"'''",e:"'''",c:[e.BE,t]},{b:'"""',e:'"""',c:[e.BE,t]},{b:"'",e:"'",i:"\\n",c:[e.BE,t]},{b:'"',e:'"',i:"\\n",c:[e.BE,t]}]};t.c=[e.CNM,r];var n={keyword:"assert break case catch class const continue default do else enum extends false final finally for if in is new null rethrow return super switch this throw true try var void while with",literal:"abstract as dynamic export external factory get implements import library operator part set static typedef",built_in:"print Comparable DateTime Duration Function Iterable Iterator List Map Match Null Object Pattern RegExp Set Stopwatch String StringBuffer StringSink Symbol Type Uri bool double int num document window querySelector querySelectorAll Element ElementList"};return{k:n,c:[r,{cN:"dartdoc",b:"/\\*\\*",e:"\\*/",sL:"markdown",subLanguageMode:"continuous"},{cN:"dartdoc",b:"///",e:"$",sL:"markdown",subLanguageMode:"continuous"},e.CLCM,e.CBCM,{cN:"class",bK:"class interface",e:"{",eE:!0,c:[{bK:"extends implements"},e.UTM]},e.CNM,{cN:"annotation",b:"@[A-Za-z]+"},{b:"=>"}]}}); \ No newline at end of file diff --git a/doc/html/js/jquery-2.1.1.min.js b/doc/html/js/jquery-2.1.1.min.js new file mode 100644 index 0000000000000000000000000000000000000000..e5ace116b6f53cfec96eb5175ecd36f727ad4047 GIT binary patch literal 84245 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 Cudf0C literal 0 HcmV?d00001 diff --git a/doc/html/js/modernizr-2.8.3.min.js b/doc/html/js/modernizr-2.8.3.min.js new file mode 100644 index 0000000000000000000000000000000000000000..40dd2a9feaaf8c788b769554f5845c5de8b50979 GIT binary patch literal 11084 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 literal 0 HcmV?d00001 diff --git a/doc/html/js/theme.js b/doc/html/js/theme.js new file mode 100644 index 00000000..99b146ec --- /dev/null +++ b/doc/html/js/theme.js @@ -0,0 +1,82 @@ +$( document ).ready(function() { + // Shift nav in mobile when clicking the menu. + $(document).on('click', "[data-toggle='wy-nav-top']", function() { + $("[data-toggle='wy-nav-shift']").toggleClass("shift"); + $("[data-toggle='rst-versions']").toggleClass("shift"); + }); + + // Close menu when you click a link. + $(document).on('click', ".wy-menu-vertical .current ul li a", function() { + $("[data-toggle='wy-nav-shift']").removeClass("shift"); + $("[data-toggle='rst-versions']").toggleClass("shift"); + }); + + $(document).on('click', "[data-toggle='rst-current-version']", function() { + $("[data-toggle='rst-versions']").toggleClass("shift-up"); + }); + + // Make tables responsive + $("table.docutils:not(.field-list)").wrap("
"); + + hljs.initHighlightingOnLoad(); + + $('table').addClass('docutils'); +}); + +window.SphinxRtdTheme = (function (jquery) { + var stickyNav = (function () { + var navBar, + win, + stickyNavCssClass = 'stickynav', + applyStickNav = function () { + if (navBar.height() <= win.height()) { + navBar.addClass(stickyNavCssClass); + } else { + navBar.removeClass(stickyNavCssClass); + } + }, + enable = function () { + applyStickNav(); + win.on('resize', applyStickNav); + }, + init = function () { + navBar = jquery('nav.wy-nav-side:first'); + win = jquery(window); + }; + jquery(init); + return { + enable : enable + }; + }()); + return { + StickyNav : stickyNav + }; +}($)); + +// The code below is a copy of @seanmadsen code posted Jan 10, 2017 on issue 803. +// https://github.com/mkdocs/mkdocs/issues/803 +// This just incorporates the auto scroll into the theme itself without +// the need for additional custom.js file. +// +$(function() { + $.fn.isFullyWithinViewport = function(){ + var viewport = {}; + viewport.top = $(window).scrollTop(); + viewport.bottom = viewport.top + $(window).height(); + var bounds = {}; + bounds.top = this.offset().top; + bounds.bottom = bounds.top + this.outerHeight(); + return ( ! ( + (bounds.top <= viewport.top) || + (bounds.bottom >= viewport.bottom) + ) ); + }; + if( $('li.toctree-l1.current').length && !$('li.toctree-l1.current').isFullyWithinViewport() ) { + $('.wy-nav-side') + .scrollTop( + $('li.toctree-l1.current').offset().top - + $('.wy-nav-side').offset().top - + 60 + ); + } +}); diff --git a/doc/html/mkdocs/js/lunr.min.js b/doc/html/mkdocs/js/lunr.min.js new file mode 100644 index 0000000000000000000000000000000000000000..b0198dff91fb2d8a6ceebe8c704c3ceb1ea49f01 GIT binary patch literal 15439 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 literal 0 HcmV?d00001 diff --git a/doc/html/mkdocs/js/mustache.min.js b/doc/html/mkdocs/js/mustache.min.js new file mode 100644 index 0000000000000000000000000000000000000000..7fc6da86b89b8574a9e41ca74bd553de8043d7ed GIT binary patch literal 8835 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 literal 0 HcmV?d00001 diff --git a/doc/html/mkdocs/js/require.js b/doc/html/mkdocs/js/require.js new file mode 100644 index 00000000..8638a310 --- /dev/null +++ b/doc/html/mkdocs/js/require.js @@ -0,0 +1,36 @@ +/* + RequireJS 2.1.16 Copyright (c) 2010-2015, The Dojo Foundation All Rights Reserved. + Available via the MIT or new BSD license. + see: http://github.com/jrburke/requirejs for details +*/ +var requirejs,require,define; +(function(ba){function G(b){return"[object Function]"===K.call(b)}function H(b){return"[object Array]"===K.call(b)}function v(b,c){if(b){var d;for(d=0;dthis.depCount&&!this.defined){if(G(l)){if(this.events.error&&this.map.isDefine||g.onError!==ca)try{f=i.execCb(c,l,b,f)}catch(d){a=d}else f=i.execCb(c,l,b,f);this.map.isDefine&&void 0===f&&((b=this.module)?f=b.exports:this.usingExports&& +(f=this.exports));if(a)return a.requireMap=this.map,a.requireModules=this.map.isDefine?[this.map.id]:null,a.requireType=this.map.isDefine?"define":"require",w(this.error=a)}else f=l;this.exports=f;if(this.map.isDefine&&!this.ignore&&(r[c]=f,g.onResourceLoad))g.onResourceLoad(i,this.map,this.depMaps);y(c);this.defined=!0}this.defining=!1;this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else this.fetch()}},callPlugin:function(){var a= +this.map,b=a.id,d=p(a.prefix);this.depMaps.push(d);q(d,"defined",u(this,function(f){var l,d;d=m(aa,this.map.id);var e=this.map.name,P=this.map.parentMap?this.map.parentMap.name:null,n=i.makeRequire(a.parentMap,{enableBuildCallback:!0});if(this.map.unnormalized){if(f.normalize&&(e=f.normalize(e,function(a){return c(a,P,!0)})||""),f=p(a.prefix+"!"+e,this.map.parentMap),q(f,"defined",u(this,function(a){this.init([],function(){return a},null,{enabled:!0,ignore:!0})})),d=m(h,f.id)){this.depMaps.push(f); +if(this.events.error)d.on("error",u(this,function(a){this.emit("error",a)}));d.enable()}}else d?(this.map.url=i.nameToUrl(d),this.load()):(l=u(this,function(a){this.init([],function(){return a},null,{enabled:!0})}),l.error=u(this,function(a){this.inited=!0;this.error=a;a.requireModules=[b];B(h,function(a){0===a.map.id.indexOf(b+"_unnormalized")&&y(a.map.id)});w(a)}),l.fromText=u(this,function(f,c){var d=a.name,e=p(d),P=M;c&&(f=c);P&&(M=!1);s(e);t(j.config,b)&&(j.config[d]=j.config[b]);try{g.exec(f)}catch(h){return w(C("fromtexteval", +"fromText eval for "+b+" failed: "+h,h,[b]))}P&&(M=!0);this.depMaps.push(e);i.completeLoad(d);n([d],l)}),f.load(a.name,n,l,j))}));i.enable(d,this);this.pluginMaps[d.id]=d},enable:function(){V[this.map.id]=this;this.enabling=this.enabled=!0;v(this.depMaps,u(this,function(a,b){var c,f;if("string"===typeof a){a=p(a,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap);this.depMaps[b]=a;if(c=m(L,a.id)){this.depExports[b]=c(this);return}this.depCount+=1;q(a,"defined",u(this,function(a){this.defineDep(b, +a);this.check()}));this.errback?q(a,"error",u(this,this.errback)):this.events.error&&q(a,"error",u(this,function(a){this.emit("error",a)}))}c=a.id;f=h[c];!t(L,c)&&(f&&!f.enabled)&&i.enable(a,this)}));B(this.pluginMaps,u(this,function(a){var b=m(h,a.id);b&&!b.enabled&&i.enable(a,this)}));this.enabling=!1;this.check()},on:function(a,b){var c=this.events[a];c||(c=this.events[a]=[]);c.push(b)},emit:function(a,b){v(this.events[a],function(a){a(b)});"error"===a&&delete this.events[a]}};i={config:j,contextName:b, +registry:h,defined:r,urlFetched:S,defQueue:A,Module:Z,makeModuleMap:p,nextTick:g.nextTick,onError:w,configure:function(a){a.baseUrl&&"/"!==a.baseUrl.charAt(a.baseUrl.length-1)&&(a.baseUrl+="/");var b=j.shim,c={paths:!0,bundles:!0,config:!0,map:!0};B(a,function(a,b){c[b]?(j[b]||(j[b]={}),U(j[b],a,!0,!0)):j[b]=a});a.bundles&&B(a.bundles,function(a,b){v(a,function(a){a!==b&&(aa[a]=b)})});a.shim&&(B(a.shim,function(a,c){H(a)&&(a={deps:a});if((a.exports||a.init)&&!a.exportsFn)a.exportsFn=i.makeShimExports(a); +b[c]=a}),j.shim=b);a.packages&&v(a.packages,function(a){var b,a="string"===typeof a?{name:a}:a;b=a.name;a.location&&(j.paths[b]=a.location);j.pkgs[b]=a.name+"/"+(a.main||"main").replace(ia,"").replace(Q,"")});B(h,function(a,b){!a.inited&&!a.map.unnormalized&&(a.map=p(b))});if(a.deps||a.callback)i.require(a.deps||[],a.callback)},makeShimExports:function(a){return function(){var b;a.init&&(b=a.init.apply(ba,arguments));return b||a.exports&&da(a.exports)}},makeRequire:function(a,e){function j(c,d,m){var n, +q;e.enableBuildCallback&&(d&&G(d))&&(d.__requireJsBuild=!0);if("string"===typeof c){if(G(d))return w(C("requireargs","Invalid require call"),m);if(a&&t(L,c))return L[c](h[a.id]);if(g.get)return g.get(i,c,a,j);n=p(c,a,!1,!0);n=n.id;return!t(r,n)?w(C("notloaded",'Module name "'+n+'" has not been loaded yet for context: '+b+(a?"":". Use require([])"))):r[n]}J();i.nextTick(function(){J();q=s(p(null,a));q.skipMap=e.skipMap;q.init(c,d,m,{enabled:!0});D()});return j}e=e||{};U(j,{isBrowser:z,toUrl:function(b){var d, +e=b.lastIndexOf("."),k=b.split("/")[0];if(-1!==e&&(!("."===k||".."===k)||1e.attachEvent.toString().indexOf("[native code"))&& +!Y?(M=!0,e.attachEvent("onreadystatechange",b.onScriptLoad)):(e.addEventListener("load",b.onScriptLoad,!1),e.addEventListener("error",b.onScriptError,!1)),e.src=d,J=e,D?y.insertBefore(e,D):y.appendChild(e),J=null,e;if(ea)try{importScripts(d),b.completeLoad(c)}catch(m){b.onError(C("importscripts","importScripts failed for "+c+" at "+d,m,[c]))}};z&&!q.skipDataMain&&T(document.getElementsByTagName("script"),function(b){y||(y=b.parentNode);if(I=b.getAttribute("data-main"))return s=I,q.baseUrl||(E=s.split("/"), +s=E.pop(),O=E.length?E.join("/")+"/":"./",q.baseUrl=O),s=s.replace(Q,""),g.jsExtRegExp.test(s)&&(s=I),q.deps=q.deps?q.deps.concat(s):[s],!0});define=function(b,c,d){var e,g;"string"!==typeof b&&(d=c,c=b,b=null);H(c)||(d=c,c=null);!c&&G(d)&&(c=[],d.length&&(d.toString().replace(ka,"").replace(la,function(b,d){c.push(d)}),c=(1===d.length?["require"]:["require","exports","module"]).concat(c)));if(M){if(!(e=J))N&&"interactive"===N.readyState||T(document.getElementsByTagName("script"),function(b){if("interactive"=== +b.readyState)return N=b}),e=N;e&&(b||(b=e.getAttribute("data-requiremodule")),g=F[e.getAttribute("data-requirecontext")])}(g?g.defQueue:R).push([b,c,d])};define.amd={jQuery:!0};g.exec=function(b){return eval(b)};g(q)}})(this); diff --git a/doc/html/mkdocs/js/search-results-template.mustache b/doc/html/mkdocs/js/search-results-template.mustache new file mode 100644 index 00000000..a8b3862f --- /dev/null +++ b/doc/html/mkdocs/js/search-results-template.mustache @@ -0,0 +1,4 @@ + diff --git a/doc/html/mkdocs/js/search.js b/doc/html/mkdocs/js/search.js new file mode 100644 index 00000000..d5c86616 --- /dev/null +++ b/doc/html/mkdocs/js/search.js @@ -0,0 +1,88 @@ +require([ + base_url + '/mkdocs/js/mustache.min.js', + base_url + '/mkdocs/js/lunr.min.js', + 'text!search-results-template.mustache', + 'text!../search_index.json', +], function (Mustache, lunr, results_template, data) { + "use strict"; + + function getSearchTerm() + { + var sPageURL = window.location.search.substring(1); + var sURLVariables = sPageURL.split('&'); + for (var i = 0; i < sURLVariables.length; i++) + { + var sParameterName = sURLVariables[i].split('='); + if (sParameterName[0] == 'q') + { + return decodeURIComponent(sParameterName[1].replace(/\+/g, '%20')); + } + } + } + + var index = lunr(function () { + this.field('title', {boost: 10}); + this.field('text'); + this.ref('location'); + }); + + data = JSON.parse(data); + var documents = {}; + + for (var i=0; i < data.docs.length; i++){ + var doc = data.docs[i]; + doc.location = base_url + doc.location; + index.add(doc); + documents[doc.location] = doc; + } + + var search = function(){ + + var query = document.getElementById('mkdocs-search-query').value; + var search_results = document.getElementById("mkdocs-search-results"); + while (search_results.firstChild) { + search_results.removeChild(search_results.firstChild); + } + + if(query === ''){ + return; + } + + var results = index.search(query); + + if (results.length > 0){ + for (var i=0; i < results.length; i++){ + var result = results[i]; + doc = documents[result.ref]; + doc.base_url = base_url; + doc.summary = doc.text.substring(0, 200); + var html = Mustache.to_html(results_template, doc); + search_results.insertAdjacentHTML('beforeend', html); + } + } else { + search_results.insertAdjacentHTML('beforeend', "

No results found

"); + } + + if(jQuery){ + /* + * We currently only automatically hide bootstrap models. This + * requires jQuery to work. + */ + jQuery('#mkdocs_search_modal a').click(function(){ + jQuery('#mkdocs_search_modal').modal('hide'); + }); + } + + }; + + var search_input = document.getElementById('mkdocs-search-query'); + + var term = getSearchTerm(); + if (term){ + search_input.value = term; + search(); + } + + search_input.addEventListener("keyup", search); + +}); diff --git a/doc/html/mkdocs/js/text.js b/doc/html/mkdocs/js/text.js new file mode 100644 index 00000000..17921b6e --- /dev/null +++ b/doc/html/mkdocs/js/text.js @@ -0,0 +1,390 @@ +/** + * @license RequireJS text 2.0.12 Copyright (c) 2010-2014, The Dojo Foundation All Rights Reserved. + * Available via the MIT or new BSD license. + * see: http://github.com/requirejs/text for details + */ +/*jslint regexp: true */ +/*global require, XMLHttpRequest, ActiveXObject, + define, window, process, Packages, + java, location, Components, FileUtils */ + +define(['module'], function (module) { + 'use strict'; + + var text, fs, Cc, Ci, xpcIsWindows, + progIds = ['Msxml2.XMLHTTP', 'Microsoft.XMLHTTP', 'Msxml2.XMLHTTP.4.0'], + xmlRegExp = /^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im, + bodyRegExp = /]*>\s*([\s\S]+)\s*<\/body>/im, + hasLocation = typeof location !== 'undefined' && location.href, + defaultProtocol = hasLocation && location.protocol && location.protocol.replace(/\:/, ''), + defaultHostName = hasLocation && location.hostname, + defaultPort = hasLocation && (location.port || undefined), + buildMap = {}, + masterConfig = (module.config && module.config()) || {}; + + text = { + version: '2.0.12', + + strip: function (content) { + //Strips declarations so that external SVG and XML + //documents can be added to a document without worry. Also, if the string + //is an HTML document, only the part inside the body tag is returned. + if (content) { + content = content.replace(xmlRegExp, ""); + var matches = content.match(bodyRegExp); + if (matches) { + content = matches[1]; + } + } else { + content = ""; + } + return content; + }, + + jsEscape: function (content) { + return content.replace(/(['\\])/g, '\\$1') + .replace(/[\f]/g, "\\f") + .replace(/[\b]/g, "\\b") + .replace(/[\n]/g, "\\n") + .replace(/[\t]/g, "\\t") + .replace(/[\r]/g, "\\r") + .replace(/[\u2028]/g, "\\u2028") + .replace(/[\u2029]/g, "\\u2029"); + }, + + createXhr: masterConfig.createXhr || function () { + //Would love to dump the ActiveX crap in here. Need IE 6 to die first. + var xhr, i, progId; + if (typeof XMLHttpRequest !== "undefined") { + return new XMLHttpRequest(); + } else if (typeof ActiveXObject !== "undefined") { + for (i = 0; i < 3; i += 1) { + progId = progIds[i]; + try { + xhr = new ActiveXObject(progId); + } catch (e) {} + + if (xhr) { + progIds = [progId]; // so faster next time + break; + } + } + } + + return xhr; + }, + + /** + * Parses a resource name into its component parts. Resource names + * look like: module/name.ext!strip, where the !strip part is + * optional. + * @param {String} name the resource name + * @returns {Object} with properties "moduleName", "ext" and "strip" + * where strip is a boolean. + */ + parseName: function (name) { + var modName, ext, temp, + strip = false, + index = name.indexOf("."), + isRelative = name.indexOf('./') === 0 || + name.indexOf('../') === 0; + + if (index !== -1 && (!isRelative || index > 1)) { + modName = name.substring(0, index); + ext = name.substring(index + 1, name.length); + } else { + modName = name; + } + + temp = ext || modName; + index = temp.indexOf("!"); + if (index !== -1) { + //Pull off the strip arg. + strip = temp.substring(index + 1) === "strip"; + temp = temp.substring(0, index); + if (ext) { + ext = temp; + } else { + modName = temp; + } + } + + return { + moduleName: modName, + ext: ext, + strip: strip + }; + }, + + xdRegExp: /^((\w+)\:)?\/\/([^\/\\]+)/, + + /** + * Is an URL on another domain. Only works for browser use, returns + * false in non-browser environments. Only used to know if an + * optimized .js version of a text resource should be loaded + * instead. + * @param {String} url + * @returns Boolean + */ + useXhr: function (url, protocol, hostname, port) { + var uProtocol, uHostName, uPort, + match = text.xdRegExp.exec(url); + if (!match) { + return true; + } + uProtocol = match[2]; + uHostName = match[3]; + + uHostName = uHostName.split(':'); + uPort = uHostName[1]; + uHostName = uHostName[0]; + + return (!uProtocol || uProtocol === protocol) && + (!uHostName || uHostName.toLowerCase() === hostname.toLowerCase()) && + ((!uPort && !uHostName) || uPort === port); + }, + + finishLoad: function (name, strip, content, onLoad) { + content = strip ? text.strip(content) : content; + if (masterConfig.isBuild) { + buildMap[name] = content; + } + onLoad(content); + }, + + load: function (name, req, onLoad, config) { + //Name has format: some.module.filext!strip + //The strip part is optional. + //if strip is present, then that means only get the string contents + //inside a body tag in an HTML string. For XML/SVG content it means + //removing the declarations so the content can be inserted + //into the current doc without problems. + + // Do not bother with the work if a build and text will + // not be inlined. + if (config && config.isBuild && !config.inlineText) { + onLoad(); + return; + } + + masterConfig.isBuild = config && config.isBuild; + + var parsed = text.parseName(name), + nonStripName = parsed.moduleName + + (parsed.ext ? '.' + parsed.ext : ''), + url = req.toUrl(nonStripName), + useXhr = (masterConfig.useXhr) || + text.useXhr; + + // Do not load if it is an empty: url + if (url.indexOf('empty:') === 0) { + onLoad(); + return; + } + + //Load the text. Use XHR if possible and in a browser. + if (!hasLocation || useXhr(url, defaultProtocol, defaultHostName, defaultPort)) { + text.get(url, function (content) { + text.finishLoad(name, parsed.strip, content, onLoad); + }, function (err) { + if (onLoad.error) { + onLoad.error(err); + } + }); + } else { + //Need to fetch the resource across domains. Assume + //the resource has been optimized into a JS module. Fetch + //by the module name + extension, but do not include the + //!strip part to avoid file system issues. + req([nonStripName], function (content) { + text.finishLoad(parsed.moduleName + '.' + parsed.ext, + parsed.strip, content, onLoad); + }); + } + }, + + write: function (pluginName, moduleName, write, config) { + if (buildMap.hasOwnProperty(moduleName)) { + var content = text.jsEscape(buildMap[moduleName]); + write.asModule(pluginName + "!" + moduleName, + "define(function () { return '" + + content + + "';});\n"); + } + }, + + writeFile: function (pluginName, moduleName, req, write, config) { + var parsed = text.parseName(moduleName), + extPart = parsed.ext ? '.' + parsed.ext : '', + nonStripName = parsed.moduleName + extPart, + //Use a '.js' file name so that it indicates it is a + //script that can be loaded across domains. + fileName = req.toUrl(parsed.moduleName + extPart) + '.js'; + + //Leverage own load() method to load plugin value, but only + //write out values that do not have the strip argument, + //to avoid any potential issues with ! in file names. + text.load(nonStripName, req, function (value) { + //Use own write() method to construct full module value. + //But need to create shell that translates writeFile's + //write() to the right interface. + var textWrite = function (contents) { + return write(fileName, contents); + }; + textWrite.asModule = function (moduleName, contents) { + return write.asModule(moduleName, fileName, contents); + }; + + text.write(pluginName, nonStripName, textWrite, config); + }, config); + } + }; + + if (masterConfig.env === 'node' || (!masterConfig.env && + typeof process !== "undefined" && + process.versions && + !!process.versions.node && + !process.versions['node-webkit'])) { + //Using special require.nodeRequire, something added by r.js. + fs = require.nodeRequire('fs'); + + text.get = function (url, callback, errback) { + try { + var file = fs.readFileSync(url, 'utf8'); + //Remove BOM (Byte Mark Order) from utf8 files if it is there. + if (file.indexOf('\uFEFF') === 0) { + file = file.substring(1); + } + callback(file); + } catch (e) { + if (errback) { + errback(e); + } + } + }; + } else if (masterConfig.env === 'xhr' || (!masterConfig.env && + text.createXhr())) { + text.get = function (url, callback, errback, headers) { + var xhr = text.createXhr(), header; + xhr.open('GET', url, true); + + //Allow plugins direct access to xhr headers + if (headers) { + for (header in headers) { + if (headers.hasOwnProperty(header)) { + xhr.setRequestHeader(header.toLowerCase(), headers[header]); + } + } + } + + //Allow overrides specified in config + if (masterConfig.onXhr) { + masterConfig.onXhr(xhr, url); + } + + xhr.onreadystatechange = function (evt) { + var status, err; + //Do not explicitly handle errors, those should be + //visible via console output in the browser. + if (xhr.readyState === 4) { + status = xhr.status || 0; + if (status > 399 && status < 600) { + //An http 4xx or 5xx error. Signal an error. + err = new Error(url + ' HTTP status: ' + status); + err.xhr = xhr; + if (errback) { + errback(err); + } + } else { + callback(xhr.responseText); + } + + if (masterConfig.onXhrComplete) { + masterConfig.onXhrComplete(xhr, url); + } + } + }; + xhr.send(null); + }; + } else if (masterConfig.env === 'rhino' || (!masterConfig.env && + typeof Packages !== 'undefined' && typeof java !== 'undefined')) { + //Why Java, why is this so awkward? + text.get = function (url, callback) { + var stringBuffer, line, + encoding = "utf-8", + file = new java.io.File(url), + lineSeparator = java.lang.System.getProperty("line.separator"), + input = new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(file), encoding)), + content = ''; + try { + stringBuffer = new java.lang.StringBuffer(); + line = input.readLine(); + + // Byte Order Mark (BOM) - The Unicode Standard, version 3.0, page 324 + // http://www.unicode.org/faq/utf_bom.html + + // Note that when we use utf-8, the BOM should appear as "EF BB BF", but it doesn't due to this bug in the JDK: + // http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4508058 + if (line && line.length() && line.charAt(0) === 0xfeff) { + // Eat the BOM, since we've already found the encoding on this file, + // and we plan to concatenating this buffer with others; the BOM should + // only appear at the top of a file. + line = line.substring(1); + } + + if (line !== null) { + stringBuffer.append(line); + } + + while ((line = input.readLine()) !== null) { + stringBuffer.append(lineSeparator); + stringBuffer.append(line); + } + //Make sure we return a JavaScript string and not a Java string. + content = String(stringBuffer.toString()); //String + } finally { + input.close(); + } + callback(content); + }; + } else if (masterConfig.env === 'xpconnect' || (!masterConfig.env && + typeof Components !== 'undefined' && Components.classes && + Components.interfaces)) { + //Avert your gaze! + Cc = Components.classes; + Ci = Components.interfaces; + Components.utils['import']('resource://gre/modules/FileUtils.jsm'); + xpcIsWindows = ('@mozilla.org/windows-registry-key;1' in Cc); + + text.get = function (url, callback) { + var inStream, convertStream, fileObj, + readData = {}; + + if (xpcIsWindows) { + url = url.replace(/\//g, '\\'); + } + + fileObj = new FileUtils.File(url); + + //XPCOM, you so crazy + try { + inStream = Cc['@mozilla.org/network/file-input-stream;1'] + .createInstance(Ci.nsIFileInputStream); + inStream.init(fileObj, 1, 0, false); + + convertStream = Cc['@mozilla.org/intl/converter-input-stream;1'] + .createInstance(Ci.nsIConverterInputStream); + convertStream.init(inStream, "utf-8", inStream.available(), + Ci.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER); + + convertStream.readString(inStream.available(), readData); + convertStream.close(); + inStream.close(); + callback(readData.value); + } catch (e) { + throw new Error((fileObj && fileObj.path || '') + ': ' + e); + } + }; + } + return text; +}); diff --git a/doc/html/mkdocs/search_index.json b/doc/html/mkdocs/search_index.json new file mode 100644 index 00000000..2222a95b --- /dev/null +++ b/doc/html/mkdocs/search_index.json @@ -0,0 +1,1519 @@ +{ + "docs": [ + { + "location": "/", + "text": "Welcome to the \nShaarli\n wiki!\n\n\nHere you can find some info on how to use, configure, tweak and solve problems with your Shaarli.\n\n\nFor general info, read the \nREADME\n.\n\n\nIf you have any questions or ideas, please join the \nchat\n (also reachable via \nIRC\n), post them in our \ngeneral discussion\n (\narchive\n) or read the current \nissues\n. If you've found a bug, please create a \nnew issue\n.\n\n\nIf you would like a feature added to Shaarli, check the issues labeled \nfeature\n, \nenhancement\n, and \nplugin\n.\n\n\nNote: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the \ndoc/\n directory of your Shaarli installation.", + "title": "Home" + }, + { + "location": "/Download-and-Installation/", + "text": "To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your \nserver\n is properly \nconfigured\n.\n\n\nSeveral releases are available:\n\n\n\n\nLatest release (recommended)\n\n\nDownload as an archive\n\n\nGet the latest released version from the \nreleases\n page.\n\n\nDownload our \nshaarli-full\n archive\n to include dependencies.\n\n\nThe current latest released version is \nv0.8.4\n\n\nOr in command lines:\n\n\n$ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip\n$ unzip shaarli-v0.8.4-full.zip\n$ mv Shaarli /path/to/shaarli/\n\n\n\n\n\n\n\n\n\n\n!\n\n\nIn most cases, download Shaarli from the \nreleases\n page. Cloning using \ngit\n or downloading Github branches as zip files requires additional steps (see below).\n\n\n\n\n\n\n\n\n\n\nUsing git\n\n\nmkdir -p /path/to/shaarli && cd /path/to/shaarli/\ngit clone -b v0.8 https://github.com/shaarli/Shaarli.git .\ncomposer install --no-dev\n\n\n\n\n\n\nStable version\n\n\nThe stable version has been experienced by Shaarli users, and will receive security updates.\n\n\nDownload as an archive\n\n\nAs a .zip archive:\n\n\n$ wget https://github.com/shaarli/Shaarli/archive/stable.zip\n$ unzip stable.zip\n$ mv Shaarli-stable /path/to/shaarli/\n\n\n\n\nAs a .tar.gz archive :\n\n\n$ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz\n$ tar xvf stable.tar.gz\n$ mv Shaarli-stable /path/to/shaarli/\n\n\n\n\nClone with Git\n\n\nComposer\n is required to build a functional Shaarli installation when pulling from git.\n\n\n$ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli/\n$ composer install --no-dev\n\n\n\n\n\n\nDevelopment version (mainline)\n\n\nUse at your own risk!\n\n\nTo get the latest changes from the \nmaster\n branch:\n\n\n# clone the repository \n$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli\n$ composer install --no-dev\n\n\n\n\n\n\nFinish Installation\n\n\nOnce Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.\n\n\n\n\nSetup your Shaarli installation, and it's ready to use!\n\n\n\n\nUpdating Shaarli\n\n\nSee \nUpgrade and Migration", + "title": "Download and Installation" + }, + { + "location": "/Download-and-Installation/#latest-release-recommended", + "text": "", + "title": "Latest release (recommended)" + }, + { + "location": "/Download-and-Installation/#download-as-an-archive", + "text": "Get the latest released version from the releases page. Download our shaarli-full archive to include dependencies. The current latest released version is v0.8.4 Or in command lines: $ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip\n$ unzip shaarli-v0.8.4-full.zip\n$ mv Shaarli /path/to/shaarli/ ! In most cases, download Shaarli from the releases page. Cloning using git or downloading Github branches as zip files requires additional steps (see below).", + "title": "Download as an archive" + }, + { + "location": "/Download-and-Installation/#using-git", + "text": "mkdir -p /path/to/shaarli && cd /path/to/shaarli/\ngit clone -b v0.8 https://github.com/shaarli/Shaarli.git .\ncomposer install --no-dev", + "title": "Using git" + }, + { + "location": "/Download-and-Installation/#stable-version", + "text": "The stable version has been experienced by Shaarli users, and will receive security updates.", + "title": "Stable version" + }, + { + "location": "/Download-and-Installation/#download-as-an-archive_1", + "text": "As a .zip archive: $ wget https://github.com/shaarli/Shaarli/archive/stable.zip\n$ unzip stable.zip\n$ mv Shaarli-stable /path/to/shaarli/ As a .tar.gz archive : $ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz\n$ tar xvf stable.tar.gz\n$ mv Shaarli-stable /path/to/shaarli/", + "title": "Download as an archive" + }, + { + "location": "/Download-and-Installation/#clone-with-git", + "text": "Composer is required to build a functional Shaarli installation when pulling from git. $ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli/\n$ composer install --no-dev", + "title": "Clone with Git" + }, + { + "location": "/Download-and-Installation/#development-version-mainline", + "text": "Use at your own risk! To get the latest changes from the master branch: # clone the repository \n$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli\n$ composer install --no-dev", + "title": "Development version (mainline)" + }, + { + "location": "/Download-and-Installation/#finish-installation", + "text": "Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser. Setup your Shaarli installation, and it's ready to use!", + "title": "Finish Installation" + }, + { + "location": "/Download-and-Installation/#updating-shaarli", + "text": "See Upgrade and Migration", + "title": "Updating Shaarli" + }, + { + "location": "/Upgrade-and-migration/", + "text": "Preparation\n\n\nNote your current version\n\n\nIf anything goes wrong, it's important for us to know which version you're upgrading from.\n\nThe current version is present in the \nversion.php\n file.\n\n\nBackup your data\n\n\nShaarli stores all user data under the \ndata\n directory:\n- \ndata/config.php\n - main configuration file\n- \ndata/datastore.php\n - bookmarked links\n- \ndata/ipbans.php\n - banned IP addresses\n- \ndata/updates.txt\n - contains all automatic update to the configuration and datastore files already run\n\n\nSee \nShaarli configuration\n for more information about Shaarli resources.\n\n\nIt is recommended to backup this repository \nbefore\n starting updating/upgrading Shaarli:\n- users with SSH access: copy or archive the directory to a temporary location\n- users with FTP access: download a local copy of your Shaarli installation using your favourite client\n\n\nMigrating data from a previous installation\n\n\nAs all user data is kept under \ndata\n, this is the only directory you need to worry about when migrating to a new installation, which corresponds to the following steps:\n\n\n\n\nbackup the \ndata\n directory\n\n\ninstall or update Shaarli:\n\n\nfresh installation - see \nDownload and installation\n\n\nupdate - see the following sections\n\n\n\n\n\n\ncheck or restore the \ndata\n directory\n\n\n\n\nRecommended : Upgrading from release archives\n\n\nAll tagged revisions can be downloaded as tarballs or ZIP archives from the \nreleases\n page.\n\n\nWe recommend that you use the latest release tarball with the \n-full\n suffix. It contains the dependencies, please read \nDownload and installation\n for \ngit\n complete instructions.\n\n\nOnce downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the \ndata\n directory!\n\n\nAfter upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to \ndata/config.json.php\n (see \nShaarli configuration\n for more details).\n\n\nUpgrading with Git\n\n\nUpdating a community Shaarli\n\n\nIf you have installed Shaarli from the \ncommunity Git repository\n, simply \npull new changes\n from your local clone:\n\n\n$ cd /path/to/shaarli\n$ git pull\n\nFrom github.com:shaarli/Shaarli\n * branch master -> FETCH_HEAD\nUpdating ebd67c6..521f0e6\nFast-forward\n application/Url.php | 1 +\n shaarli_version.php | 2 +-\n tests/Url/UrlTest.php | 1 +\n 3 files changed, 3 insertions(+), 1 deletion(-)\n\n\n\n\nShaarli >= \nv0.8.x\n: install/update third-party PHP dependencies using \nComposer\n:\n\n\n$ composer install --no-dev\n\nLoading composer repositories with package information\nUpdating dependencies\n - Installing shaarli/netscape-bookmark-parser (v1.0.1)\n Downloading: 100%\n\n\n\n\nMigrating and upgrading from Sebsauvage's repository\n\n\nIf you have installed Shaarli from \nSebsauvage's original Git repository\n, you can use \nGit remotes\n to update your working copy.\n\n\nThe following guide assumes that:\n- you have a basic knowledge of Git \nbranching\n and \nremote repositories\n\n- the default remote is named \norigin\n and points to Sebsauvage's repository\n- the current branch is \nmaster\n\n - if you have personal branches containing customizations, you will need to \nrebase them\n after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break!\n- the working copy is clean:\n - no versioned file has been locally modified\n - no untracked files are present\n\n\nStep 0: show repository information\n\n\n$ cd /path/to/shaarli\n\n$ git remote -v\norigin https://github.com/sebsauvage/Shaarli (fetch)\norigin https://github.com/sebsauvage/Shaarli (push)\n\n$ git branch -vv\n* master 029f75f [origin/master] Update README.md\n\n$ git status\nOn branch master\nYour branch is up-to-date with 'origin/master'.\nnothing to commit, working directory clean\n\n\n\n\nStep 1: update Git remotes\n\n\n$ git remote rename origin sebsauvage\n$ git remote -v\nsebsauvage https://github.com/sebsauvage/Shaarli (fetch)\nsebsauvage https://github.com/sebsauvage/Shaarli (push)\n\n$ git remote add origin https://github.com/shaarli/Shaarli\n$ git fetch origin\n\nremote: Counting objects: 3015, done.\nremote: Compressing objects: 100% (19/19), done.\nremote: Total 3015 (delta 446), reused 457 (delta 446), pack-reused 2550\nReceiving objects: 100% (3015/3015), 2.59 MiB | 918.00 KiB/s, done.\nResolving deltas: 100% (1899/1899), completed with 48 local objects.\nFrom https://github.com/shaarli/Shaarli\n * [new branch] master -> origin/master\n * [new branch] stable -> origin/stable\n[...]\n * [new tag] v0.6.4 -> v0.6.4\n * [new tag] v0.7.0 -> v0.7.0\n\n\n\n\nStep 2: use the stable community branch\n\n\n$ git checkout origin/stable -b stable\nBranch stable set up to track remote branch stable from origin.\nSwitched to a new branch 'stable'\n\n$ git branch -vv\n master 029f75f [sebsauvage/master] Update README.md\n* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5\n\n\n\n\nShaarli >= \nv0.8.x\n: install/update third-party PHP dependencies using \nComposer\n:\n\n\n$ composer install --no-dev\n\nLoading composer repositories with package information\nUpdating dependencies\n - Installing shaarli/netscape-bookmark-parser (v1.0.1)\n Downloading: 100%\n\n\n\n\nOptionally, you can delete information related to the legacy version:\n\n\n$ git branch -D master\nDeleted branch master (was 029f75f).\n\n$ git remote remove sebsauvage\n\n$ git remote -v\norigin https://github.com/shaarli/Shaarli (fetch)\norigin https://github.com/shaarli/Shaarli (push)\n\n$ git gc\nCounting objects: 3317, done.\nDelta compression using up to 8 threads.\nCompressing objects: 100% (1237/1237), done.\nWriting objects: 100% (3317/3317), done.\nTotal 3317 (delta 2050), reused 3301 (delta 2034)to\n\n\n\n\nStep 3: configuration\n\n\nAfter migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to \ndata/config.php\n (see \nShaarli configuration\n for more details).\n\n\nTroubleshooting\n\n\nIf the solutions provided here doesn't work, please open an issue specifying which version you're upgrading from and to.\n\n\nYou must specify an integer as a key\n\n\nIn \nv0.8.1\n we changed how link keys are handled (from timestamps to incremental integers).\nTake a look at \ndata/updates.txt\n content.\n\n\nupdates.txt\n contains \nupdateMethodDatastoreIds\n\n\nTry to delete it and refresh your page while being logged in.\n\n\nupdates.txt\n doesn't exists or doesn't contain \nupdateMethodDatastoreIds\n\n\n\n\nCreate \ndata/updates.txt\n if it doesn't exist.\n\n\nPaste this string in the update file \n;updateMethodRenameDashTags;\n\n\nLogin to Shaarli.\n\n\nDelete the update file.\n\n\nRefresh.", + "title": "Upgrade and migration" + }, + { + "location": "/Upgrade-and-migration/#preparation", + "text": "", + "title": "Preparation" + }, + { + "location": "/Upgrade-and-migration/#note-your-current-version", + "text": "If anything goes wrong, it's important for us to know which version you're upgrading from. \nThe current version is present in the version.php file.", + "title": "Note your current version" + }, + { + "location": "/Upgrade-and-migration/#backup-your-data", + "text": "Shaarli stores all user data under the data directory:\n- data/config.php - main configuration file\n- data/datastore.php - bookmarked links\n- data/ipbans.php - banned IP addresses\n- data/updates.txt - contains all automatic update to the configuration and datastore files already run See Shaarli configuration for more information about Shaarli resources. It is recommended to backup this repository before starting updating/upgrading Shaarli:\n- users with SSH access: copy or archive the directory to a temporary location\n- users with FTP access: download a local copy of your Shaarli installation using your favourite client", + "title": "Backup your data" + }, + { + "location": "/Upgrade-and-migration/#migrating-data-from-a-previous-installation", + "text": "As all user data is kept under data , this is the only directory you need to worry about when migrating to a new installation, which corresponds to the following steps: backup the data directory install or update Shaarli: fresh installation - see Download and installation update - see the following sections check or restore the data directory", + "title": "Migrating data from a previous installation" + }, + { + "location": "/Upgrade-and-migration/#recommended-upgrading-from-release-archives", + "text": "All tagged revisions can be downloaded as tarballs or ZIP archives from the releases page. We recommend that you use the latest release tarball with the -full suffix. It contains the dependencies, please read Download and installation for git complete instructions. Once downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the data directory! After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to data/config.json.php (see Shaarli configuration for more details).", + "title": "Recommended : Upgrading from release archives" + }, + { + "location": "/Upgrade-and-migration/#upgrading-with-git", + "text": "", + "title": "Upgrading with Git" + }, + { + "location": "/Upgrade-and-migration/#updating-a-community-shaarli", + "text": "If you have installed Shaarli from the community Git repository , simply pull new changes from your local clone: $ cd /path/to/shaarli\n$ git pull\n\nFrom github.com:shaarli/Shaarli\n * branch master -> FETCH_HEAD\nUpdating ebd67c6..521f0e6\nFast-forward\n application/Url.php | 1 +\n shaarli_version.php | 2 +-\n tests/Url/UrlTest.php | 1 +\n 3 files changed, 3 insertions(+), 1 deletion(-) Shaarli >= v0.8.x : install/update third-party PHP dependencies using Composer : $ composer install --no-dev\n\nLoading composer repositories with package information\nUpdating dependencies\n - Installing shaarli/netscape-bookmark-parser (v1.0.1)\n Downloading: 100%", + "title": "Updating a community Shaarli" + }, + { + "location": "/Upgrade-and-migration/#migrating-and-upgrading-from-sebsauvages-repository", + "text": "If you have installed Shaarli from Sebsauvage's original Git repository , you can use Git remotes to update your working copy. The following guide assumes that:\n- you have a basic knowledge of Git branching and remote repositories \n- the default remote is named origin and points to Sebsauvage's repository\n- the current branch is master \n - if you have personal branches containing customizations, you will need to rebase them after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break!\n- the working copy is clean:\n - no versioned file has been locally modified\n - no untracked files are present", + "title": "Migrating and upgrading from Sebsauvage's repository" + }, + { + "location": "/Upgrade-and-migration/#step-0-show-repository-information", + "text": "$ cd /path/to/shaarli\n\n$ git remote -v\norigin https://github.com/sebsauvage/Shaarli (fetch)\norigin https://github.com/sebsauvage/Shaarli (push)\n\n$ git branch -vv\n* master 029f75f [origin/master] Update README.md\n\n$ git status\nOn branch master\nYour branch is up-to-date with 'origin/master'.\nnothing to commit, working directory clean", + "title": "Step 0: show repository information" + }, + { + "location": "/Upgrade-and-migration/#step-1-update-git-remotes", + "text": "$ git remote rename origin sebsauvage\n$ git remote -v\nsebsauvage https://github.com/sebsauvage/Shaarli (fetch)\nsebsauvage https://github.com/sebsauvage/Shaarli (push)\n\n$ git remote add origin https://github.com/shaarli/Shaarli\n$ git fetch origin\n\nremote: Counting objects: 3015, done.\nremote: Compressing objects: 100% (19/19), done.\nremote: Total 3015 (delta 446), reused 457 (delta 446), pack-reused 2550\nReceiving objects: 100% (3015/3015), 2.59 MiB | 918.00 KiB/s, done.\nResolving deltas: 100% (1899/1899), completed with 48 local objects.\nFrom https://github.com/shaarli/Shaarli\n * [new branch] master -> origin/master\n * [new branch] stable -> origin/stable\n[...]\n * [new tag] v0.6.4 -> v0.6.4\n * [new tag] v0.7.0 -> v0.7.0", + "title": "Step 1: update Git remotes" + }, + { + "location": "/Upgrade-and-migration/#step-2-use-the-stable-community-branch", + "text": "$ git checkout origin/stable -b stable\nBranch stable set up to track remote branch stable from origin.\nSwitched to a new branch 'stable'\n\n$ git branch -vv\n master 029f75f [sebsauvage/master] Update README.md\n* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5 Shaarli >= v0.8.x : install/update third-party PHP dependencies using Composer : $ composer install --no-dev\n\nLoading composer repositories with package information\nUpdating dependencies\n - Installing shaarli/netscape-bookmark-parser (v1.0.1)\n Downloading: 100% Optionally, you can delete information related to the legacy version: $ git branch -D master\nDeleted branch master (was 029f75f).\n\n$ git remote remove sebsauvage\n\n$ git remote -v\norigin https://github.com/shaarli/Shaarli (fetch)\norigin https://github.com/shaarli/Shaarli (push)\n\n$ git gc\nCounting objects: 3317, done.\nDelta compression using up to 8 threads.\nCompressing objects: 100% (1237/1237), done.\nWriting objects: 100% (3317/3317), done.\nTotal 3317 (delta 2050), reused 3301 (delta 2034)to", + "title": "Step 2: use the stable community branch" + }, + { + "location": "/Upgrade-and-migration/#step-3-configuration", + "text": "After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to data/config.php (see Shaarli configuration for more details).", + "title": "Step 3: configuration" + }, + { + "location": "/Upgrade-and-migration/#troubleshooting", + "text": "If the solutions provided here doesn't work, please open an issue specifying which version you're upgrading from and to.", + "title": "Troubleshooting" + }, + { + "location": "/Upgrade-and-migration/#you-must-specify-an-integer-as-a-key", + "text": "In v0.8.1 we changed how link keys are handled (from timestamps to incremental integers).\nTake a look at data/updates.txt content.", + "title": "You must specify an integer as a key" + }, + { + "location": "/Upgrade-and-migration/#updatestxt-contains-updatemethoddatastoreids", + "text": "Try to delete it and refresh your page while being logged in.", + "title": "updates.txt contains updateMethodDatastoreIds" + }, + { + "location": "/Upgrade-and-migration/#updatestxt-doesnt-exists-or-doesnt-contain-updatemethoddatastoreids", + "text": "Create data/updates.txt if it doesn't exist. Paste this string in the update file ;updateMethodRenameDashTags; Login to Shaarli. Delete the update file. Refresh.", + "title": "updates.txt doesn't exists or doesn't contain updateMethodDatastoreIds" + }, + { + "location": "/Server-requirements/", + "text": "PHP\n\n\nRelease information\n\n\n\n\nPHP: Supported versions\n\n\nPHP: Unsupported versions\n \n(EOL - End Of Life)\n\n\nPHP 7 Changelog\n\n\nPHP 5 Changelog\n\n\nPHP: Bugs\n\n\n\n\nSupported versions\n\n\n\n\n\n\n\n\nVersion\n\n\nStatus\n\n\nShaarli compatibility\n\n\n\n\n\n\n\n\n\n\n7.1\n\n\nSupported (v0.9.x)\n\n\n:white_check_mark:\n\n\n\n\n\n\n7.0\n\n\nSupported\n\n\n:white_check_mark:\n\n\n\n\n\n\n5.6\n\n\nSupported\n\n\n:white_check_mark:\n\n\n\n\n\n\n5.5\n\n\nEOL: 2016-07-10\n\n\n:white_check_mark:\n\n\n\n\n\n\n5.4\n\n\nEOL: 2015-09-14\n\n\n:white_check_mark: (up to Shaarli 0.8.x)\n\n\n\n\n\n\n5.3\n\n\nEOL: 2014-08-14\n\n\n:white_check_mark: (up to Shaarli 0.8.x)\n\n\n\n\n\n\n\n\nSee also:\n- \nTravis configuration\n\n\nDependency management\n\n\nStarting with Shaarli \nv0.8.x\n, \nComposer\n is used to resolve,\ndownload and install third-party PHP dependencies.\n\n\n\n\n\n\n\n\nLibrary\n\n\nRequired?\n\n\nUsage\n\n\n\n\n\n\n\n\n\n\nshaarli/netscape-bookmark-parser\n\n\nAll\n\n\nImport bookmarks from Netscape files\n\n\n\n\n\n\nerusev/parsedown\n\n\nAll\n\n\nParse MarkDown syntax for the MarkDown plugin\n\n\n\n\n\n\nslim/slim\n\n\nAll\n\n\nHandle routes and middleware for the REST API\n\n\n\n\n\n\n\n\nExtensions\n\n\n\n\n\n\n\n\nExtension\n\n\nRequired?\n\n\nUsage\n\n\n\n\n\n\n\n\n\n\nopenssl\n\n\nAll\n\n\nOpenSSL, HTTPS\n\n\n\n\n\n\nphp-mbstring\n\n\nCentOS, Fedora, RHEL, Windows\n\n\nmultibyte (Unicode) string support\n\n\n\n\n\n\nphp-gd\n\n\noptional\n\n\nthumbnail resizing\n\n\n\n\n\n\nphp-intl\n\n\noptional\n\n\nlocalized text sorting (e.g. \ne->\u00e8->f\n)\n\n\n\n\n\n\nphp-curl\n\n\noptional\n\n\nusing cURL for fetching webpages and thumbnails in a more robust way", + "title": "Server requirements" + }, + { + "location": "/Server-requirements/#php", + "text": "", + "title": "PHP" + }, + { + "location": "/Server-requirements/#release-information", + "text": "PHP: Supported versions PHP: Unsupported versions (EOL - End Of Life) PHP 7 Changelog PHP 5 Changelog PHP: Bugs", + "title": "Release information" + }, + { + "location": "/Server-requirements/#supported-versions", + "text": "Version Status Shaarli compatibility 7.1 Supported (v0.9.x) :white_check_mark: 7.0 Supported :white_check_mark: 5.6 Supported :white_check_mark: 5.5 EOL: 2016-07-10 :white_check_mark: 5.4 EOL: 2015-09-14 :white_check_mark: (up to Shaarli 0.8.x) 5.3 EOL: 2014-08-14 :white_check_mark: (up to Shaarli 0.8.x) See also:\n- Travis configuration", + "title": "Supported versions" + }, + { + "location": "/Server-requirements/#dependency-management", + "text": "Starting with Shaarli v0.8.x , Composer is used to resolve,\ndownload and install third-party PHP dependencies. Library Required? Usage shaarli/netscape-bookmark-parser All Import bookmarks from Netscape files erusev/parsedown All Parse MarkDown syntax for the MarkDown plugin slim/slim All Handle routes and middleware for the REST API", + "title": "Dependency management" + }, + { + "location": "/Server-requirements/#extensions", + "text": "Extension Required? Usage openssl All OpenSSL, HTTPS php-mbstring CentOS, Fedora, RHEL, Windows multibyte (Unicode) string support php-gd optional thumbnail resizing php-intl optional localized text sorting (e.g. e->\u00e8->f ) php-curl optional using cURL for fetching webpages and thumbnails in a more robust way", + "title": "Extensions" + }, + { + "location": "/Server-configuration/", + "text": "Example virtual host configurations for popular web servers\n\n\n\n\nApache\n\n\nNginx\n\n\n\n\nPrerequisites\n\n\nShaarli\n\n\n\n\nShaarli is installed in a directory readable/writeable by the user\n\n\nthe correct read/write permissions have been granted to the web server \nuser and/or group\n\n\nfor HTTPS / SSL:\n\n\na key pair (public, private) and a certificate have been generated\n\n\nthe appropriate server SSL extension is installed and active\n\n\n\n\nHTTPS, TLS and self-signed certificates\n\n\nRelated guides:\n\n \nHow to Create Self-Signed SSL Certificates with OpenSSL\n\n\n \nHow do I create my own Certificate Authority?\n\n* Generate a self-signed certificate (will trigger browser warnings) with apache2: \nmake-ssl-cert generate-default-snakeoil --force-overwrite\n will create \n/etc/ssl/certs/ssl-cert-snakeoil.pem\n and \n/etc/ssl/private/ssl-cert-snakeoil.key\n\n\nProxies\n\n\nIf Shaarli is served behind a proxy (i.e. there is a proxy server between clients and the web server hosting Shaarli), please refer to the proxy server documentation for proper configuration. In particular, you have to ensure that the following server variables are properly set:\n- \nX-Forwarded-Proto\n;\n- \nX-Forwarded-Host\n;\n- \nX-Forwarded-For\n.\n\n\nSee also \nproxy-related\n issues.\n\n\nApache\n\n\nMinimal\n\n\n\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n\n\n\n\nDebug - Log all the things!\n\n\nThis configuration will log both Apache and PHP errors, which may prove useful to identify server configuration errors.\n\n\nSee:\n\n \nApache/PHP - error log per VirtualHost\n (StackOverflow)\n\n \nPHP: php_value vs php_admin_value and the use of php_flag explained\n\n\n\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n php_flag log_errors on\n php_flag display_errors on\n php_value error_reporting 2147483647\n php_value error_log /var/log/apache2/shaarli-php-error.log\n\n\n\n\n\nStandard - Keep access and error logs\n\n\n\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n\n\n\n\nParanoid - Redirect HTTP (:80) to HTTPS (:443)\n\n\nSee \nServer-side TLS\n (Mozilla).\n\n\n\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n SSLEngine on\n SSLCertificateFile /absolute/path/to/the/website/certificate.pem\n SSLCertificateKeyFile /absolute/path/to/the/website/key.key\n\n \n AllowOverride All\n Options Indexes FollowSymLinks MultiViews\n Order allow,deny\n allow from all\n \n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n\n ServerName shaarli.my-domain.org\n Redirect 301 / https://shaarli.my-domain.org\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n\n\n\n\n.htaccess\n\n\nShaarli use \n.htaccess\n Apache files to deny access to files that shouldn't be directly accessed (datastore, config, etc.). You need the directive \nAllowOverride All\n in your virtual host configuration for them to work.\n\n\nWarning\n: If you use Apache 2.2 or lower, you need \nmod_version\n to be installed and enabled.\n\n\nApache module \nmod_rewrite\n \nmust\n be enabled to use the REST API. URL rewriting rules for the Slim microframework are stated in the root \n.htaccess\n file.\n\n\nLightHttpd\n\n\nNginx\n\n\nForeword\n\n\nNginx does not natively interpret PHP scripts; to this effect, we will run a \nFastCGI\n service, to which Nginx's FastCGI module will proxy all requests to PHP resources.\n\n\nRequired packages:\n- \nnginx\n\n- \nphp-fpm\n - PHP FastCGI Process Manager\n\n\nOfficial documentation:\n- \nBeginner's guide\n\n- \nngx_http_fastcgi_module\n\n- \nPitfalls\n\n\nCommunity resources:\n- \nServer-side TLS (Nginx)\n (Mozilla)\n- \nPHP configuration examples\n (Karl Blessing)\n\n\nCommon setup\n\n\nOnce Nginx and PHP-FPM are installed, we need to ensure:\n- Nginx and PHP-FPM are running using the \nsame user and group\n\n- both these user and group have\n - \nread\n permissions for Shaarli resources\n - \nexecute\n permissions for Shaarli directories \nAND\n their parent directories\n\n\nOn a production server:\n- \nuser:group\n will likely be \nhttp:http\n, \nwww:www\n or \nwww-data:www-data\n\n- files will be located under \n/var/www\n, \n/var/http\n or \n/usr/share/nginx\n\n\nOn a development server:\n- files may be located in a user's home directory\n- in this case, make sure both Nginx and PHP-FPM are running as the local user/group!\n\n\nFor all following configuration examples, this user/group pair will be used:\n- \nuser:group = john:users\n,\n\n\nwhich corresponds to the following service configuration:\n\n\n; /etc/php/php-fpm.conf\nuser = john\ngroup = users\n\n[...]\nlisten.owner = john\nlisten.group = users\n\n\n\n\n# /etc/nginx/nginx.conf\nuser john users;\n\nhttp {\n [...]\n}\n\n\n\n\n(Optional) Increase the maximum file upload size\n\n\nSome bookmark dumps generated by web browsers can be \nhuge\n due to the presence of Base64-encoded images and favicons, as well as extra verbosity when nesting links in (sub-)folders.\n\n\nTo increase upload size, you will need to modify both nginx and PHP configuration:\n\n\n# /etc/nginx/nginx.conf\n\nhttp {\n [...]\n\n client_max_body_size 10m;\n\n [...]\n}\n\n\n\n\n# /etc/php5/fpm/php.ini\n\n[...]\npost_max_size = 10M\n[...]\nupload_max_filesize = 10M\n\n\n\n\nMinimal\n\n\nWARNING: Use for development only!\n \n\n\nuser john users;\nworker_processes 1;\nevents {\n worker_connections 1024;\n}\n\nhttp {\n include mime.types;\n default_type application/octet-stream;\n keepalive_timeout 20;\n\n index index.html index.php;\n\n server {\n listen 80;\n server_name localhost;\n root /home/john/web;\n\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n location /shaarli/ {\n try_files $uri /shaarli/index.php$is_args$args;\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location ~ (index)\\.php$ {\n try_files $uri =404;\n fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;\n fastcgi_index index.php;\n include fastcgi.conf;\n }\n }\n}\n\n\n\n\nModular\n\n\nThe previous setup is sufficient for development purposes, but has several major caveats:\n- every content that does not match the PHP rule will be sent to client browsers:\n - dotfiles - in our case, \n.htaccess\n\n - temporary files, e.g. Vim or Emacs files: \nindex.php~\n\n- asset / static resource caching is not optimized\n- if serving several PHP sites, there will be a lot of duplication: \nlocation /shaarli/\n, \nlocation /mysite/\n, etc.\n\n\nTo solve this, we will split Nginx configuration in several parts, that will be included when needed:\n\n\n# /etc/nginx/deny.conf\nlocation ~ /\\. {\n # deny access to dotfiles\n access_log off;\n log_not_found off;\n deny all;\n}\n\nlocation ~ ~$ {\n # deny access to temp editor files, e.g. \"script.php~\"\n access_log off;\n log_not_found off;\n deny all;\n}\n\n\n\n\n# /etc/nginx/php.conf\nlocation ~ (index)\\.php$ {\n # Slim - split URL path into (script_filename, path_info)\n try_files $uri =404;\n fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n\n # filter and proxy PHP requests to PHP-FPM\n fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;\n fastcgi_index index.php;\n include fastcgi.conf;\n}\n\nlocation ~ \\.php$ {\n # deny access to all other PHP scripts\n deny all;\n}\n\n\n\n\n# /etc/nginx/static_assets.conf\nlocation ~* \\.(?:ico|css|js|gif|jpe?g|png)$ {\n expires max;\n add_header Pragma public;\n add_header Cache-Control \"public, must-revalidate, proxy-revalidate\";\n}\n\n\n\n\n# /etc/nginx/nginx.conf\n[...]\n\nhttp {\n [...]\n\n root /home/john/web;\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n server {\n # virtual host for a first domain\n listen 80;\n server_name my.first.domain.org;\n\n location /shaarli/ {\n # Slim - rewrite URLs\n try_files $uri /shaarli/index.php$is_args$args;\n\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location = /shaarli/favicon.ico {\n # serve the Shaarli favicon from its custom location\n alias /var/www/shaarli/images/favicon.ico;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n\n server {\n # virtual host for a second domain\n listen 80;\n server_name second.domain.com;\n\n location /minigal/ {\n access_log /var/log/nginx/minigal.access.log;\n error_log /var/log/nginx/minigal.error.log;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n}\n\n\n\n\nRedirect HTTP to HTTPS\n\n\nAssuming you have generated a (self-signed) key and certificate, and they are located under \n/home/john/ssl/localhost.{key,crt}\n, it is pretty straightforward to set an HTTP (:80) to HTTPS (:443) redirection to force SSL/TLS usage.\n\n\n# /etc/nginx/nginx.conf\n[...]\n\nhttp {\n [...]\n\n index index.html index.php;\n\n root /home/john/web;\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n server {\n listen 80;\n server_name localhost;\n\n return 301 https://localhost$request_uri;\n }\n\n server {\n listen 443 ssl;\n server_name localhost;\n\n ssl_certificate /home/john/ssl/localhost.crt;\n ssl_certificate_key /home/john/ssl/localhost.key;\n\n location /shaarli/ {\n # Slim - rewrite URLs\n try_files $uri /index.php$is_args$args;\n\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location = /shaarli/favicon.ico {\n # serve the Shaarli favicon from its custom location\n alias /var/www/shaarli/images/favicon.ico;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n}", + "title": "Server configuration" + }, + { + "location": "/Server-configuration/#prerequisites", + "text": "", + "title": "Prerequisites" + }, + { + "location": "/Server-configuration/#shaarli", + "text": "Shaarli is installed in a directory readable/writeable by the user the correct read/write permissions have been granted to the web server user and/or group for HTTPS / SSL: a key pair (public, private) and a certificate have been generated the appropriate server SSL extension is installed and active", + "title": "Shaarli" + }, + { + "location": "/Server-configuration/#https-tls-and-self-signed-certificates", + "text": "Related guides: How to Create Self-Signed SSL Certificates with OpenSSL How do I create my own Certificate Authority? \n* Generate a self-signed certificate (will trigger browser warnings) with apache2: make-ssl-cert generate-default-snakeoil --force-overwrite will create /etc/ssl/certs/ssl-cert-snakeoil.pem and /etc/ssl/private/ssl-cert-snakeoil.key", + "title": "HTTPS, TLS and self-signed certificates" + }, + { + "location": "/Server-configuration/#proxies", + "text": "If Shaarli is served behind a proxy (i.e. there is a proxy server between clients and the web server hosting Shaarli), please refer to the proxy server documentation for proper configuration. In particular, you have to ensure that the following server variables are properly set:\n- X-Forwarded-Proto ;\n- X-Forwarded-Host ;\n- X-Forwarded-For . See also proxy-related issues.", + "title": "Proxies" + }, + { + "location": "/Server-configuration/#apache", + "text": "", + "title": "Apache" + }, + { + "location": "/Server-configuration/#minimal", + "text": "\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n", + "title": "Minimal" + }, + { + "location": "/Server-configuration/#debug-log-all-the-things", + "text": "This configuration will log both Apache and PHP errors, which may prove useful to identify server configuration errors. See: Apache/PHP - error log per VirtualHost (StackOverflow) PHP: php_value vs php_admin_value and the use of php_flag explained \n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n php_flag log_errors on\n php_flag display_errors on\n php_value error_reporting 2147483647\n php_value error_log /var/log/apache2/shaarli-php-error.log\n", + "title": "Debug - Log all the things!" + }, + { + "location": "/Server-configuration/#standard-keep-access-and-error-logs", + "text": "\n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n", + "title": "Standard - Keep access and error logs" + }, + { + "location": "/Server-configuration/#paranoid-redirect-http-80-to-https-443", + "text": "See Server-side TLS (Mozilla). \n ServerName shaarli.my-domain.org\n DocumentRoot /absolute/path/to/shaarli/\n\n SSLEngine on\n SSLCertificateFile /absolute/path/to/the/website/certificate.pem\n SSLCertificateKeyFile /absolute/path/to/the/website/key.key\n\n \n AllowOverride All\n Options Indexes FollowSymLinks MultiViews\n Order allow,deny\n allow from all\n \n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n\n\n ServerName shaarli.my-domain.org\n Redirect 301 / https://shaarli.my-domain.org\n\n LogLevel warn\n ErrorLog /var/log/apache2/shaarli-error.log\n CustomLog /var/log/apache2/shaarli-access.log combined\n", + "title": "Paranoid - Redirect HTTP (:80) to HTTPS (:443)" + }, + { + "location": "/Server-configuration/#htaccess", + "text": "Shaarli use .htaccess Apache files to deny access to files that shouldn't be directly accessed (datastore, config, etc.). You need the directive AllowOverride All in your virtual host configuration for them to work. Warning : If you use Apache 2.2 or lower, you need mod_version to be installed and enabled. Apache module mod_rewrite must be enabled to use the REST API. URL rewriting rules for the Slim microframework are stated in the root .htaccess file.", + "title": ".htaccess" + }, + { + "location": "/Server-configuration/#lighthttpd", + "text": "", + "title": "LightHttpd" + }, + { + "location": "/Server-configuration/#nginx", + "text": "", + "title": "Nginx" + }, + { + "location": "/Server-configuration/#foreword", + "text": "Nginx does not natively interpret PHP scripts; to this effect, we will run a FastCGI service, to which Nginx's FastCGI module will proxy all requests to PHP resources. Required packages:\n- nginx \n- php-fpm - PHP FastCGI Process Manager Official documentation:\n- Beginner's guide \n- ngx_http_fastcgi_module \n- Pitfalls Community resources:\n- Server-side TLS (Nginx) (Mozilla)\n- PHP configuration examples (Karl Blessing)", + "title": "Foreword" + }, + { + "location": "/Server-configuration/#common-setup", + "text": "Once Nginx and PHP-FPM are installed, we need to ensure:\n- Nginx and PHP-FPM are running using the same user and group \n- both these user and group have\n - read permissions for Shaarli resources\n - execute permissions for Shaarli directories AND their parent directories On a production server:\n- user:group will likely be http:http , www:www or www-data:www-data \n- files will be located under /var/www , /var/http or /usr/share/nginx On a development server:\n- files may be located in a user's home directory\n- in this case, make sure both Nginx and PHP-FPM are running as the local user/group! For all following configuration examples, this user/group pair will be used:\n- user:group = john:users , which corresponds to the following service configuration: ; /etc/php/php-fpm.conf\nuser = john\ngroup = users\n\n[...]\nlisten.owner = john\nlisten.group = users # /etc/nginx/nginx.conf\nuser john users;\n\nhttp {\n [...]\n}", + "title": "Common setup" + }, + { + "location": "/Server-configuration/#optional-increase-the-maximum-file-upload-size", + "text": "Some bookmark dumps generated by web browsers can be huge due to the presence of Base64-encoded images and favicons, as well as extra verbosity when nesting links in (sub-)folders. To increase upload size, you will need to modify both nginx and PHP configuration: # /etc/nginx/nginx.conf\n\nhttp {\n [...]\n\n client_max_body_size 10m;\n\n [...]\n} # /etc/php5/fpm/php.ini\n\n[...]\npost_max_size = 10M\n[...]\nupload_max_filesize = 10M", + "title": "(Optional) Increase the maximum file upload size" + }, + { + "location": "/Server-configuration/#minimal_1", + "text": "WARNING: Use for development only! user john users;\nworker_processes 1;\nevents {\n worker_connections 1024;\n}\n\nhttp {\n include mime.types;\n default_type application/octet-stream;\n keepalive_timeout 20;\n\n index index.html index.php;\n\n server {\n listen 80;\n server_name localhost;\n root /home/john/web;\n\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n location /shaarli/ {\n try_files $uri /shaarli/index.php$is_args$args;\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location ~ (index)\\.php$ {\n try_files $uri =404;\n fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;\n fastcgi_index index.php;\n include fastcgi.conf;\n }\n }\n}", + "title": "Minimal" + }, + { + "location": "/Server-configuration/#modular", + "text": "The previous setup is sufficient for development purposes, but has several major caveats:\n- every content that does not match the PHP rule will be sent to client browsers:\n - dotfiles - in our case, .htaccess \n - temporary files, e.g. Vim or Emacs files: index.php~ \n- asset / static resource caching is not optimized\n- if serving several PHP sites, there will be a lot of duplication: location /shaarli/ , location /mysite/ , etc. To solve this, we will split Nginx configuration in several parts, that will be included when needed: # /etc/nginx/deny.conf\nlocation ~ /\\. {\n # deny access to dotfiles\n access_log off;\n log_not_found off;\n deny all;\n}\n\nlocation ~ ~$ {\n # deny access to temp editor files, e.g. \"script.php~\"\n access_log off;\n log_not_found off;\n deny all;\n} # /etc/nginx/php.conf\nlocation ~ (index)\\.php$ {\n # Slim - split URL path into (script_filename, path_info)\n try_files $uri =404;\n fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n\n # filter and proxy PHP requests to PHP-FPM\n fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;\n fastcgi_index index.php;\n include fastcgi.conf;\n}\n\nlocation ~ \\.php$ {\n # deny access to all other PHP scripts\n deny all;\n} # /etc/nginx/static_assets.conf\nlocation ~* \\.(?:ico|css|js|gif|jpe?g|png)$ {\n expires max;\n add_header Pragma public;\n add_header Cache-Control \"public, must-revalidate, proxy-revalidate\";\n} # /etc/nginx/nginx.conf\n[...]\n\nhttp {\n [...]\n\n root /home/john/web;\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n server {\n # virtual host for a first domain\n listen 80;\n server_name my.first.domain.org;\n\n location /shaarli/ {\n # Slim - rewrite URLs\n try_files $uri /shaarli/index.php$is_args$args;\n\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location = /shaarli/favicon.ico {\n # serve the Shaarli favicon from its custom location\n alias /var/www/shaarli/images/favicon.ico;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n\n server {\n # virtual host for a second domain\n listen 80;\n server_name second.domain.com;\n\n location /minigal/ {\n access_log /var/log/nginx/minigal.access.log;\n error_log /var/log/nginx/minigal.error.log;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n}", + "title": "Modular" + }, + { + "location": "/Server-configuration/#redirect-http-to-https", + "text": "Assuming you have generated a (self-signed) key and certificate, and they are located under /home/john/ssl/localhost.{key,crt} , it is pretty straightforward to set an HTTP (:80) to HTTPS (:443) redirection to force SSL/TLS usage. # /etc/nginx/nginx.conf\n[...]\n\nhttp {\n [...]\n\n index index.html index.php;\n\n root /home/john/web;\n access_log /var/log/nginx/access.log;\n error_log /var/log/nginx/error.log;\n\n server {\n listen 80;\n server_name localhost;\n\n return 301 https://localhost$request_uri;\n }\n\n server {\n listen 443 ssl;\n server_name localhost;\n\n ssl_certificate /home/john/ssl/localhost.crt;\n ssl_certificate_key /home/john/ssl/localhost.key;\n\n location /shaarli/ {\n # Slim - rewrite URLs\n try_files $uri /index.php$is_args$args;\n\n access_log /var/log/nginx/shaarli.access.log;\n error_log /var/log/nginx/shaarli.error.log;\n }\n\n location = /shaarli/favicon.ico {\n # serve the Shaarli favicon from its custom location\n alias /var/www/shaarli/images/favicon.ico;\n }\n\n include deny.conf;\n include static_assets.conf;\n include php.conf;\n }\n}", + "title": "Redirect HTTP to HTTPS" + }, + { + "location": "/Server-security/", + "text": "php.ini\n\n\nPHP settings are defined in:\n- a main configuration file, usually found under \n/etc/php5/php.ini\n; some distributions provide different configuration environments, e.g.\n - \n/etc/php5/php.ini\n - used when running console scripts\n - \n/etc/php5/apache2/php.ini\n - used when a client requests PHP resources from Apache\n - \n/etc/php5/php-fpm.conf\n - used when PHP requests are proxied to PHP-FPM\n- additional configuration files/entries, depending on the installed/enabled extensions:\n - \n/etc/php/conf.d/xdebug.ini\n\n\nLocate .ini files\n\n\nConsole environment\n\n\n$ php --ini\nConfiguration File (php.ini) Path: /etc/php\nLoaded Configuration File: /etc/php/php.ini\nScan for additional .ini files in: /etc/php/conf.d\nAdditional .ini files parsed: /etc/php/conf.d/xdebug.ini\n\n\n\n\nServer environment\n\n\n\n\ncreate a \nphpinfo.php\n script located in a path supported by the web server, e.g.\n\n\nApache (with user dirs enabled): \n/home/myself/public_html/phpinfo.php\n\n\n/var/www/test/phpinfo.php\n\n\n\n\n\n\nmake sure the script is readable by the web server user/group (usually, \nwww\n, \nwww-data\n or \nhttpd\n)\n\n\naccess the script from a web browser\n\n\nlook at the \nLoaded Configuration File\n and \nScan this dir for additional .ini files\n entries\n\n\n\n\n\n\n\n\n\nfail2ban\n\n\nfail2ban\n is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses \niptables\n profiles to block brute-force attempts:\n- \nOfficial website\n\n- \nSource code\n\n\nRead Shaarli logs to ban IPs\n\n\nExample configuration:\n- allow 3 login attempts per IP address\n- after 3 failures, permanently ban the corresponding IP adddress\n\n\n/etc/fail2ban/jail.local\n\n\n[shaarli-auth]\nenabled = true\nport = https,http\nfilter = shaarli-auth\nlogpath = /var/www/path/to/shaarli/data/log.txt\nmaxretry = 3\nbantime = -1\n\n\n\n\n/etc/fail2ban/filter.d/shaarli-auth.conf\n\n\n[INCLUDES]\nbefore = common.conf\n[Definition]\nfailregex = \\s-\\s\\s-\\sLogin failed for user.*$\nignoreregex = \n\n\n\n\nRobots - Restricting search engines and web crawler traffic\n\n\nCreating a \nrobots.txt\n with the following contents at the root of your Shaarli installation will prevent \nhonest\n web crawlers from indexing each and every link and Daily page from a Shaarli instance, thus getting rid of a certain amount of unsollicited network traffic.\n\n\nUser-agent: *\nDisallow: /\n\n\n\n\nSee:\n- http://www.robotstxt.org/\n- http://www.robotstxt.org/robotstxt.html\n- http://www.robotstxt.org/meta.html", + "title": "Server security" + }, + { + "location": "/Server-security/#phpini", + "text": "PHP settings are defined in:\n- a main configuration file, usually found under /etc/php5/php.ini ; some distributions provide different configuration environments, e.g.\n - /etc/php5/php.ini - used when running console scripts\n - /etc/php5/apache2/php.ini - used when a client requests PHP resources from Apache\n - /etc/php5/php-fpm.conf - used when PHP requests are proxied to PHP-FPM\n- additional configuration files/entries, depending on the installed/enabled extensions:\n - /etc/php/conf.d/xdebug.ini", + "title": "php.ini" + }, + { + "location": "/Server-security/#locate-ini-files", + "text": "", + "title": "Locate .ini files" + }, + { + "location": "/Server-security/#console-environment", + "text": "$ php --ini\nConfiguration File (php.ini) Path: /etc/php\nLoaded Configuration File: /etc/php/php.ini\nScan for additional .ini files in: /etc/php/conf.d\nAdditional .ini files parsed: /etc/php/conf.d/xdebug.ini", + "title": "Console environment" + }, + { + "location": "/Server-security/#server-environment", + "text": "create a phpinfo.php script located in a path supported by the web server, e.g. Apache (with user dirs enabled): /home/myself/public_html/phpinfo.php /var/www/test/phpinfo.php make sure the script is readable by the web server user/group (usually, www , www-data or httpd ) access the script from a web browser look at the Loaded Configuration File and Scan this dir for additional .ini files entries ", + "title": "Server environment" + }, + { + "location": "/Server-security/#fail2ban", + "text": "fail2ban is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses iptables profiles to block brute-force attempts:\n- Official website \n- Source code", + "title": "fail2ban" + }, + { + "location": "/Server-security/#read-shaarli-logs-to-ban-ips", + "text": "Example configuration:\n- allow 3 login attempts per IP address\n- after 3 failures, permanently ban the corresponding IP adddress /etc/fail2ban/jail.local [shaarli-auth]\nenabled = true\nport = https,http\nfilter = shaarli-auth\nlogpath = /var/www/path/to/shaarli/data/log.txt\nmaxretry = 3\nbantime = -1 /etc/fail2ban/filter.d/shaarli-auth.conf [INCLUDES]\nbefore = common.conf\n[Definition]\nfailregex = \\s-\\s\\s-\\sLogin failed for user.*$\nignoreregex =", + "title": "Read Shaarli logs to ban IPs" + }, + { + "location": "/Server-security/#robots-restricting-search-engines-and-web-crawler-traffic", + "text": "Creating a robots.txt with the following contents at the root of your Shaarli installation will prevent honest web crawlers from indexing each and every link and Daily page from a Shaarli instance, thus getting rid of a certain amount of unsollicited network traffic. User-agent: *\nDisallow: / See:\n- http://www.robotstxt.org/\n- http://www.robotstxt.org/robotstxt.html\n- http://www.robotstxt.org/meta.html", + "title": "Robots - Restricting search engines and web crawler traffic" + }, + { + "location": "/Shaarli-configuration/", + "text": "Foreword\n\n\nDo not edit configuration options in index.php! Your changes would be lost.\n \n\n\nOnce your Shaarli instance is installed, the file \ndata/config.json.php\n is generated:\n\n it contains all settings in JSON format, and can be edited to customize values\n\n it defines which \nplugins\n are enabled\n\n\n its values override those defined in \nindex.php\n\n\n it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration\n\n\nFile and directory permissions\n\n\nThe server process running Shaarli must have:\n- \nread\n access to the following resources:\n - PHP scripts: \nindex.php\n, \napplication/*.php\n, \nplugins/*.php\n\n - 3rd party PHP and Javascript libraries: \ninc/*.php\n, \ninc/*.js\n\n - static assets:\n - CSS stylesheets: \ninc/*.css\n\n - \nimages/*\n\n - RainTPL templates: \ntpl/*.html\n\n- \nread\n, \nwrite\n and \nexecution\n access to the following directories:\n - \ncache\n - thumbnail cache\n - \ndata\n - link data store, configuration options\n - \npagecache\n - Atom/RSS feed cache\n - \ntmp\n - RainTPL page cache\n\n\nOn a Linux distribution:\n- the web server user will likely be \nwww\n or \nhttp\n (for Apache2)\n- it will be a member of a group of the same name: \nwww:www\n, \nhttp:http\n\n- to give it access to Shaarli, either:\n - unzip Shaarli in the default web server location (usually \n/var/www/\n) and set the web server user as the owner\n - put users in the same group as the web server, and set the appropriate access rights\n- if you have a domain / subdomain to serve Shaarli, \nconfigure the server\n accordingly\n\n\nConfiguration\n\n\nIn \ndata/config.json.php\n.\n\n\nSee also \nPlugin System\n.\n\n\nCredentials\n\n\n\n\nYou shouldn't edit those.\n\n\n\n\nlogin\n: Login username.\n\n\nhash\n: Generated password hash.\n\n\nsalt\n: Password salt.\n\n\nGeneral\n\n\ntitle\n: Shaarli's instance title.\n\n\nheader_link\n: Link to the homepage.\n\n\nlinks_per_page\n: Number of shaares displayed per page.\n\n\ntimezone\n: See \nthe list of supported timezones\n.\n\n\nenabled_plugins\n: List of enabled plugins.\n\n\nSecurity\n\n\nsession_protection_disabled\n: Disable session cookie hijacking protection (not recommended). \nIt might be useful if your IP adress often changes.\n\n\nban_after\n: Failed login attempts before being IP banned.\n\n\nban_duration\n: IP ban duration in seconds.\n\n\nopen_shaarli\n: Anyone can add a new link while logged out if enabled.\n\n\ntrusted_proxies\n: List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy.\n\n\nallowed_protocols\n: List of allowed protocols in shaare URLs or markdown-rendered descriptions. Useful if you want to store \njavascript:\n links (bookmarklets) in Shaarli (default: \n[\"ftp\", \"ftps\", \"magnet\"]\n).\n\n\nResources\n\n\ndata_dir\n: Data directory.\n\n\ndatastore\n: Shaarli's links database file path.\n\n\nhistory\n: Shaarli's operation history file path.\n\nupdates\n: File path for the ran updates file.\n\n\nlog\n: Log file path.\n\n\nupdate_check\n: Last update check file path.\n\n\nraintpl_tpl\n: Templates directory.\n\n\nraintpl_tmp\n: Template engine cache directory.\n\n\nthumbnails_cache\n: Thumbnails cache directory.\n\n\npage_cache\n: Shaarli's internal cache directory.\n\n\nban_file\n: Banned IP file path.\n\n\nUpdates\n\n\ncheck_updates\n: Enable or disable update check to the git repository.\n\n\ncheck_updates_branch\n: Git branch used to check updates (e.g. \nstable\n or \nmaster\n).\n\n\ncheck_updates_interval\n: Look for new version every N seconds (default: every day).\n\n\nPrivacy\n\n\ndefault_private_links\n: Check the private checkbox by default for every new link.\n\n\nhide_public_links\n: All links are hidden while logged out.\n\n\nhide_timestamps\n: Timestamps are hidden.\n\n\nFeed\n\n\nrss_permalinks\n: Enable this to redirect RSS links to Shaarli's permalinks instead of shaared URL.\n\n\nshow_atom\n: Display ATOM feed button.\n\n\nThumbnail\n\n\nenable_thumbnails\n: Enable or disable thumbnail display.\n\n\nenable_localcache\n: Enable or disable local cache.\n\n\nRedirector\n\n\nurl\n: Redirector URL, such as \nanonym.to\n.\n\n\nencode_url\n: Enable this if the redirector needs encoded URL to work properly.\n\n\nConfiguration file example\n\n\n\",\n \"hash\": \"\",\n \"salt\": \"\"\n },\n \"security\": {\n \"ban_after\": 4,\n \"session_protection_disabled\": false,\n \"ban_duration\": 1800,\n \"trusted_proxies\": [\n \"1.2.3.4\",\n \"5.6.7.8\"\n ],\n \"allowed_protocols\": [\n \"ftp\",\n \"ftps\",\n \"magnet\"\n ]\n },\n \"resources\": {\n \"data_dir\": \"data\",\n \"config\": \"data\\/config.php\",\n \"datastore\": \"data\\/datastore.php\",\n \"ban_file\": \"data\\/ipbans.php\",\n \"updates\": \"data\\/updates.txt\",\n \"log\": \"data\\/log.txt\",\n \"update_check\": \"data\\/lastupdatecheck.txt\",\n \"raintpl_tmp\": \"tmp\\/\",\n \"raintpl_tpl\": \"tpl\\/\",\n \"thumbnails_cache\": \"cache\",\n \"page_cache\": \"pagecache\"\n },\n \"general\": {\n \"check_updates\": true,\n \"rss_permalinks\": true,\n \"links_per_page\": 20,\n \"default_private_links\": true,\n \"enable_thumbnails\": true,\n \"enable_localcache\": true,\n \"check_updates_branch\": \"stable\",\n \"check_updates_interval\": 86400,\n \"enabled_plugins\": [\n \"markdown\",\n \"wallabag\",\n \"archiveorg\"\n ],\n \"timezone\": \"Europe\\/Paris\",\n \"title\": \"My Shaarli\",\n \"header_link\": \"?\"\n },\n \"extras\": {\n \"show_atom\": false,\n \"hide_public_links\": false,\n \"hide_timestamps\": false,\n \"open_shaarli\": false,\n \"redirector\": \"http://anonym.to/?\",\n \"redirector_encode_url\": false\n },\n \"general\": {\n \"header_link\": \"?\",\n \"links_per_page\": 20,\n \"enabled_plugins\": [\n \"markdown\",\n \"wallabag\"\n ],\n \"timezone\": \"Europe\\/Paris\",\n \"title\": \"My Shaarli\"\n },\n \"updates\": {\n \"check_updates\": true,\n \"check_updates_branch\": \"stable\",\n \"check_updates_interval\": 86400\n },\n \"feed\": {\n \"rss_permalinks\": true,\n \"show_atom\": false\n },\n \"privacy\": {\n \"default_private_links\": true,\n \"hide_public_links\": false,\n \"hide_timestamps\": false\n },\n \"thumbnail\": {\n \"enable_thumbnails\": true,\n \"enable_localcache\": true\n },\n \"redirector\": {\n \"url\": \"http://anonym.to/?\",\n \"encode_url\": false\n },\n \"plugins\": {\n \"WALLABAG_URL\": \"http://demo.wallabag.org\",\n \"WALLABAG_VERSION\": \"1\"\n }\n} ?>\n\n\n\n\nAdditional configuration\n\n\nThe playvideos plugin may require that you adapt your server's \n\nContent Security Policy\n \nconfiguration to work properly.", + "title": "Shaarli configuration" + }, + { + "location": "/Shaarli-configuration/#foreword", + "text": "Do not edit configuration options in index.php! Your changes would be lost. Once your Shaarli instance is installed, the file data/config.json.php is generated: it contains all settings in JSON format, and can be edited to customize values it defines which plugins are enabled its values override those defined in index.php it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration", + "title": "Foreword" + }, + { + "location": "/Shaarli-configuration/#file-and-directory-permissions", + "text": "The server process running Shaarli must have:\n- read access to the following resources:\n - PHP scripts: index.php , application/*.php , plugins/*.php \n - 3rd party PHP and Javascript libraries: inc/*.php , inc/*.js \n - static assets:\n - CSS stylesheets: inc/*.css \n - images/* \n - RainTPL templates: tpl/*.html \n- read , write and execution access to the following directories:\n - cache - thumbnail cache\n - data - link data store, configuration options\n - pagecache - Atom/RSS feed cache\n - tmp - RainTPL page cache On a Linux distribution:\n- the web server user will likely be www or http (for Apache2)\n- it will be a member of a group of the same name: www:www , http:http \n- to give it access to Shaarli, either:\n - unzip Shaarli in the default web server location (usually /var/www/ ) and set the web server user as the owner\n - put users in the same group as the web server, and set the appropriate access rights\n- if you have a domain / subdomain to serve Shaarli, configure the server accordingly", + "title": "File and directory permissions" + }, + { + "location": "/Shaarli-configuration/#configuration", + "text": "In data/config.json.php . See also Plugin System .", + "title": "Configuration" + }, + { + "location": "/Shaarli-configuration/#credentials", + "text": "You shouldn't edit those. login : Login username. hash : Generated password hash. salt : Password salt.", + "title": "Credentials" + }, + { + "location": "/Shaarli-configuration/#general", + "text": "title : Shaarli's instance title. header_link : Link to the homepage. links_per_page : Number of shaares displayed per page. timezone : See the list of supported timezones . enabled_plugins : List of enabled plugins.", + "title": "General" + }, + { + "location": "/Shaarli-configuration/#security", + "text": "session_protection_disabled : Disable session cookie hijacking protection (not recommended). \nIt might be useful if your IP adress often changes. ban_after : Failed login attempts before being IP banned. ban_duration : IP ban duration in seconds. open_shaarli : Anyone can add a new link while logged out if enabled. trusted_proxies : List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy. allowed_protocols : List of allowed protocols in shaare URLs or markdown-rendered descriptions. Useful if you want to store javascript: links (bookmarklets) in Shaarli (default: [\"ftp\", \"ftps\", \"magnet\"] ).", + "title": "Security" + }, + { + "location": "/Shaarli-configuration/#resources", + "text": "data_dir : Data directory. datastore : Shaarli's links database file path. history : Shaarli's operation history file path. updates : File path for the ran updates file. log : Log file path. update_check : Last update check file path. raintpl_tpl : Templates directory. raintpl_tmp : Template engine cache directory. thumbnails_cache : Thumbnails cache directory. page_cache : Shaarli's internal cache directory. ban_file : Banned IP file path.", + "title": "Resources" + }, + { + "location": "/Shaarli-configuration/#updates", + "text": "check_updates : Enable or disable update check to the git repository. check_updates_branch : Git branch used to check updates (e.g. stable or master ). check_updates_interval : Look for new version every N seconds (default: every day).", + "title": "Updates" + }, + { + "location": "/Shaarli-configuration/#privacy", + "text": "default_private_links : Check the private checkbox by default for every new link. hide_public_links : All links are hidden while logged out. hide_timestamps : Timestamps are hidden.", + "title": "Privacy" + }, + { + "location": "/Shaarli-configuration/#feed", + "text": "rss_permalinks : Enable this to redirect RSS links to Shaarli's permalinks instead of shaared URL. show_atom : Display ATOM feed button.", + "title": "Feed" + }, + { + "location": "/Shaarli-configuration/#thumbnail", + "text": "enable_thumbnails : Enable or disable thumbnail display. enable_localcache : Enable or disable local cache.", + "title": "Thumbnail" + }, + { + "location": "/Shaarli-configuration/#redirector", + "text": "url : Redirector URL, such as anonym.to . encode_url : Enable this if the redirector needs encoded URL to work properly.", + "title": "Redirector" + }, + { + "location": "/Shaarli-configuration/#configuration-file-example", + "text": "\",\n \"hash\": \"\",\n \"salt\": \"\"\n },\n \"security\": {\n \"ban_after\": 4,\n \"session_protection_disabled\": false,\n \"ban_duration\": 1800,\n \"trusted_proxies\": [\n \"1.2.3.4\",\n \"5.6.7.8\"\n ],\n \"allowed_protocols\": [\n \"ftp\",\n \"ftps\",\n \"magnet\"\n ]\n },\n \"resources\": {\n \"data_dir\": \"data\",\n \"config\": \"data\\/config.php\",\n \"datastore\": \"data\\/datastore.php\",\n \"ban_file\": \"data\\/ipbans.php\",\n \"updates\": \"data\\/updates.txt\",\n \"log\": \"data\\/log.txt\",\n \"update_check\": \"data\\/lastupdatecheck.txt\",\n \"raintpl_tmp\": \"tmp\\/\",\n \"raintpl_tpl\": \"tpl\\/\",\n \"thumbnails_cache\": \"cache\",\n \"page_cache\": \"pagecache\"\n },\n \"general\": {\n \"check_updates\": true,\n \"rss_permalinks\": true,\n \"links_per_page\": 20,\n \"default_private_links\": true,\n \"enable_thumbnails\": true,\n \"enable_localcache\": true,\n \"check_updates_branch\": \"stable\",\n \"check_updates_interval\": 86400,\n \"enabled_plugins\": [\n \"markdown\",\n \"wallabag\",\n \"archiveorg\"\n ],\n \"timezone\": \"Europe\\/Paris\",\n \"title\": \"My Shaarli\",\n \"header_link\": \"?\"\n },\n \"extras\": {\n \"show_atom\": false,\n \"hide_public_links\": false,\n \"hide_timestamps\": false,\n \"open_shaarli\": false,\n \"redirector\": \"http://anonym.to/?\",\n \"redirector_encode_url\": false\n },\n \"general\": {\n \"header_link\": \"?\",\n \"links_per_page\": 20,\n \"enabled_plugins\": [\n \"markdown\",\n \"wallabag\"\n ],\n \"timezone\": \"Europe\\/Paris\",\n \"title\": \"My Shaarli\"\n },\n \"updates\": {\n \"check_updates\": true,\n \"check_updates_branch\": \"stable\",\n \"check_updates_interval\": 86400\n },\n \"feed\": {\n \"rss_permalinks\": true,\n \"show_atom\": false\n },\n \"privacy\": {\n \"default_private_links\": true,\n \"hide_public_links\": false,\n \"hide_timestamps\": false\n },\n \"thumbnail\": {\n \"enable_thumbnails\": true,\n \"enable_localcache\": true\n },\n \"redirector\": {\n \"url\": \"http://anonym.to/?\",\n \"encode_url\": false\n },\n \"plugins\": {\n \"WALLABAG_URL\": \"http://demo.wallabag.org\",\n \"WALLABAG_VERSION\": \"1\"\n }\n} ?>", + "title": "Configuration file example" + }, + { + "location": "/Shaarli-configuration/#additional-configuration", + "text": "The playvideos plugin may require that you adapt your server's Content Security Policy \nconfiguration to work properly.", + "title": "Additional configuration" + }, + { + "location": "/Plugins/", + "text": "Plugin installation\n\n\nThere is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.\n\n\nIf you want to install a third party plugin:\n\n\n\n\nDownload it.\n\n\nPut it in the \nplugins\n directory in Shaarli's installation folder.\n\n\nMake sure you put it correctly:\n\n\n\n\n| index.php\n| plugins/\n|---| custom_plugin/\n| |---| custom_plugin.php\n| |---| ...\n\n\n\n\n\n\n\nMake sure your webserver can read and write the files in your plugin folder.\n\n\n\n\nPlugin configuration\n\n\nIn Shaarli's administration page (\nTools\n link), go to \nPlugin administration\n.\n\n\nHere you can enable and disable all plugins available, and configure them.\n\n\n\n\nPlugin order\n\n\nIn the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first.\n\n\nThis is important in case plugins are depending on each other. Read plugins README details for more information.\n\n\nUse case\n: The (non existent) plugin \nshaares_footer\n adds a footer to every shaare in Markdown syntax. It needs to be processed \nbefore\n (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.\n\n\nFile mode\n\n\nEnabled plugin are stored in your \nconfig.php\n parameters file, under the \narray\n:\n\n\n$GLOBALS['config']['ENABLED_PLUGINS']\n\n\n\n\nYou can edit them manually here.\nExample:\n\n\n$GLOBALS['config']['ENABLED_PLUGINS'] = array(\n 'qrcode', \n 'archiveorg',\n 'wallabag',\n 'markdown',\n);\n\n\n\n\nPlugin usage\n\n\nOfficial plugins\n\n\nUsage of each plugin is documented in it's README file:\n\n\n\n\naddlink-toolbar\n: Adds the addlink input on the linklist page\n\n\narchiveorg\n: For each link, add an Archive.org icon\n\n\nmarkdown\n: Render shaare description with Markdown syntax.\n\n\nplayvideos\n: Add a button in the toolbar allowing to watch all videos.\n\n\nqrcode\n: For each link, add a QRCode icon.\n\n\nwallabag\n: For each link, add a Wallabag icon to save it in your instance.\n\n\n\n\nThird party plugins\n\n\nSee \nCommunity & related software", + "title": "Plugins" + }, + { + "location": "/Plugins/#plugin-installation", + "text": "There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them. If you want to install a third party plugin: Download it. Put it in the plugins directory in Shaarli's installation folder. Make sure you put it correctly: | index.php\n| plugins/\n|---| custom_plugin/\n| |---| custom_plugin.php\n| |---| ... Make sure your webserver can read and write the files in your plugin folder.", + "title": "Plugin installation" + }, + { + "location": "/Plugins/#plugin-configuration", + "text": "In Shaarli's administration page ( Tools link), go to Plugin administration . Here you can enable and disable all plugins available, and configure them.", + "title": "Plugin configuration" + }, + { + "location": "/Plugins/#plugin-order", + "text": "In the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first. This is important in case plugins are depending on each other. Read plugins README details for more information. Use case : The (non existent) plugin shaares_footer adds a footer to every shaare in Markdown syntax. It needs to be processed before (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.", + "title": "Plugin order" + }, + { + "location": "/Plugins/#file-mode", + "text": "Enabled plugin are stored in your config.php parameters file, under the array : $GLOBALS['config']['ENABLED_PLUGINS'] You can edit them manually here.\nExample: $GLOBALS['config']['ENABLED_PLUGINS'] = array(\n 'qrcode', \n 'archiveorg',\n 'wallabag',\n 'markdown',\n);", + "title": "File mode" + }, + { + "location": "/Plugins/#plugin-usage", + "text": "", + "title": "Plugin usage" + }, + { + "location": "/Plugins/#official-plugins", + "text": "Usage of each plugin is documented in it's README file: addlink-toolbar : Adds the addlink input on the linklist page archiveorg : For each link, add an Archive.org icon markdown : Render shaare description with Markdown syntax. playvideos : Add a button in the toolbar allowing to watch all videos. qrcode : For each link, add a QRCode icon. wallabag : For each link, add a Wallabag icon to save it in your instance.", + "title": "Official plugins" + }, + { + "location": "/Plugins/#third-party-plugins", + "text": "See Community & related software", + "title": "Third party plugins" + }, + { + "location": "/Docker-101/", + "text": "Basics\n\n\nInstall \nDocker\n, by following the instructions relevant\nto your OS / distribution, and start the service.\n\n\nSearch an image on \nDockerHub\n\n\n$ docker search debian\n\nNAME DESCRIPTION STARS OFFICIAL AUTOMATED\nubuntu Ubuntu is a Debian-based Linux operating s... 2065 [OK]\ndebian Debian is a Linux distribution that's comp... 603 [OK]\ngoogle/debian 47 [OK]\n\n\n\n\nShow available tags for a repository\n\n\n$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool\n\n% Total % Received % Xferd Average Speed Time Time Time Current\nDload Upload Total Spent Left Speed\n100 1283 0 1283 0 0 433 0 --:--:-- 0:00:02 --:--:-- 433\n\n\n\n\nSample output:\n\n\n[\n {\n \"layer\": \"85a02782\",\n \"name\": \"stretch\"\n },\n {\n \"layer\": \"59abecbc\",\n \"name\": \"testing\"\n },\n {\n \"layer\": \"bf0fd686\",\n \"name\": \"unstable\"\n },\n {\n \"layer\": \"60c52dbe\",\n \"name\": \"wheezy\"\n },\n {\n \"layer\": \"c5b806fe\",\n \"name\": \"wheezy-backports\"\n }\n]\n\n\n\n\n\nPull an image from DockerHub\n\n\n$ docker pull repository[:tag]\n\n$ docker pull debian:wheezy\nwheezy: Pulling from debian\n4c8cbfd2973e: Pull complete\n60c52dbe9d91: Pull complete\nDigest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe\nStatus: Downloaded newer image for debian:wheezy", + "title": "Docker 101" + }, + { + "location": "/Docker-101/#basics", + "text": "Install Docker , by following the instructions relevant\nto your OS / distribution, and start the service.", + "title": "Basics" + }, + { + "location": "/Docker-101/#search-an-image-on-dockerhub", + "text": "$ docker search debian\n\nNAME DESCRIPTION STARS OFFICIAL AUTOMATED\nubuntu Ubuntu is a Debian-based Linux operating s... 2065 [OK]\ndebian Debian is a Linux distribution that's comp... 603 [OK]\ngoogle/debian 47 [OK]", + "title": "Search an image on DockerHub" + }, + { + "location": "/Docker-101/#show-available-tags-for-a-repository", + "text": "$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool\n\n% Total % Received % Xferd Average Speed Time Time Time Current\nDload Upload Total Spent Left Speed\n100 1283 0 1283 0 0 433 0 --:--:-- 0:00:02 --:--:-- 433 Sample output: [\n {\n \"layer\": \"85a02782\",\n \"name\": \"stretch\"\n },\n {\n \"layer\": \"59abecbc\",\n \"name\": \"testing\"\n },\n {\n \"layer\": \"bf0fd686\",\n \"name\": \"unstable\"\n },\n {\n \"layer\": \"60c52dbe\",\n \"name\": \"wheezy\"\n },\n {\n \"layer\": \"c5b806fe\",\n \"name\": \"wheezy-backports\"\n }\n]", + "title": "Show available tags for a repository" + }, + { + "location": "/Docker-101/#pull-an-image-from-dockerhub", + "text": "$ docker pull repository[:tag]\n\n$ docker pull debian:wheezy\nwheezy: Pulling from debian\n4c8cbfd2973e: Pull complete\n60c52dbe9d91: Pull complete\nDigest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe\nStatus: Downloaded newer image for debian:wheezy", + "title": "Pull an image from DockerHub" + }, + { + "location": "/Shaarli-images/", + "text": "Get and run a Shaarli image\n\n\nDockerHub repository\n\n\nThe images can be found in the \nshaarli/shaarli\n\nrepository.\n\n\nAvailable image tags\n\n\n\n\nlatest\n: master branch (tarball release)\n\n\nstable\n: stable branch (tarball release)\n\n\ndev\n: master branch (Git clone)\n\n\n\n\nAll images rely on:\n- \nDebian 8 Jessie\n\n- \nPHP5-FPM\n\n- \nNginx\n\n\nDownload from DockerHub\n\n\n$ docker pull shaarli/shaarli\nlatest: Pulling from shaarli/shaarli\n32716d9fcddb: Pull complete\n84899d045435: Pull complete\n4b6ad7444763: Pull complete\ne0345ef7a3e0: Pull complete\n5c1dd344094f: Pull complete\n6422305a200b: Pull complete\n7d63f861dbef: Pull complete\n3eb97210645c: Pull complete\n869319d746ff: Already exists\n869319d746ff: Pulling fs layer\n902b87aaaec9: Already exists\nDigest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98\nStatus: Downloaded newer image for shaarli/shaarli:latest\n\n\n\n\nCreate and start a new container from the image\n\n\n# map the host's :8000 port to the container's :80 port\n$ docker create -p 8000:80 shaarli/shaarli\nd40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\n\n# launch the container in the background\n$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\nd40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\n\n# list active containers\n$ docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nd40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo\n\n\n\n\nStop and destroy a container\n\n\n$ docker stop backstabbing_galileo # those docker guys are really rude to physicists!\nbackstabbing_galileo\n\n# check the container is stopped\n$ docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n# list ALL containers\n$ docker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nd40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo\n\n# destroy the container\n$ docker rm backstabbing_galileo # let's put an end to these barbarian practices\nbackstabbing_galileo\n\n$ docker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES", + "title": "Shaarli images" + }, + { + "location": "/Shaarli-images/#get-and-run-a-shaarli-image", + "text": "", + "title": "Get and run a Shaarli image" + }, + { + "location": "/Shaarli-images/#dockerhub-repository", + "text": "The images can be found in the shaarli/shaarli \nrepository.", + "title": "DockerHub repository" + }, + { + "location": "/Shaarli-images/#available-image-tags", + "text": "latest : master branch (tarball release) stable : stable branch (tarball release) dev : master branch (Git clone) All images rely on:\n- Debian 8 Jessie \n- PHP5-FPM \n- Nginx", + "title": "Available image tags" + }, + { + "location": "/Shaarli-images/#download-from-dockerhub", + "text": "$ docker pull shaarli/shaarli\nlatest: Pulling from shaarli/shaarli\n32716d9fcddb: Pull complete\n84899d045435: Pull complete\n4b6ad7444763: Pull complete\ne0345ef7a3e0: Pull complete\n5c1dd344094f: Pull complete\n6422305a200b: Pull complete\n7d63f861dbef: Pull complete\n3eb97210645c: Pull complete\n869319d746ff: Already exists\n869319d746ff: Pulling fs layer\n902b87aaaec9: Already exists\nDigest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98\nStatus: Downloaded newer image for shaarli/shaarli:latest", + "title": "Download from DockerHub" + }, + { + "location": "/Shaarli-images/#create-and-start-a-new-container-from-the-image", + "text": "# map the host's :8000 port to the container's :80 port\n$ docker create -p 8000:80 shaarli/shaarli\nd40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\n\n# launch the container in the background\n$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\nd40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101\n\n# list active containers\n$ docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nd40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo", + "title": "Create and start a new container from the image" + }, + { + "location": "/Shaarli-images/#stop-and-destroy-a-container", + "text": "$ docker stop backstabbing_galileo # those docker guys are really rude to physicists!\nbackstabbing_galileo\n\n# check the container is stopped\n$ docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n\n# list ALL containers\n$ docker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\nd40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo\n\n# destroy the container\n$ docker rm backstabbing_galileo # let's put an end to these barbarian practices\nbackstabbing_galileo\n\n$ docker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES", + "title": "Stop and destroy a container" + }, + { + "location": "/Reverse-proxy-configuration/", + "text": "TODO, see https://github.com/shaarli/Shaarli/issues/888\n\n\nHAProxy\n\n\nNginx", + "title": "Reverse proxy configuration" + }, + { + "location": "/Reverse-proxy-configuration/#haproxy", + "text": "", + "title": "HAProxy" + }, + { + "location": "/Reverse-proxy-configuration/#nginx", + "text": "", + "title": "Nginx" + }, + { + "location": "/Docker-resources/", + "text": "Docker\n\n\n\n\nInteractive Docker training portal\n on \nKatakoda\n\n\nWhere are Docker images stored?\n\n\nDockerfile reference\n\n\nDockerfile best practices\n\n\nVolumes\n\n\n\n\nDockerHub\n\n\n\n\nRepositories\n\n\nTeams and organizations\n\n\nGitHub automated build\n\n\n\n\nService management\n\n\n\n\nUsing supervisord\n\n\nNginx in the foreground\n\n\nsupervisord", + "title": "Docker resources" + }, + { + "location": "/Docker-resources/#docker", + "text": "Interactive Docker training portal on Katakoda Where are Docker images stored? Dockerfile reference Dockerfile best practices Volumes", + "title": "Docker" + }, + { + "location": "/Docker-resources/#dockerhub", + "text": "Repositories Teams and organizations GitHub automated build", + "title": "DockerHub" + }, + { + "location": "/Docker-resources/#service-management", + "text": "Using supervisord Nginx in the foreground supervisord", + "title": "Service management" + }, + { + "location": "/Features/", + "text": "Main features\n\n\nShaarli is intended:\n * to share, comment and save interesting links and news\n * to bookmark useful/frequent personal links (as private links) and share them between computers\n * as a minimal blog/microblog/writing platform (no character limit)\n * as a read-it-later list (for example items tagged \nreadlater\n)\n * to draft and save articles/ideas\n * to keep code snippets\n * to keep notes and documentation\n * as a shared clipboard between machines\n * as a todo list\n * to store playlists (e.g. with the \nmusic\n or \nvideo\n tags)\n * to keep extracts/comments from webpages that may disappear\n * to keep track of ongoing discussions (for example items tagged \ndiscussion\n)\n * \nto feed RSS aggregators\n (planets) with specific tags\n * to feed other social networks, blogs... using RSS feeds and external services (dlvr.it, ifttt.com ...)\n\n\nUsing Shaarli as a blog, notepad, pastebin...\n\n\n\n\nGo to your Shaarli setup and log in\n\n\nClick the \nAdd Link\n button\n\n\nTo share text only, do not enter any URL in the corresponding input field and click \nAdd Link\n\n\nPick a title and enter your article, or note, in the description field; add a few tags; optionally check \nPrivate\n then click \nSave\n\n\nVoil\u00e0! Your article is now published (privately if you selected that option) and accessible using its permalink.", + "title": "Features" + }, + { + "location": "/Features/#main-features", + "text": "Shaarli is intended:\n * to share, comment and save interesting links and news\n * to bookmark useful/frequent personal links (as private links) and share them between computers\n * as a minimal blog/microblog/writing platform (no character limit)\n * as a read-it-later list (for example items tagged readlater )\n * to draft and save articles/ideas\n * to keep code snippets\n * to keep notes and documentation\n * as a shared clipboard between machines\n * as a todo list\n * to store playlists (e.g. with the music or video tags)\n * to keep extracts/comments from webpages that may disappear\n * to keep track of ongoing discussions (for example items tagged discussion )\n * to feed RSS aggregators (planets) with specific tags\n * to feed other social networks, blogs... using RSS feeds and external services (dlvr.it, ifttt.com ...)", + "title": "Main features" + }, + { + "location": "/Features/#using-shaarli-as-a-blog-notepad-pastebin", + "text": "Go to your Shaarli setup and log in Click the Add Link button To share text only, do not enter any URL in the corresponding input field and click Add Link Pick a title and enter your article, or note, in the description field; add a few tags; optionally check Private then click Save Voil\u00e0! Your article is now published (privately if you selected that option) and accessible using its permalink.", + "title": "Using Shaarli as a blog, notepad, pastebin..." + }, + { + "location": "/Bookmarklet/", + "text": "Add the sharing button (\nbookmarklet\n) to your browser\n\n\n\n\nOpen your Shaarli and \nLogin\n\n\nClick the \nTools\n button in the top bar\n\n\nDrag the \n\u271aShaare link\n button\n, and drop it to your browser's bookmarks bar.\n\n\n\n\nThis bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar.\n\n\n\n\nShare links using the \nbookmarklet\n\n\n\n\nWhen you are visiting a webpage you would like to share with Shaarli, click the \nbookmarklet\n you just added.\n\n\nA window opens.\n\n\nYou can freely edit title, description, tags... to find it later using the text search or tag filtering.\n\n\nYou will be able to edit this link later using the \n edit button.\n\n\nYou can also check the \u201cPrivate\u201d box so that the link is saved but only visible to you. \n\n\nClick \nSave\n.\nVoil\u00e0! Your link is now shared.\n\n\n\n\nTroubleshooting: The bookmarklet doesn't work with a few website (e.g. Github.com)\n\n\nWebsites which enforce Content Security Policy (CSP), such as github.com, disallow usage of bookmarklets. Unfortunatly, there is nothing Shaarli can do about it.\n\n\nSee \n#196\n.\n\n\nThere is an open bug for both Firefox and Chromium:\n\n\n\n\nhttps://bugzilla.mozilla.org/show_bug.cgi?id=866522\n\n\nhttps://code.google.com/p/chromium/issues/detail?id=233903", + "title": "Bookmarklet" + }, + { + "location": "/Bookmarklet/#add-the-sharing-button-bookmarklet-to-your-browser", + "text": "Open your Shaarli and Login Click the Tools button in the top bar Drag the \u271aShaare link button , and drop it to your browser's bookmarks bar. This bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar.", + "title": "Add the sharing button (bookmarklet) to your browser" + }, + { + "location": "/Bookmarklet/#share-links-using-the-bookmarklet", + "text": "When you are visiting a webpage you would like to share with Shaarli, click the bookmarklet you just added. A window opens. You can freely edit title, description, tags... to find it later using the text search or tag filtering. You will be able to edit this link later using the edit button. You can also check the \u201cPrivate\u201d box so that the link is saved but only visible to you. Click Save . Voil\u00e0! Your link is now shared.", + "title": "Share links using the bookmarklet" + }, + { + "location": "/Bookmarklet/#troubleshooting-the-bookmarklet-doesnt-work-with-a-few-website-eg-githubcom", + "text": "Websites which enforce Content Security Policy (CSP), such as github.com, disallow usage of bookmarklets. Unfortunatly, there is nothing Shaarli can do about it. See #196 . There is an open bug for both Firefox and Chromium: https://bugzilla.mozilla.org/show_bug.cgi?id=866522 https://code.google.com/p/chromium/issues/detail?id=233903", + "title": "Troubleshooting: The bookmarklet doesn't work with a few website (e.g. Github.com)" + }, + { + "location": "/Browsing-and-searching/", + "text": "Plain text search\n\n\nUse the \nSearch text\n field to search in \nany\n of the fields of all links (Title, URL, Description...)\n\n\nExclude text/tags:\n Use the \n-\n operator before a word or tag (example \n-uninteresting\n) to prevent entries containing (or tagged) \nuninteresting\n from showing up in the search results.\n\n\nExact text search:\n Use double-quotes (example \n\"exact search\"\n) to search for the exact expression.\n\n\nBoth exclude patterns and exact searches can be combined with normal searches (example \n\"exact search\" term otherterm -notthis \"very exact\" stuff -notagain\n)\n\n\nTags search\n\n\nUse the \nFilter by tags\n field to restrict displayed links to entries tagged with one or multiple tags (use space to separate tags). \n\n\nHidden tags:\n Tags starting with a dot \n.\n (example \n.secret\n) are private. They can only be seen and searched when logged in.\n\n\nAlternatively you can use the \nTag cloud\n to discover all tags and click on any of them to display related links.\n\n\nTo search for links that are not tagged, enter \n\"\"\n in the tag search field.\n\n\nFiltering RSS feeds/Picture wall\n\n\nRSS feeds can also be restricted to only return items matching a text/tag search: see \nRSS feeds\n.", + "title": "Browsing and searching" + }, + { + "location": "/Browsing-and-searching/#plain-text-search", + "text": "Use the Search text field to search in any of the fields of all links (Title, URL, Description...) Exclude text/tags: Use the - operator before a word or tag (example -uninteresting ) to prevent entries containing (or tagged) uninteresting from showing up in the search results. Exact text search: Use double-quotes (example \"exact search\" ) to search for the exact expression. Both exclude patterns and exact searches can be combined with normal searches (example \"exact search\" term otherterm -notthis \"very exact\" stuff -notagain )", + "title": "Plain text search" + }, + { + "location": "/Browsing-and-searching/#tags-search", + "text": "Use the Filter by tags field to restrict displayed links to entries tagged with one or multiple tags (use space to separate tags). Hidden tags: Tags starting with a dot . (example .secret ) are private. They can only be seen and searched when logged in. Alternatively you can use the Tag cloud to discover all tags and click on any of them to display related links. To search for links that are not tagged, enter \"\" in the tag search field.", + "title": "Tags search" + }, + { + "location": "/Browsing-and-searching/#filtering-rss-feedspicture-wall", + "text": "RSS feeds can also be restricted to only return items matching a text/tag search: see RSS feeds .", + "title": "Filtering RSS feeds/Picture wall" + }, + { + "location": "/Firefox-share/", + "text": "Add Shaarli as a sharing service to Firefox\n\n\n\n\nOpen your Shaarli and \nLogin\n\n\nClick the \nTools\n button in the top bar\n\n\nClick the \n\u271aAdd to Firefox social\n button and accept the activation.\n\n\n\n\nSharing links using Firefox share\n\n\n\n\nAdd the sharing service as described above\n\n\nWhen you are visiting a webpage you would like to share with Shaarli, click the Firefox \nShare\n button \nimages/firefoxshare.png\n\n\nYou can edit your link before and after saving, just like the bookmarklet above.\n\n\n\n\n\n\n\n\n\n\n\uf06a\n\n\nYour Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections.", + "title": "Firefox share" + }, + { + "location": "/Firefox-share/#add-shaarli-as-a-sharing-service-to-firefox", + "text": "Open your Shaarli and Login Click the Tools button in the top bar Click the \u271aAdd to Firefox social button and accept the activation.", + "title": "Add Shaarli as a sharing service to Firefox" + }, + { + "location": "/Firefox-share/#sharing-links-using-firefox-share", + "text": "Add the sharing service as described above When you are visiting a webpage you would like to share with Shaarli, click the Firefox Share button images/firefoxshare.png You can edit your link before and after saving, just like the bookmarklet above. \uf06a Your Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections.", + "title": "Sharing links using Firefox share" + }, + { + "location": "/RSS-feeds/", + "text": "Feeds options\n\n\nFeeds are available in ATOM with \n?do=atom\n and RSS with \ndo=RSS\n.\n\n\nOptions:\n- You can use \npermalinks\n in the feed URL to get permalink to Shaares instead of direct link to shaared URL.\n - E.G. \nhttps://my.shaarli.domain/?do=atom&permalinks\n.\n- You can use \nnb\n parameter in the feed URL to specify the number of Shaares you want in a feed (default if not specified: \n50\n). The keyword \nall\n is available if you want everything.\n - \nhttps://my.shaarli.domain/?do=atom&permalinks&nb=42\n\n - \nhttps://my.shaarli.domain/?do=atom&permalinks&nb=all\n\n\nRSS Feeds or Picture Wall for a specific search/tag\n\n\nIt is possible to filter RSS/ATOM feeds and Picture Wall on a Shaarli to \nonly display results of a specific search, or for a specific tag\n.\n\n\nFor example, if you want to subscribe only to links tagged \nphotography\n:\n- Go to the desired Shaarli instance.\n- Search for the \nphotography\n tag in the \nFilter by tag\n box. Links tagged \nphotography\n are displayed.\n- Click on the \nRSS Feed\n button.\n- You are presented with an RSS feed showing only these links. Subscribe to it to receive only updates with this tag.\n- The same method \nalso works for a full-text search\n (\nSearch\n box) \nand for the Picture Wall\n (want to only see pictures about \nnature\n?)\n- You can also build the URLs manually: \n - \nhttps://my.shaarli.domain/?do=rss&searchtags=nature\n\n - \nhttps://my.shaarli.domain/links/?do=picwall&searchterm=poney", + "title": "RSS feeds" + }, + { + "location": "/RSS-feeds/#feeds-options", + "text": "Feeds are available in ATOM with ?do=atom and RSS with do=RSS . Options:\n- You can use permalinks in the feed URL to get permalink to Shaares instead of direct link to shaared URL.\n - E.G. https://my.shaarli.domain/?do=atom&permalinks .\n- You can use nb parameter in the feed URL to specify the number of Shaares you want in a feed (default if not specified: 50 ). The keyword all is available if you want everything.\n - https://my.shaarli.domain/?do=atom&permalinks&nb=42 \n - https://my.shaarli.domain/?do=atom&permalinks&nb=all", + "title": "Feeds options" + }, + { + "location": "/RSS-feeds/#rss-feeds-or-picture-wall-for-a-specific-searchtag", + "text": "It is possible to filter RSS/ATOM feeds and Picture Wall on a Shaarli to only display results of a specific search, or for a specific tag . For example, if you want to subscribe only to links tagged photography :\n- Go to the desired Shaarli instance.\n- Search for the photography tag in the Filter by tag box. Links tagged photography are displayed.\n- Click on the RSS Feed button.\n- You are presented with an RSS feed showing only these links. Subscribe to it to receive only updates with this tag.\n- The same method also works for a full-text search ( Search box) and for the Picture Wall (want to only see pictures about nature ?)\n- You can also build the URLs manually: \n - https://my.shaarli.domain/?do=rss&searchtags=nature \n - https://my.shaarli.domain/links/?do=picwall&searchterm=poney", + "title": "RSS Feeds or Picture Wall for a specific search/tag" + }, + { + "location": "/REST-API/", + "text": "Usage\n\n\nSee the \nREST API documentation\n.\n\n\nAuthentication\n\n\nAll requests to Shaarli's API must include a JWT token to verify their authenticity.\n\n\nThis token has to be included as an HTTP header called \nAuthentication: Bearer \n.\n\n\nJWT resources :\n\n\n\n\njwt.io\n (including a list of client per language).\n\n\nRFC : https://tools.ietf.org/html/rfc7519\n\n\nhttps://float-middle.com/json-web-tokens-jwt-vs-sessions/\n\n\nHackerNews thread: https://news.ycombinator.com/item?id=11929267\n\n\n\n\nShaarli JWT Token\n\n\nJWT tokens are composed by three parts, separated by a dot \n.\n and encoded in base64:\n\n\n[header].[payload].[signature]\n\n\n\n\nHeader\n\n\nShaarli only allow one hash algorithm, so the header will always be the same:\n\n\n{\n \"typ\": \"JWT\",\n \"alg\": \"HS512\"\n}\n\n\n\n\nEncoded in base64, it gives:\n\n\newogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==\n\n\n\n\nPayload\n\n\nValidity duration\n\n\nTo avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key \niat\n (issued at). This token will be accepted during 9 minutes.\n\n\n{\n \"iat\": 1468663519\n}\n\n\n\n\nSee \nRFC reference\n.\n\n\nSignature\n\n\nThe signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot \n.\n, hashed in SHA512 with the API secret available in Shaarli administration page.\n\n\nSignature example with PHP:\n\n\n$content = base64_encode($header) . '.' . base64_encode($payload);\n$signature = hash_hmac('sha512', $content, $secret);\n\n\n\n\nComplete example\n\n\nPHP\n\n\nfunction generateToken($secret) {\n $header = base64_encode('{\n \"typ\": \"JWT\",\n \"alg\": \"HS512\"\n }');\n $payload = base64_encode('{\n \"iat\": '. time() .'\n }');\n $signature = hash_hmac('sha512', $header .'.'. $payload , $secret);\n return $header .'.'. $payload .'.'. $signature;\n}\n\n$secret = 'mysecret';\n$token = generateToken($secret);\necho $token;\n\n\n\n\n\n\newogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68\n\n\n\n\n$options = [\n 'http' => [\n 'method' => 'GET',\n 'jwt' => $token,\n ],\n];\n$context = stream_context_create($options);\nfile_get_contents($apiEndpoint, false, $context);", + "title": "REST API" + }, + { + "location": "/REST-API/#usage", + "text": "See the REST API documentation .", + "title": "Usage" + }, + { + "location": "/REST-API/#authentication", + "text": "All requests to Shaarli's API must include a JWT token to verify their authenticity. This token has to be included as an HTTP header called Authentication: Bearer . JWT resources : jwt.io (including a list of client per language). RFC : https://tools.ietf.org/html/rfc7519 https://float-middle.com/json-web-tokens-jwt-vs-sessions/ HackerNews thread: https://news.ycombinator.com/item?id=11929267", + "title": "Authentication" + }, + { + "location": "/REST-API/#shaarli-jwt-token", + "text": "JWT tokens are composed by three parts, separated by a dot . and encoded in base64: [header].[payload].[signature]", + "title": "Shaarli JWT Token" + }, + { + "location": "/REST-API/#header", + "text": "Shaarli only allow one hash algorithm, so the header will always be the same: {\n \"typ\": \"JWT\",\n \"alg\": \"HS512\"\n} Encoded in base64, it gives: ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==", + "title": "Header" + }, + { + "location": "/REST-API/#payload", + "text": "Validity duration To avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key iat (issued at). This token will be accepted during 9 minutes. {\n \"iat\": 1468663519\n} See RFC reference .", + "title": "Payload" + }, + { + "location": "/REST-API/#signature", + "text": "The signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot . , hashed in SHA512 with the API secret available in Shaarli administration page. Signature example with PHP: $content = base64_encode($header) . '.' . base64_encode($payload);\n$signature = hash_hmac('sha512', $content, $secret);", + "title": "Signature" + }, + { + "location": "/REST-API/#complete-example", + "text": "", + "title": "Complete example" + }, + { + "location": "/REST-API/#php", + "text": "function generateToken($secret) {\n $header = base64_encode('{\n \"typ\": \"JWT\",\n \"alg\": \"HS512\"\n }');\n $payload = base64_encode('{\n \"iat\": '. time() .'\n }');\n $signature = hash_hmac('sha512', $header .'.'. $payload , $secret);\n return $header .'.'. $payload .'.'. $signature;\n}\n\n$secret = 'mysecret';\n$token = generateToken($secret);\necho $token; ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68 $options = [\n 'http' => [\n 'method' => 'GET',\n 'jwt' => $token,\n ],\n];\n$context = stream_context_create($options);\nfile_get_contents($apiEndpoint, false, $context);", + "title": "PHP" + }, + { + "location": "/Backup,-restore,-import-and-export/", + "text": "Backup and restore the datastore file\n\n\nExport links as...\n\n\nImport links from...\n\n\nImport Shaarli links to Firefox\n\n\n\n\n\n\nBackup and restore the datastore file\n\n\nBackup the file \ndata/datastore.php\n (by FTP or SSH). Restore by putting the file back in place.\n\n\nExample command:\n\n\nrsync -avzP my.server.com:/var/www/shaarli/data/datastore.php datastore-$(date +%Y-%m-%d_%H%M).php\n\n\n\n\nExport links as...\n\n\nTo export links as an HTML file, under \nTools > Export\n, choose:\n- \nExport all\n to export both public and private links\n- \nExport public\n to export public links only\n- \nExport private\n to export private links only\n\n\nRestore by using the \nImport\n feature.\n* This can be done using the \nshaarchiver\n tool.\n\n\nExample command: \n\n\n./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all\n\n\n\n\nImport links from...\n\n\nDiigo\n\n\nIf you export your bookmark from Diigo, make sure you use the Delicious export, not the Netscape export. (Their Netscape export is broken, and they don't seem to be interested in fixing it.)\n\n\nMister Wong\n\n\nSee \nthis issue\n for import tweaks.\n\n\nSemanticScuttle\n\n\nTo correctly import the tags from a \nSemanticScuttle\n HTML export, edit the HTML file before importing and replace all occurences of \ntags=\n (lowercase) to \nTAGS=\n (uppercase).\n\n\nScuttle\n\n\nShaarli cannot import data directly from \nScuttle\n. However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer.\n\n\nImport Shaarli links to Firefox\n\n\n\n\nExport your Shaarli links as described above.\n\n\nFor compatibility reasons, check \nPrepend note permalinks with this Shaarli instance's URL (useful to import bookmarks in a web browser)\n\n\nIn Firefox, open the bookmark manager (not the sidebar! \nBookmarks menu > Show all bookmarks\n or \nCtrl+Shift+B\n)\n\n\nSelect \nImport and Backup > Import bookmarks in HTML format\n\n\n\n\nYour bookmarks will be imported in Firefox, ready to use, with tags and descriptions retained. \"Self\" (notes) shaares will still point to the Shaarli instance you exported them from, but the note text can be viewed directly in the bookmark properties inside your browser. Depending on the number of bookmarks, the import can take some time.\n\n\nYou may be interested in these Firefox addons to manage links imported from Shaarli\n\n\n\n\nBookmark Deduplicator\n - provides an easy way to deduplicate your bookmarks\n\n\nTagSieve\n - browse your bookmarks by their tags", + "title": "Backup, restore, import and export" + }, + { + "location": "/Backup,-restore,-import-and-export/#backup-and-restore-the-datastore-file", + "text": "Backup the file data/datastore.php (by FTP or SSH). Restore by putting the file back in place. Example command: rsync -avzP my.server.com:/var/www/shaarli/data/datastore.php datastore-$(date +%Y-%m-%d_%H%M).php", + "title": "Backup and restore the datastore file" + }, + { + "location": "/Backup,-restore,-import-and-export/#export-links-as", + "text": "To export links as an HTML file, under Tools > Export , choose:\n- Export all to export both public and private links\n- Export public to export public links only\n- Export private to export private links only Restore by using the Import feature.\n* This can be done using the shaarchiver tool. Example command: ./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all", + "title": "Export links as..." + }, + { + "location": "/Backup,-restore,-import-and-export/#import-links-from", + "text": "", + "title": "Import links from..." + }, + { + "location": "/Backup,-restore,-import-and-export/#diigo", + "text": "If you export your bookmark from Diigo, make sure you use the Delicious export, not the Netscape export. (Their Netscape export is broken, and they don't seem to be interested in fixing it.)", + "title": "Diigo" + }, + { + "location": "/Backup,-restore,-import-and-export/#mister-wong", + "text": "See this issue for import tweaks.", + "title": "Mister Wong" + }, + { + "location": "/Backup,-restore,-import-and-export/#semanticscuttle", + "text": "To correctly import the tags from a SemanticScuttle HTML export, edit the HTML file before importing and replace all occurences of tags= (lowercase) to TAGS= (uppercase).", + "title": "SemanticScuttle" + }, + { + "location": "/Backup,-restore,-import-and-export/#scuttle", + "text": "Shaarli cannot import data directly from Scuttle . However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer.", + "title": "Scuttle" + }, + { + "location": "/Backup,-restore,-import-and-export/#import-shaarli-links-to-firefox", + "text": "Export your Shaarli links as described above. For compatibility reasons, check Prepend note permalinks with this Shaarli instance's URL (useful to import bookmarks in a web browser) In Firefox, open the bookmark manager (not the sidebar! Bookmarks menu > Show all bookmarks or Ctrl+Shift+B ) Select Import and Backup > Import bookmarks in HTML format Your bookmarks will be imported in Firefox, ready to use, with tags and descriptions retained. \"Self\" (notes) shaares will still point to the Shaarli instance you exported them from, but the note text can be viewed directly in the bookmark properties inside your browser. Depending on the number of bookmarks, the import can take some time. You may be interested in these Firefox addons to manage links imported from Shaarli Bookmark Deduplicator - provides an easy way to deduplicate your bookmarks TagSieve - browse your bookmarks by their tags", + "title": "Import Shaarli links to Firefox" + }, + { + "location": "/Copy-an-existing-installation-over-SSH-and-serve-it-locally/", + "text": "Example bash script:\n\n\n#!/bin/bash\n#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli\n#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally.\n#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli\n#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed\n#Usage: ./local-shaarli.sh\n#Author: nodiscc (nodiscc@gmail.com)\n#License: MIT (http://opensource.org/licenses/MIT)\nset -o errexit\nset -o nounset\n\n##### CONFIG #################\n#The port used by php's local server\nphp_local_port=7431\n\n#Name of the SSH server and path where Shaarli is installed\n#TODO: pass these as command-line arguments\nremotehost=\"my.ssh.server\"\nremote_shaarli_dir=\"/var/www/shaarli\"\n\n\n###### FUNCTIONS #############\n_main() {\n _CBSyncShaarli\n _CBServeShaarli\n}\n\n_CBSyncShaarli() {\n remote_temp_dir=$(ssh $remotehost mktemp -d)\n remote_ssh_user=$(ssh $remotehost whoami)\n ssh -t \"$remotehost\" sudo cp -r \"$remote_shaarli_dir\" \"$remote_temp_dir\"\n ssh -t \"$remotehost\" sudo chown -R \"$remote_ssh_user\":\"$remote_ssh_user\" \"$remote_temp_dir\"\n scp -rq \"$remotehost\":\"$remote_temp_dir\" local-shaarli\n ssh \"$remotehost\" rm -r \"$remote_temp_dir\"\n}\n\n_CBServeShaarli() {\n #TODO: allow serving a previously downloaded Shaarli\n #TODO: ask before overwriting local copy, if it exists\n cd local-shaarli/\n php -S localhost:${php_local_port}\n echo \"Please go to http://localhost:${php_local_port}\"\n}\n\n\n##### MAIN #################\n\n_main\n\n\n\n\nThis outputs:\n\n\n$ ./local-shaarli.sh\nPHP 5.6.0RC4 Development Server started at Mon Sep 1 21:56:19 2014\nListening on http://localhost:7431\nDocument root is /home/user/local-shaarli/shaarli\nPress Ctrl-C to quit.\n\n[Mon Sep 1 21:56:27 2014] ::1:57868 [200]: /\n[Mon Sep 1 21:56:27 2014] ::1:57869 [200]: /index.html\n[Mon Sep 1 21:56:37 2014] ::1:57881 [200]: /...", + "title": "Copy an existing installation over SSH and serve it locally" + }, + { + "location": "/Create-and-serve-multiple-Shaarlis-(farm)/", + "text": "Example bash script (creates multiple shaarli instances and generates an HTML index of them)\n\n\n#!/bin/bash\nset -o errexit\nset -o nounset\n\n#config\nshaarli_base_dir='/var/www/shaarli'\naccounts='bob john whatever username'\nshaarli_repo_url='https://github.com/shaarli/Shaarli'\nref=\"master\"\n\n#clone multiple shaarli instances\nif [ ! -d \"$shaarli_base_dir\" ]; then mkdir \"$shaarli_base_dir\"; fi\n\nfor account in $accounts; do\n if [ -d \"$shaarli_base_dir/$account\" ];\n then echo \"[info] account $account already exists, skipping\";\n else echo \"[info] creating new account $account ...\"; git clone --quiet \"$shaarli_repo_url\" -b \"$ref\" \"$shaarli_base_dir/$account\"; fi\ndone\n\n#generate html index of shaarlis\nhtmlhead='\n\n\n \n \n My Shaarli farm\n \n \n \n
\n

My Shaarli farm

\n
    '\n\naccountlinks=''\n\nhtmlfooter='\n
\n
\n \n' \n\n\n\nfor account in $accounts; do accountlinks=\"$accountlinks\\n
  • $account
    • \"; done\nif [ -d \"$shaarli_base_dir/index.html\" ]; then echo \"[removing old index.html]\"; rm \"$shaarli_base_dir/index.html\" ]; fi\necho \"[info] generating new index of shaarlis\"\necho -e \"$htmlhead $accountlinks $htmlfooter\" > \"$shaarli_base_dir/index.html\"\necho '[info] done.'\necho \"[info] list of accounts: $accounts\"\necho \"[info] contents of $shaarli_base_dir:\"\ntree -a -L 1 \"$shaarli_base_dir\"\n\n\n\n\nThis script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like \nAnsible", + "title": "Create and serve multiple Shaarlis (farm)" + }, + { + "location": "/Download-CSS-styles-from-an-OPML-list/", + "text": "Download CSS styles for shaarlis listed in an opml file\n\n\nExample php script:\n\n\n\n\n\n\n/**\n * Source: https://github.com/Riduidel\n * Download css styles for shaarlis listed in an opml file\n */\ndefine(\"SHAARLI_RSS_OPML\", \"https://www.ecirtam.net/shaarlirss/custom/people.opml\");\n\ndefine(\"THEMES_TEMP_FOLDER\", \"new_themes\");\n\nif(!file_exists(THEMES_TEMP_FOLDER)) {\n mkdir(THEMES_TEMP_FOLDER);\n}\n\nfunction siteUrl($pathInSite) {\n $indexPos = strpos($pathInSite, \"index.php\");\n if(!$indexPos) {\n return $pathInSite;\n } else {\n return substr($pathInSite, 0, $indexPos);\n }\n}\n\nfunction createShaarliHashFromOPMLL($opmlFile) {\n $result = array();\n $opml = file_get_contents($opmlFile);\n $opmlXml = simplexml_load_string($opml);\n $outlineElements = $opmlXml->xpath(\"body/outline\");\n foreach($outlineElements as $site) {\n $siteUrl = siteUrl((string) $site['htmlUrl']);\n $result[$siteUrl]=((string) $site['text']);\n }\n return $result;\n}\n\nfunction getSiteFolder($url) {\n $domain = parse_url($url, PHP_URL_HOST);\n return THEMES_TEMP_FOLDER.\"/\".str_replace(\".\", \"_\", $domain);\n}\n\nfunction get_http_response_code($theURL) {\n $headers = get_headers($theURL);\n return substr($headers[0], 9, 3);\n}\n\n/**\n * This makes the code PHP-5 only (particularly the call to \"get_headers\")\n */\nfunction copyUserStyleFrom($url, $name, $knownStyles) {\n $userStyle = $url.\"inc/user.css\";\n if(in_array($url, $knownStyles)) {\n // TODO add log message\n } else {\n $statusCode = get_http_response_code($userStyle);\n if(intval($statusCode)<300) {\n $styleSheet = file_get_contents($userStyle);\n $siteFolder = getSiteFolder($url);\n if(!file_exists($siteFolder)) {\n mkdir($siteFolder);\n }\n if(!file_exists($siteFolder.'/user.css')) {\n // Copy stylesheet\n file_put_contents($siteFolder.'/user.css', $styleSheet);\n }\n if(!file_exists($siteFolder.'/README.md')) {\n // Then write a readme.md file\n file_put_contents($siteFolder.'/README.md', \n \"User style from \".$name.\"\\n\"\n .\"=============================\"\n .\"\\n\\n\"\n .\"This stylesheet was downloaded from \".$userStyle.\" on \".date(DATE_RFC822)\n );\n }\n if(!file_exists($siteFolder.'/config.ini')) {\n // Write a config file containing useful informations\n file_put_contents($siteFolder.'/config.ini', \n \"site_url=\".$url.\"\\n\"\n .\"site_name=\".$name.\"\\n\"\n );\n }\n if(!file_exists($siteFolder.'/home.png')) {\n // And finally copy generated thumbnail\n $homeThumb = $siteFolder.'/home.png';\n file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));\n }\n echo 'Theme have been downloaded from '.$url.' into '.$siteFolder\n .'. It looks like
    ';\n }\n }\n}\n\nfunction getThumbnailUrl($url) {\n return 'http://api.webthumbnail.org/?url='.$url;\n}\n\nfunction copyUserStylesFrom($urlToNames, $knownStyles) {\n foreach($urlToNames as $url => $name) {\n copyUserStyleFrom($url, $name, $knownStyles);\n }\n}\n\n/**\n * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/\n * @param directory the directory we want to list files of\n * @return a simple array containing the list of absolute file paths. Notice that current file (\".\") and parent one(\"..\")\n * are not listed here\n */\nfunction getDirectoryList ($directory) {\n $realPath = realpath($directory);\n // create an array to hold directory list\n $results = array();\n // create a handler for the directory\n $handler = opendir($directory);\n // open directory and walk through the filenames\n while ($file = readdir($handler)) {\n // if file isn't this directory or its parent, add it to the results\n if ($file != \".\" && $file != \"..\") {\n $results[] = realpath($realPath . \"/\" . $file);\n }\n }\n // tidy up: close the handler\n closedir($handler);\n // done!\n return $results;\n}\n\n/**\n * Start in themes folder and look in all subfolders for config.ini files. \n * These config.ini files allow us not to download styles again and again\n */\nfunction findKnownStyles() {\n $result = array();\n $subFolders = getDirectoryList(\"themes\");\n foreach($subFolders as $folder) {\n $configFile = $folder.\"/config.ini\";\n if(file_exists($configFile)) {\n $iniParameters = parse_ini_file($configFile);\n array_push($result, $iniParameters['site_url']);\n }\n }\n return $result;\n}\n\n$knownStyles = findKnownStyles();\ncopyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);\n\n", + "title": "Download CSS styles from an OPML list" + }, + { + "location": "/Download-CSS-styles-from-an-OPML-list/#download-css-styles-for-shaarlis-listed-in-an-opml-file", + "text": "Example php script: \n\n\n\n/**\n * Source: https://github.com/Riduidel\n * Download css styles for shaarlis listed in an opml file\n */\ndefine(\"SHAARLI_RSS_OPML\", \"https://www.ecirtam.net/shaarlirss/custom/people.opml\");\n\ndefine(\"THEMES_TEMP_FOLDER\", \"new_themes\");\n\nif(!file_exists(THEMES_TEMP_FOLDER)) {\n mkdir(THEMES_TEMP_FOLDER);\n}\n\nfunction siteUrl($pathInSite) {\n $indexPos = strpos($pathInSite, \"index.php\");\n if(!$indexPos) {\n return $pathInSite;\n } else {\n return substr($pathInSite, 0, $indexPos);\n }\n}\n\nfunction createShaarliHashFromOPMLL($opmlFile) {\n $result = array();\n $opml = file_get_contents($opmlFile);\n $opmlXml = simplexml_load_string($opml);\n $outlineElements = $opmlXml->xpath(\"body/outline\");\n foreach($outlineElements as $site) {\n $siteUrl = siteUrl((string) $site['htmlUrl']);\n $result[$siteUrl]=((string) $site['text']);\n }\n return $result;\n}\n\nfunction getSiteFolder($url) {\n $domain = parse_url($url, PHP_URL_HOST);\n return THEMES_TEMP_FOLDER.\"/\".str_replace(\".\", \"_\", $domain);\n}\n\nfunction get_http_response_code($theURL) {\n $headers = get_headers($theURL);\n return substr($headers[0], 9, 3);\n}\n\n/**\n * This makes the code PHP-5 only (particularly the call to \"get_headers\")\n */\nfunction copyUserStyleFrom($url, $name, $knownStyles) {\n $userStyle = $url.\"inc/user.css\";\n if(in_array($url, $knownStyles)) {\n // TODO add log message\n } else {\n $statusCode = get_http_response_code($userStyle);\n if(intval($statusCode)<300) {\n $styleSheet = file_get_contents($userStyle);\n $siteFolder = getSiteFolder($url);\n if(!file_exists($siteFolder)) {\n mkdir($siteFolder);\n }\n if(!file_exists($siteFolder.'/user.css')) {\n // Copy stylesheet\n file_put_contents($siteFolder.'/user.css', $styleSheet);\n }\n if(!file_exists($siteFolder.'/README.md')) {\n // Then write a readme.md file\n file_put_contents($siteFolder.'/README.md', \n \"User style from \".$name.\"\\n\"\n .\"=============================\"\n .\"\\n\\n\"\n .\"This stylesheet was downloaded from \".$userStyle.\" on \".date(DATE_RFC822)\n );\n }\n if(!file_exists($siteFolder.'/config.ini')) {\n // Write a config file containing useful informations\n file_put_contents($siteFolder.'/config.ini', \n \"site_url=\".$url.\"\\n\"\n .\"site_name=\".$name.\"\\n\"\n );\n }\n if(!file_exists($siteFolder.'/home.png')) {\n // And finally copy generated thumbnail\n $homeThumb = $siteFolder.'/home.png';\n file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));\n }\n echo 'Theme have been downloaded from '.$url.' into '.$siteFolder\n .'. It looks like
    ';\n }\n }\n}\n\nfunction getThumbnailUrl($url) {\n return 'http://api.webthumbnail.org/?url='.$url;\n}\n\nfunction copyUserStylesFrom($urlToNames, $knownStyles) {\n foreach($urlToNames as $url => $name) {\n copyUserStyleFrom($url, $name, $knownStyles);\n }\n}\n\n/**\n * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/\n * @param directory the directory we want to list files of\n * @return a simple array containing the list of absolute file paths. Notice that current file (\".\") and parent one(\"..\")\n * are not listed here\n */\nfunction getDirectoryList ($directory) {\n $realPath = realpath($directory);\n // create an array to hold directory list\n $results = array();\n // create a handler for the directory\n $handler = opendir($directory);\n // open directory and walk through the filenames\n while ($file = readdir($handler)) {\n // if file isn't this directory or its parent, add it to the results\n if ($file != \".\" && $file != \"..\") {\n $results[] = realpath($realPath . \"/\" . $file);\n }\n }\n // tidy up: close the handler\n closedir($handler);\n // done!\n return $results;\n}\n\n/**\n * Start in themes folder and look in all subfolders for config.ini files. \n * These config.ini files allow us not to download styles again and again\n */\nfunction findKnownStyles() {\n $result = array();\n $subFolders = getDirectoryList(\"themes\");\n foreach($subFolders as $folder) {\n $configFile = $folder.\"/config.ini\";\n if(file_exists($configFile)) {\n $iniParameters = parse_ini_file($configFile);\n array_push($result, $iniParameters['site_url']);\n }\n }\n return $result;\n}\n\n$knownStyles = findKnownStyles();\ncopyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);\n\n", + "title": "Download CSS styles for shaarlis listed in an opml file" + }, + { + "location": "/Datastore-hacks/", + "text": "Decode datastore content\n\n\nTo display the array representing the data saved in \ndata/datastore.php\n, use the following snippet:\n\n\n$data = \"tZNdb9MwFIb... \";\n$out = unserialize(gzinflate(base64_decode($data)));\necho \"
    \"; // Pretty printing is love, pretty printing is life\nprint_r($out);\necho \"
    \";\nexit;\n\n\n\n\nThis will output the internal representation of the datastore, \"unobfuscated\" (if this can really be considered obfuscation).\n\n\nAlternatively, you can transform to JSON format (and pretty-print if you have \njq\n installed):\n\n\nphp -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace(\"!.*/\\* (.+) \\*/.*!\", \"$1\", file_get_contents(\"data/datastore.php\")))))));' | jq .\n\n\n\n\nChanging the timestamp for a link\n\n\n\n\nLook for \n\n in \ntpl/editlink.tpl\n (line 14)\n\n\nReplace \ntype=\"hidden\"\n with \ntype=\"text\"\n from this line\n\n\nA new date/time field becomes available in the edit/new link dialog.\n\n\nYou can set the timestamp manually by entering it in the format \nYYYMMDD_HHMMS\n.", + "title": "Datastore hacks" + }, + { + "location": "/Datastore-hacks/#decode-datastore-content", + "text": "To display the array representing the data saved in data/datastore.php , use the following snippet: $data = \"tZNdb9MwFIb... \";\n$out = unserialize(gzinflate(base64_decode($data)));\necho \"
    \"; // Pretty printing is love, pretty printing is life\nprint_r($out);\necho \"
    \";\nexit; This will output the internal representation of the datastore, \"unobfuscated\" (if this can really be considered obfuscation). Alternatively, you can transform to JSON format (and pretty-print if you have jq installed): php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace(\"!.*/\\* (.+) \\*/.*!\", \"$1\", file_get_contents(\"data/datastore.php\")))))));' | jq .", + "title": "Decode datastore content" + }, + { + "location": "/Datastore-hacks/#changing-the-timestamp-for-a-link", + "text": "Look for in tpl/editlink.tpl (line 14) Replace type=\"hidden\" with type=\"text\" from this line A new date/time field becomes available in the edit/new link dialog. You can set the timestamp manually by entering it in the format YYYMMDD_HHMMS .", + "title": "Changing the timestamp for a link" + }, + { + "location": "/Troubleshooting/", + "text": "Troubleshooting\n\n\nBrowser\n\n\nRedirection issues (HTTP Referer)\n\n\nDepending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.\n\n\nSee:\n- \nHTTP referer\n (Wikipedia)\n- \nImprove online privacy by controlling referrer information\n\n- \nBetter security, privacy and anonymity in Firefox\n\n\nFirefox HTTP Referer options\n\n\nHTTP settings are available by browsing \nabout:config\n, here are the available settings and their values.\n\n\nnetwork.http.sendRefererHeader\n - determines when to send the Referer HTTP header\n- 0: Never send the referring URL\n - not recommended, may break some sites\n- 1: Send only on clicked links\n- 2 (default): Send for links and images\n\n\nnetwork.http.referer.XOriginPolicy\n - Cross-domain origin policy\n- 0 (default): Always send\n- 1: Send if base domains match\n- 2: Send if hosts match\n\n\nnetwork.http.referer.spoofSource\n - Referer spoofing (~faking)\n- false (default): real referer\n- true: spoof referer (use target URI as referer)\n - known to break some functionality in Shaarli\n\n\nnetwork.http.referer.trimmingPolicy\n - trim the URI not to send a full Referer\n- 0 (default): send full URI\n- 1: scheme+host+port+path\n- 2: scheme+host+port\n\n\nFirefox, localhost and redirections\n\n\nlocalhost\n is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly.\n\n\nTo solve this, assign a local domain to your host, e.g.\n\n\n127.0.0.1 localhost desktop localhost.lan\n::1 localhost desktop localhost.lan\n\n\n\n\nand browse Shaarli at http://localhost.lan/.\n\n\nRelated threads:\n- \nWhat is localhost.localdomain for?\n\n- \nStop returning to the first page after editing a bookmark from another page\n\n\nLogin\n\n\nI forgot my password!\n\n\nDelete the file \ndata/config.php\n and display the page again. You will be asked for a new login/password.\n\n\nI'm locked out - Login bruteforce protection\n\n\nLogin form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links.\n\n\nTo remove the current IP bans, delete the file \ndata/ipbans.php\n\n\nList of all login attempts\n\n\nThe file \ndata/log.txt\n shows all logins (successful or failed) and bans/lifted bans.\nSearch for \nfailed\n in this file to look for unauthorized login attempts.\n\n\nHosting problems\n\n\nOld PHP versions\n\n\n\n\nOn \nfree.fr\n : free.fr now support php 5.6.x(\nlink\n)and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a \nsessions\n directory and a \n.htaccess\n file containing:\n\n\n\n\n\nphp56 1\n\n\n\n\n\n\n\nIf you have an error such as: \nParse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx\n, it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to \n.php5\n\n\nOn \n1and1\n : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).\n\n\nIf you have the error \nWarning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /\u2026/index.php on line xxx\n, it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines:\n\n\n\n\n//list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.\n// FIXME: Decode charset according to charset specified in either 1) HTTP response headers or 2) in html \n//if (strpos($status,'200 OK')) $title=html_extract_title($data);\n\n\n\n\n\n\nOn hosts which forbid outgoing HTTP requests (such as free.fr), some thumbnails will not work.\n\n\nOn \nlost-oasis\n, RSS doesn't work correctly, because of this message at the begining of the RSS/ATOM feed : \n\n. To fix this, remove this message from \nphp-include/prepend.php\n\n\n\n\nDates are not properly formatted\n\n\nShaarli tries to sniff the language of the browser (using HTTP_ACCEPT_LANGUAGE headers) and choose a date format accordingly. But Shaarli can only use the date formats (and more generaly speaking, the locales) provided by the webserver. So even if you have a browser in French, you may end up with dates in US format (it's the case on sebsauvage.net :-( )\n\n\nProblems on CentOS servers\n\n\nOn \nCentOS\n/RedHat derivatives, you may need to install the \nphp-mbstring\n package.\n\n\nMy session expires! I can't stay logged in\n\n\nThis can be caused by several things:\n\n\n\n\nYour php installation may not have a proper directory setup for session files. (eg. on Free.fr you need to create a \nsession\n directory on the root of your website.) You may need to create the session directory of set it up.\n\n\nMost hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the \nsessions\n subdirectory and add \nini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions');\n. Make sure this directory is not browsable !)\n\n\nIf your IP address changes during surfing, Shaarli will force expire your session for security reasons (to prevent session cookie hijacking). This can happen when surfing from WiFi or 3G (you may have switched WiFi/3G access point), or in some corporate/university proxies which use load balancing (and may have proxies with several external IP addresses).\n\n\nSome browser addons may interfer with HTTP headers (ipfuck/ipflood/GreaseMonkey\u2026). Try disabling those.\n\n\nYou may be using OperaTurbo or OperaMini, which use their own proxies which may change from time to time.\n\n\nIf you have another application on the same webserver where Shaarli is installed, these application may forcefully expire php sessions.\n\n\n\n\nSessions do not seem to work correctly on your server\n\n\nFollow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have \nno dots\n in the hostname (e.g. \nlocalhost\n or \nhttp://my-webserver/shaarli/\n), some browsers will not store cookies at all (this respects the \nHTTP cookie specification\n).\n\n\npubsubhubbub support\n\n\nDownload \npublisher.php\n at the root of your Shaarli installation and set \n$GLOBALS['config']['PUBSUBHUB_URL']\n in your \nconfig.php", + "title": "Troubleshooting" + }, + { + "location": "/Troubleshooting/#troubleshooting", + "text": "", + "title": "Troubleshooting" + }, + { + "location": "/Troubleshooting/#browser", + "text": "", + "title": "Browser" + }, + { + "location": "/Troubleshooting/#redirection-issues-http-referer", + "text": "Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages. See:\n- HTTP referer (Wikipedia)\n- Improve online privacy by controlling referrer information \n- Better security, privacy and anonymity in Firefox", + "title": "Redirection issues (HTTP Referer)" + }, + { + "location": "/Troubleshooting/#firefox-http-referer-options", + "text": "HTTP settings are available by browsing about:config , here are the available settings and their values. network.http.sendRefererHeader - determines when to send the Referer HTTP header\n- 0: Never send the referring URL\n - not recommended, may break some sites\n- 1: Send only on clicked links\n- 2 (default): Send for links and images network.http.referer.XOriginPolicy - Cross-domain origin policy\n- 0 (default): Always send\n- 1: Send if base domains match\n- 2: Send if hosts match network.http.referer.spoofSource - Referer spoofing (~faking)\n- false (default): real referer\n- true: spoof referer (use target URI as referer)\n - known to break some functionality in Shaarli network.http.referer.trimmingPolicy - trim the URI not to send a full Referer\n- 0 (default): send full URI\n- 1: scheme+host+port+path\n- 2: scheme+host+port", + "title": "Firefox HTTP Referer options" + }, + { + "location": "/Troubleshooting/#firefox-localhost-and-redirections", + "text": "localhost is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly. To solve this, assign a local domain to your host, e.g. 127.0.0.1 localhost desktop localhost.lan\n::1 localhost desktop localhost.lan and browse Shaarli at http://localhost.lan/. Related threads:\n- What is localhost.localdomain for? \n- Stop returning to the first page after editing a bookmark from another page", + "title": "Firefox, localhost and redirections" + }, + { + "location": "/Troubleshooting/#login", + "text": "", + "title": "Login" + }, + { + "location": "/Troubleshooting/#i-forgot-my-password", + "text": "Delete the file data/config.php and display the page again. You will be asked for a new login/password.", + "title": "I forgot my password!" + }, + { + "location": "/Troubleshooting/#im-locked-out-login-bruteforce-protection", + "text": "Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links. To remove the current IP bans, delete the file data/ipbans.php", + "title": "I'm locked out - Login bruteforce protection" + }, + { + "location": "/Troubleshooting/#list-of-all-login-attempts", + "text": "The file data/log.txt shows all logins (successful or failed) and bans/lifted bans.\nSearch for failed in this file to look for unauthorized login attempts.", + "title": "List of all login attempts" + }, + { + "location": "/Troubleshooting/#hosting-problems", + "text": "", + "title": "Hosting problems" + }, + { + "location": "/Troubleshooting/#old-php-versions", + "text": "On free.fr : free.fr now support php 5.6.x( link )and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a sessions directory and a .htaccess file containing: \nphp56 1\n If you have an error such as: Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx , it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to .php5 On 1and1 : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP). If you have the error Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /\u2026/index.php on line xxx , it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines: //list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.\n// FIXME: Decode charset according to charset specified in either 1) HTTP response headers or 2) in html \n//if (strpos($status,'200 OK')) $title=html_extract_title($data); On hosts which forbid outgoing HTTP requests (such as free.fr), some thumbnails will not work. On lost-oasis , RSS doesn't work correctly, because of this message at the begining of the RSS/ATOM feed : . To fix this, remove this message from php-include/prepend.php", + "title": "Old PHP versions" + }, + { + "location": "/Troubleshooting/#dates-are-not-properly-formatted", + "text": "Shaarli tries to sniff the language of the browser (using HTTP_ACCEPT_LANGUAGE headers) and choose a date format accordingly. But Shaarli can only use the date formats (and more generaly speaking, the locales) provided by the webserver. So even if you have a browser in French, you may end up with dates in US format (it's the case on sebsauvage.net :-( )", + "title": "Dates are not properly formatted" + }, + { + "location": "/Troubleshooting/#problems-on-centos-servers", + "text": "On CentOS /RedHat derivatives, you may need to install the php-mbstring package.", + "title": "Problems on CentOS servers" + }, + { + "location": "/Troubleshooting/#my-session-expires-i-cant-stay-logged-in", + "text": "This can be caused by several things: Your php installation may not have a proper directory setup for session files. (eg. on Free.fr you need to create a session directory on the root of your website.) You may need to create the session directory of set it up. Most hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the sessions subdirectory and add ini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions'); . Make sure this directory is not browsable !) If your IP address changes during surfing, Shaarli will force expire your session for security reasons (to prevent session cookie hijacking). This can happen when surfing from WiFi or 3G (you may have switched WiFi/3G access point), or in some corporate/university proxies which use load balancing (and may have proxies with several external IP addresses). Some browser addons may interfer with HTTP headers (ipfuck/ipflood/GreaseMonkey\u2026). Try disabling those. You may be using OperaTurbo or OperaMini, which use their own proxies which may change from time to time. If you have another application on the same webserver where Shaarli is installed, these application may forcefully expire php sessions.", + "title": "My session expires! I can't stay logged in" + }, + { + "location": "/Troubleshooting/#sessions-do-not-seem-to-work-correctly-on-your-server", + "text": "Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have no dots in the hostname (e.g. localhost or http://my-webserver/shaarli/ ), some browsers will not store cookies at all (this respects the HTTP cookie specification ).", + "title": "Sessions do not seem to work correctly on your server" + }, + { + "location": "/Troubleshooting/#pubsubhubbub-support", + "text": "Download publisher.php at the root of your Shaarli installation and set $GLOBALS['config']['PUBSUBHUB_URL'] in your config.php", + "title": "pubsubhubbub support" + }, + { + "location": "/Development-guidelines/", + "text": "Development guidelines\n\n\nPlease have a look at the following pages:\n- \nContributing to Shaarli\n\n- \nStatic analysis\n - patches should try to stick to the \nPHP Standard Recommendations\n (PSR), especially:\n - \nPSR-1\n - Basic Coding Standard\n - \nPSR-2\n - Coding Style Guide\n- \nUnit tests\n\n- \nGnuPG signature\n for tags/releases", + "title": "Development guidelines" + }, + { + "location": "/Development-guidelines/#development-guidelines", + "text": "Please have a look at the following pages:\n- Contributing to Shaarli \n- Static analysis - patches should try to stick to the PHP Standard Recommendations (PSR), especially:\n - PSR-1 - Basic Coding Standard\n - PSR-2 - Coding Style Guide\n- Unit tests \n- GnuPG signature for tags/releases", + "title": "Development guidelines" + }, + { + "location": "/Continuous-integration-tools/", + "text": "Local development\n\n\nA \nMakefile\n is available to perform project-related operations:\n- Documentation - generate a local HTML copy of the GitHub wiki\n- \nStatic analysis\n - check that the code is compliant to PHP conventions\n- \nUnit tests\n - ensure there are no regressions introduced by new commits\n\n\nAutomatic builds\n\n\nTravis CI\n is a Continuous Integration build server, that runs a build:\n- each time a commit is merged to the mainline (\nmaster\n branch)\n- each time a Pull Request is submitted or updated\n\n\nA build is composed of several jobs: one for each supported PHP version (see \nServer requirements\n).\n\n\nEach build job:\n- updates Composer\n- installs 3rd-party test dependencies with Composer\n- runs \nUnit tests\n\n\nAfter all jobs have finished, Travis returns the results to GitHub:\n- a status icon represents the result for the \nmaster\n branch: \n\n- Pull Requests are updated with the Travis result\n - Green: all tests have passed\n - Red: some tests failed\n - Orange: tests are pending", + "title": "Continuous integration tools" + }, + { + "location": "/Continuous-integration-tools/#local-development", + "text": "A Makefile is available to perform project-related operations:\n- Documentation - generate a local HTML copy of the GitHub wiki\n- Static analysis - check that the code is compliant to PHP conventions\n- Unit tests - ensure there are no regressions introduced by new commits", + "title": "Local development" + }, + { + "location": "/Continuous-integration-tools/#automatic-builds", + "text": "Travis CI is a Continuous Integration build server, that runs a build:\n- each time a commit is merged to the mainline ( master branch)\n- each time a Pull Request is submitted or updated A build is composed of several jobs: one for each supported PHP version (see Server requirements ). Each build job:\n- updates Composer\n- installs 3rd-party test dependencies with Composer\n- runs Unit tests After all jobs have finished, Travis returns the results to GitHub:\n- a status icon represents the result for the master branch: \n- Pull Requests are updated with the Travis result\n - Green: all tests have passed\n - Red: some tests failed\n - Orange: tests are pending", + "title": "Automatic builds" + }, + { + "location": "/GnuPG-signature/", + "text": "Introduction\n\n\nPGP and GPG\n\n\nGnu Privacy Guard\n (GnuPG) is an Open Source implementation of the \nPretty Good \nPrivacy\n (OpenPGP) specification. Its main purposes are digital authentication, \nsignature and encryption.\n\n\nIt is often used by the \nFLOSS\n community to verify:\n- Linux package signatures: Debian \nSecureApt\n, ArchLinux \nMaster \nKeys\n\n- \nSCM\n releases & maintainer identity\n\n\nTrust\n\n\nTo quote Phil Pennock (the author of the \nSKS\n key server - http://sks.spodhuis.org/):\n\n\n\n\nYou MUST understand that presence of data in the keyserver (pools) in no way connotes trust. Anyone can generate a key, with any name or email address, and upload it. All security and trust comes from evaluating security at the \u201cobject level\u201d, via PGP Web-Of-Trust signatures. This keyserver makes it possible to retrieve keys, looking them up via various indices, but the collection of keys in this public pool is KNOWN to contain malicious and fraudulent keys. It is the common expectation of server operators that users understand this and use software which, like all known common OpenPGP implementations, evaluates trust accordingly. This expectation is so common that it is not normally explicitly stated.\n\n\n\n\nTrust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during \nkey signing parties\n, see:\n- \nThe Keysigning party HOWTO\n\n- \nWeb of trust\n\n\nGenerate a GPG key\n\n\n\n\nGenerating a GPG key for Git tagging\n (StackOverflow)\n\n\nGenerating a GPG key\n (GitHub)\n\n\n\n\ngpg - provide identity information\n\n\n$ gpg --gen-key\n\ngpg (GnuPG) 2.1.6; Copyright (C) 2015 Free Software Foundation, Inc.\nThis is free software: you are free to change and redistribute it.\nThere is NO WARRANTY, to the extent permitted by law.\n\nNote: Use \"gpg2 --full-gen-key\" for a full featured key generation dialog.\n\nGnuPG needs to construct a user ID to identify your key.\n\nReal name: Marvin the Paranoid Android\nEmail address: marvin@h2g2.net\nYou selected this USER-ID:\n \"Marvin the Paranoid Android \"\n\nChange (N)ame, (E)mail, or (O)kay/(Q)uit? o\nWe need to generate a lot of random bytes. It is a good idea to perform\nsome other action (type on the keyboard, move the mouse, utilize the\ndisks) during the prime generation; this gives the random number\ngenerator a better chance to gain enough entropy.\n\n\n\n\ngpg - entropy interlude\n\n\nAt this point, you will:\n- be prompted for a secure password to protect your key (the input method will depend on your Desktop Environment and configuration)\n- be asked to use your machine's input devices (mouse, keyboard, etc.) to generate random entropy; this step \nmay take some time\n \n\n\ngpg - key creation confirmation\n\n\ngpg: key A9D53A3E marked as ultimately trusted\npublic and secret key created and signed.\n\ngpg: checking the trustdb\ngpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model\ngpg: depth: 0 valid: 2 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 2u\npub rsa2048/A9D53A3E 2015-07-31\n Key fingerprint = AF2A 5381 E54B 2FD2 14C4 A9A3 0E35 ACA4 A9D5 3A3E\nuid [ultimate] Marvin the Paranoid Android \nsub rsa2048/8C0EACF1 2015-07-31\n\n\n\n\ngpg - submit your public key to a PGP server (Optional)\n\n\n$ gpg --keyserver pgp.mit.edu --send-keys A9D53A3E\ngpg: sending key A9D53A3E to hkp server pgp.mit.edu\n\n\n\n\nCreate and push a GPG-signed tag\n\n\nSee \nRelease Shaarli\n.", + "title": "GnuPG signature" + }, + { + "location": "/GnuPG-signature/#introduction", + "text": "", + "title": "Introduction" + }, + { + "location": "/GnuPG-signature/#pgp-and-gpg", + "text": "Gnu Privacy Guard (GnuPG) is an Open Source implementation of the Pretty Good \nPrivacy (OpenPGP) specification. Its main purposes are digital authentication, \nsignature and encryption. It is often used by the FLOSS community to verify:\n- Linux package signatures: Debian SecureApt , ArchLinux Master \nKeys \n- SCM releases & maintainer identity", + "title": "PGP and GPG" + }, + { + "location": "/GnuPG-signature/#trust", + "text": "To quote Phil Pennock (the author of the SKS key server - http://sks.spodhuis.org/): You MUST understand that presence of data in the keyserver (pools) in no way connotes trust. Anyone can generate a key, with any name or email address, and upload it. All security and trust comes from evaluating security at the \u201cobject level\u201d, via PGP Web-Of-Trust signatures. This keyserver makes it possible to retrieve keys, looking them up via various indices, but the collection of keys in this public pool is KNOWN to contain malicious and fraudulent keys. It is the common expectation of server operators that users understand this and use software which, like all known common OpenPGP implementations, evaluates trust accordingly. This expectation is so common that it is not normally explicitly stated. Trust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during key signing parties , see:\n- The Keysigning party HOWTO \n- Web of trust", + "title": "Trust" + }, + { + "location": "/GnuPG-signature/#generate-a-gpg-key", + "text": "Generating a GPG key for Git tagging (StackOverflow) Generating a GPG key (GitHub)", + "title": "Generate a GPG key" + }, + { + "location": "/GnuPG-signature/#gpg-provide-identity-information", + "text": "$ gpg --gen-key\n\ngpg (GnuPG) 2.1.6; Copyright (C) 2015 Free Software Foundation, Inc.\nThis is free software: you are free to change and redistribute it.\nThere is NO WARRANTY, to the extent permitted by law.\n\nNote: Use \"gpg2 --full-gen-key\" for a full featured key generation dialog.\n\nGnuPG needs to construct a user ID to identify your key.\n\nReal name: Marvin the Paranoid Android\nEmail address: marvin@h2g2.net\nYou selected this USER-ID:\n \"Marvin the Paranoid Android \"\n\nChange (N)ame, (E)mail, or (O)kay/(Q)uit? o\nWe need to generate a lot of random bytes. It is a good idea to perform\nsome other action (type on the keyboard, move the mouse, utilize the\ndisks) during the prime generation; this gives the random number\ngenerator a better chance to gain enough entropy.", + "title": "gpg - provide identity information" + }, + { + "location": "/GnuPG-signature/#gpg-entropy-interlude", + "text": "At this point, you will:\n- be prompted for a secure password to protect your key (the input method will depend on your Desktop Environment and configuration)\n- be asked to use your machine's input devices (mouse, keyboard, etc.) to generate random entropy; this step may take some time", + "title": "gpg - entropy interlude" + }, + { + "location": "/GnuPG-signature/#gpg-key-creation-confirmation", + "text": "gpg: key A9D53A3E marked as ultimately trusted\npublic and secret key created and signed.\n\ngpg: checking the trustdb\ngpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model\ngpg: depth: 0 valid: 2 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 2u\npub rsa2048/A9D53A3E 2015-07-31\n Key fingerprint = AF2A 5381 E54B 2FD2 14C4 A9A3 0E35 ACA4 A9D5 3A3E\nuid [ultimate] Marvin the Paranoid Android \nsub rsa2048/8C0EACF1 2015-07-31", + "title": "gpg - key creation confirmation" + }, + { + "location": "/GnuPG-signature/#gpg-submit-your-public-key-to-a-pgp-server-optional", + "text": "$ gpg --keyserver pgp.mit.edu --send-keys A9D53A3E\ngpg: sending key A9D53A3E to hkp server pgp.mit.edu", + "title": "gpg - submit your public key to a PGP server (Optional)" + }, + { + "location": "/GnuPG-signature/#create-and-push-a-gpg-signed-tag", + "text": "See Release Shaarli .", + "title": "Create and push a GPG-signed tag" + }, + { + "location": "/Coding-guidelines/", + "text": "WIP\n\n\nThis topic is currently being discussed here:\n- \nFix coding style (static analysis)\n (#95)\n- \nContinuous Integration tools & features\n (#130)", + "title": "Coding guidelines" + }, + { + "location": "/Coding-guidelines/#wip", + "text": "This topic is currently being discussed here:\n- Fix coding style (static analysis) (#95)\n- Continuous Integration tools & features (#130)", + "title": "WIP" + }, + { + "location": "/Directory-structure/", + "text": "Here is the directory structure of Shaarli and the purpose of the different files:\n\n\n index.php # Main program\n application/ # Shaarli classes\n \u251c\u2500\u2500 LinkDB.php\n \u2514\u2500\u2500 Utils.php\n tests/ # Shaarli unitary & functional tests\n \u251c\u2500\u2500 LinkDBTest.php\n \u251c\u2500\u2500 utils # utilities to ease testing\n \u2502 \u2514\u2500\u2500 ReferenceLinkDB.php\n \u2514\u2500\u2500 UtilsTest.php\n COPYING # Shaarli license\n inc/ # static assets and 3rd party libraries\n \u251c\u2500\u2500 awesomplete.* # tags autocompletion library\n \u251c\u2500\u2500 blazy.* # picture wall lazy image loading library\n \u251c\u2500\u2500 shaarli.css, reset.css # Shaarli stylesheet.\n \u251c\u2500\u2500 qr.* # qr code generation library\n \u2514\u2500\u2500rain.tpl.class.php # RainTPL templating library\n tpl/ # RainTPL templates for Shaarli. They are used to build the pages.\n images/ # Images and icons used in Shaarli\n data/ # data storage: bookmark database, configuration, logs, banlist\u2026\n \u251c\u2500\u2500 config.php # Shaarli configuration (login, password, timezone, title\u2026)\n \u251c\u2500\u2500 datastore.php # Your link database (compressed).\n \u251c\u2500\u2500 ipban.php # IP address ban system data\n \u251c\u2500\u2500 lastupdatecheck.txt # Update check timestamp file\n \u2514\u2500\u2500log.txt # login/IPban log.\n cache/ # thumbnails cache\n # This directory is automatically created. You can erase it anytime you want.\n tmp/ # Temporary directory for compiled RainTPL templates.\n # This directory is automatically created. You can erase it anytime you want.", + "title": "Directory structure" + }, + { + "location": "/3rd-party-libraries/", + "text": "CSS\n\n\n\n\nYahoo UI \nCSS Reset\n\n\nresets default CSS properties for all HTML elements (overriding browsers' default values)\n\n\nensures custom CSS stylessheets will provide the same results on all browsers\n\n\n\n\n\n\n\n\nJavascript\n\n\n\n\nAwesomeplete\n (\nGitHub\n) - autocompletion in input forms\n\n\nbLazy\n (\nGitHub\n) - lazy loading for thumbnails\n\n\nqr.js\n (\nGitHub\n) - QR code generation\n\n\n\n\nPHP\n\n\n\n\nshaarli/netscape-bookmark-parser\n - Netscape bookmark parser\n\n\nRainTPL\n - HTML templating for PHP", + "title": "3rd party libraries" + }, + { + "location": "/3rd-party-libraries/#css", + "text": "Yahoo UI CSS Reset resets default CSS properties for all HTML elements (overriding browsers' default values) ensures custom CSS stylessheets will provide the same results on all browsers", + "title": "CSS" + }, + { + "location": "/3rd-party-libraries/#javascript", + "text": "Awesomeplete ( GitHub ) - autocompletion in input forms bLazy ( GitHub ) - lazy loading for thumbnails qr.js ( GitHub ) - QR code generation", + "title": "Javascript" + }, + { + "location": "/3rd-party-libraries/#php", + "text": "shaarli/netscape-bookmark-parser - Netscape bookmark parser RainTPL - HTML templating for PHP", + "title": "PHP" + }, + { + "location": "/Plugin-System/", + "text": "I am a developer.\n Developer API.\n\n\nI am a template designer.\n Guide for template designer.\n\n\nDeveloper API\n\n\nWhat can I do with plugins?\n\n\nThe plugin system let you:\n\n\n\n\ninsert content into specific places across templates.\n\n\nalter data before templates rendering.\n\n\nalter data before saving new links.\n\n\n\n\nHow can I create a plugin for Shaarli?\n\n\nFirst, chose a plugin name, such as \ndemo_plugin\n.\n\n\nUnder \nplugin\n folder, create a folder named with your plugin name. Then create a \n.php file in that folder.\n\n\nYou should have the following tree view:\n\n\n| index.php\n| plugins/\n|---| demo_plugin/\n| |---| demo_plugin.php\n\n\n\n\nPlugin initialization\n\n\nAt the beginning of Shaarli execution, all enabled plugins are loaded. At this point, the plugin system looks for an \ninit()\n function to execute and run it if it exists. This function must be named this way, and takes the \nConfigManager\n as parameter.\n\n\n_init($conf)\n\n\n\nThis function can be used to create initial data, load default settings, etc. But also to set \nplugin errors\n. If the initialization function returns an array of strings, they will be understand as errors, and displayed in the header to logged in users.\n\n\nUnderstanding hooks\n\n\nA plugin is a set of functions. Each function will be triggered by the plugin system at certain point in Shaarli execution.\n\n\nThese functions need to be named with this pattern:\n\n\nhook__($data, $conf)\n\n\n\n\nParameters:\n\n\n\n\ndata: see \n$data section\n\n\nconf: the \nConfigManager\n instance.\n\n\n\n\nFor exemple, if my plugin want to add data to the header, this function is needed:\n\n\nhook_demo_plugin_render_header\n\n\n\nIf this function is declared, and the plugin enabled, it will be called every time Shaarli is rendering the header.\n\n\nPlugin's data\n\n\nParameters\n\n\nEvery hook function has a \n$data\n parameter. Its content differs for each hooks.\n\n\nThis parameter needs to be returned every time\n, otherwise data is lost.\n\n\nreturn $data;\n\n\n\nFilling templates placeholder\n\n\nTemplate placeholders are displayed in template in specific places.\n\n\nRainTPL displays every element contained in the placeholder's array. These element can be added by plugins.\n\n\nFor example, let's add a value in the placeholder \ntop_placeholder\n which is displayed at the top of my page:\n\n\n$data['top_placeholder'][] = 'My content';\n# OR\narray_push($data['top_placeholder'], 'My', 'content');\n\nreturn $data;\n\n\n\n\nData manipulation\n\n\nWhen a page is displayed, every variable send to the template engine is passed to plugins before that in \n$data\n.\n\n\nThe data contained by this array can be altered before template rendering.\n\n\nFor exemple, in linklist, it is possible to alter every title:\n\n\n// mind the reference if you want $data to be altered\nforeach ($data['links'] as &$value) {\n // String reverse every title.\n $value['title'] = strrev($value['title']);\n}\n\nreturn $data;\n\n\n\n\nMetadata\n\n\nEvery plugin needs a \n.meta\n file, which is in fact an \n.ini\n file (\nKEY=\"VALUE\"\n), to be listed in plugin administration.\n\n\nEach file contain two keys:\n\n\n\n\ndescription\n: plugin description\n\n\nparameters\n: user parameter names, separated by a \n;\n.\n\n\nparameter.\n: add a text description the specified parameter.\n\n\n\n\n\n\nNote: In PHP, \nparse_ini_file()\n seems to want strings to be between by quotes \n\"\n in the ini file.\n\n\n\n\nIt's not working!\n\n\nUse \ndemo_plugin\n as a functional example. It covers most of the plugin system features.\n\n\nIf it's still not working, please \nopen an issue\n.\n\n\nHooks\n\n\n\n\n\n\n\n\nHooks\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nrender_header\n\n\nAllow plugin to add content in page headers.\n\n\n\n\n\n\nrender_includes\n\n\nAllow plugin to include their own CSS files.\n\n\n\n\n\n\nrender_footer\n\n\nAllow plugin to add content in page footer and include their own JS files.\n\n\n\n\n\n\nrender_linklist\n\n\nIt allows to add content at the begining and end of the page, after every link displayed and to alter link data.\n\n\n\n\n\n\nrender_editlink\n\n\nAllow to add fields in the form, or display elements.\n\n\n\n\n\n\nrender_tools\n\n\nAllow to add content at the end of the page.\n\n\n\n\n\n\nrender_picwall\n\n\nAllow to add content at the top and bottom of the page.\n\n\n\n\n\n\nrender_tagcloud\n\n\nAllow to add content at the top and bottom of the page, and after all tags.\n\n\n\n\n\n\nrender_taglist\n\n\nAllow to add content at the top and bottom of the page, and after all tags.\n\n\n\n\n\n\nrender_daily\n\n\nAllow to add content at the top and bottom of the page, the bottom of each link and to alter data.\n\n\n\n\n\n\nrender_feed\n\n\nAllow to do add tags in RSS and ATOM feeds.\n\n\n\n\n\n\nsave_link\n\n\nAllow to alter the link being saved in the datastore.\n\n\n\n\n\n\ndelete_link\n\n\nAllow to do an action before a link is deleted from the datastore.\n\n\n\n\n\n\n\n\nrender_header\n\n\nTriggered on every page.\n\n\nAllow plugin to add content in page headers.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_PAGE_\n: current target page (eg: \nlinklist\n, \npicwall\n, etc.).\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\nbuttons_toolbar\n: after the list of buttons in the header.\n\n\n\n\n\n\n\n\nfields_toolbar\n: after search fields in the header.\n\n\n\n\n\n\nNote: This will only be called in linklist.\n\n\n\n\n\n\nrender_includes\n\n\nTriggered on every page.\n\n\nAllow plugin to include their own CSS files.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_PAGE_\n: current target page (eg: \nlinklist\n, \npicwall\n, etc.).\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\ncss_files\n: called after loading default CSS.\n\n\n\n\n\n\nNote: only add the path of the CSS file. E.g: \nplugins/demo_plugin/custom_demo.css\n.\n\n\n\n\nrender_footer\n\n\nTriggered on every page.\n\n\nAllow plugin to add content in page footer and include their own JS files.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_PAGE_\n: current target page (eg: \nlinklist\n, \npicwall\n, etc.).\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\ntext\n: called after the end of the footer text.\n\n\nendofpage\n: called at the end of the page.\n\n\n\n\n\n\n\n\njs_files\n: called at the end of the page, to include custom JS scripts.\n\n\n\n\n\n\nNote: only add the path of the JS file. E.g: \nplugins/demo_plugin/custom_demo.js\n.\n\n\n\n\nrender_linklist\n\n\nTriggered when \nlinklist\n is displayed (list of links, permalink, search, tag filtered, etc.).\n\n\nIt allows to add content at the begining and end of the page, after every link displayed and to alter link data.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\nAll templates data, including links.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\naction_plugin\n: next to the button \"private only\" at the top and bottom of the page.\n\n\n\n\n\n\n\n\nlink_plugin\n: for every link, between permalink and link URL.\n\n\n\n\n\n\n\n\nplugin_start_zone\n: before displaying the template content.\n\n\n\n\n\n\n\n\nplugin_end_zone\n: after displaying the template content.\n\n\n\n\n\n\nrender_editlink\n\n\nTriggered when the link edition form is displayed.\n\n\nAllow to add fields in the form, or display elements.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\nAll templates data.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\nedit_link_plugin\n: after tags field.\n\n\n\n\n\n\nrender_tools\n\n\nTriggered when the \"tools\" page is displayed.\n\n\nAllow to add content at the end of the page.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\nAll templates data.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\ntools_plugin\n: at the end of the page.\n\n\n\n\n\n\nrender_picwall\n\n\nTriggered when picwall is displayed.\n\n\nAllow to add content at the top and bottom of the page.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\nAll templates data.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\n\n\nplugin_start_zone\n: before displaying the template content.\n\n\n\n\n\n\nplugin_end_zone\n: after displaying the template content.\n\n\n\n\n\n\n\n\nrender_tagcloud\n\n\nTriggered when tagcloud is displayed.\n\n\nAllow to add content at the top and bottom of the page.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\nAll templates data.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\n\n\nplugin_start_zone\n: before displaying the template content.\n\n\n\n\n\n\nplugin_end_zone\n: after displaying the template content.\n\n\n\n\n\n\nFor each tag, the following placeholder can be used:\n\n\n\n\ntag_plugin\n: after each tag\n\n\n\n\n\n\nrender_taglist\n\n\nTriggered when taglist is displayed.\n\n\nAllow to add content at the top and bottom of the page.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\nAll templates data.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\n\n\nplugin_start_zone\n: before displaying the template content.\n\n\n\n\n\n\nplugin_end_zone\n: after displaying the template content.\n\n\n\n\n\n\nFor each tag, the following placeholder can be used:\n\n\n\n\ntag_plugin\n: after each tag\n\n\n\n\nrender_daily\n\n\nTriggered when tagcloud is displayed.\n\n\nAllow to add content at the top and bottom of the page, the bottom of each link and to alter data.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\nAll templates data, including links.\n\n\n\n\nTemplate placeholders\n\n\nItems can be displayed in templates by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\nlink_plugin\n: used at bottom of each link.\n\n\n\n\n\n\n\n\n\n\nplugin_start_zone\n: before displaying the template content.\n\n\n\n\n\n\nplugin_end_zone\n: after displaying the template content.\n\n\n\n\n\n\nrender_feed\n\n\nTriggered when the ATOM or RSS feed is displayed.\n\n\nAllow to add tags in the feed, either in the header or for each items. Items (links) can also be altered before being rendered.\n\n\nData\n\n\n$data\n is an array containing:\n\n\n\n\n_LOGGEDIN_\n: true if user is logged in, false otherwise.\n\n\n_PAGE_\n: containing either \nrss\n or \natom\n.\n\n\nAll templates data, including links.\n\n\n\n\nTemplate placeholders\n\n\nTags can be added in feeds by adding an entry in \n$data['']\n array.\n\n\nList of placeholders:\n\n\n\n\nfeed_plugins_header\n: used as a header tag in the feed.\n\n\n\n\nFor each links:\n\n\n\n\nfeed_plugins\n: additional tag for every link entry.\n\n\n\n\nsave_link\n\n\nTriggered when a link is save (new link or edit).\n\n\nAllow to alter the link being saved in the datastore.\n\n\nData\n\n\n$data\n is an array containing the link being saved:\n\n\n\n\nid\n\n\ntitle\n\n\nurl\n\n\nshorturl\n\n\ndescription\n\n\nprivate\n\n\ntags\n\n\ncreated\n\n\nupdated\n\n\n\n\ndelete_link\n\n\nTriggered when a link is deleted.\n\n\nAllow to execute any action before the link is actually removed from the datastore\n\n\nData\n\n\n$data\n is an array containing the link being saved:\n\n\n\n\nid\n\n\ntitle\n\n\nurl\n\n\nshorturl\n\n\ndescription\n\n\nprivate\n\n\ntags\n\n\ncreated\n\n\nupdated\n\n\n\n\nGuide for template designer\n\n\nPlugin administration\n\n\nYour theme must include a plugin administration page: \npluginsadmin.html\n.\n\n\n\n\nNote: repo's template link needs to be added when the PR is merged.\n\n\n\n\nUse the default one as an example.\n\n\nAside from classic RainTPL loops, plugins order is handle by JavaScript. You can just include \nplugin_admin.js\n, only if:\n\n\n\n\nyou're using a table.\n\n\nyou call orderUp() and orderUp() onclick on arrows.\n\n\nyou add data-line and data-order to your rows.\n\n\n\n\nOtherwise, you can use your own JS as long as this field is send by the form:\n\n\n\n\nPlaceholder system\n\n\nIn order to make plugins work with every custom themes, you need to add variable placeholder in your templates. \n\n\nIt's a RainTPL loop like this:\n\n\n{loop=\"$plugin_variable\"}\n {$value}\n{/loop}\n\n\n\nYou should enable \ndemo_plugin\n for testing purpose, since it uses every placeholder available.\n\n\nList of placeholders\n\n\npage.header.html\n\n\nAt the end of the menu:\n\n\n{loop=\"$plugins_header.buttons_toolbar\"}\n {$value}\n{/loop}\n\n\n\nAt the end of file, before clearing floating blocks:\n\n\n{if=\"!empty($plugin_errors) && isLoggedIn()\"}\n
      \n {loop=\"plugin_errors\"}\n
    • {$value}
      • \n {/loop}\n
    \n{/if}\n\n\n\nincludes.html\n\n\nAt the end of the file:\n\n\n{loop=\"$plugins_includes.css_files\"}\n\n{/loop}\n\n\n\n\npage.footer.html\n\n\nAt the end of your footer notes:\n\n\n{loop=\"$plugins_footer.text\"}\n {$value}\n{/loop}\n\n\n\n\nAt the end of file:\n\n\n{loop=\"$plugins_footer.js_files\"}\n \n{/loop}\n\n\n\n\nlinklist.html\n\n\nAfter search fields:\n\n\n{loop=\"$plugins_header.fields_toolbar\"}\n {$value}\n{/loop}\n\n\n\n\nBefore displaying the link list (after paging):\n\n\n{loop=\"$plugin_start_zone\"}\n {$value}\n{/loop}\n\n\n\n\nFor every links (icons):\n\n\n{loop=\"$value.link_plugin\"}\n {$value}\n{/loop}\n\n\n\n\nBefore end paging:\n\n\n{loop=\"$plugin_end_zone\"}\n {$value}\n{/loop}\n\n\n\n\nlinklist.paging.html\n\n\nAfter the \"private only\" icon:\n\n\n{loop=\"$action_plugin\"}\n {$value}\n{/loop}\n\n\n\n\neditlink.html\n\n\nAfter tags field:\n\n\n{loop=\"$edit_link_plugin\"}\n {$value}\n{/loop}\n\n\n\n\ntools.html\n\n\nAfter the last tool:\n\n\n{loop=\"$tools_plugin\"}\n {$value}\n{/loop}\n\n\n\n\npicwall.html\n\n\nTop:\n\n\n
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\nBottom:\n\n\n
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\ntagcloud.html\n\n\nTop:\n\n\n
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\nBottom:\n\n\n
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\ndaily.html\n\n\nTop:\n\n\n
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\nAfter every link:\n\n\n
    \n {loop=\"$link.link_plugin\"}\n {$value}\n {/loop}\n
    \n\n\n\n\nBottom:\n\n\n
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    \n\n\n\n\nfeed.atom.xml\n and \nfeed.rss.xml\n:\n\n\nIn headers tags section:\n\n\n{loop=\"$feed_plugins_header\"}\n {$value}\n{/loop}\n\n\n\n\nAfter each entry:\n\n\n{loop=\"$value.feed_plugins\"}\n {$value}\n{/loop}", + "title": "Plugin System" + }, + { + "location": "/Plugin-System/#developer-api", + "text": "", + "title": "Developer API" + }, + { + "location": "/Plugin-System/#what-can-i-do-with-plugins", + "text": "The plugin system let you: insert content into specific places across templates. alter data before templates rendering. alter data before saving new links.", + "title": "What can I do with plugins?" + }, + { + "location": "/Plugin-System/#how-can-i-create-a-plugin-for-shaarli", + "text": "First, chose a plugin name, such as demo_plugin . Under plugin folder, create a folder named with your plugin name. Then create a .php file in that folder. You should have the following tree view: | index.php\n| plugins/\n|---| demo_plugin/\n| |---| demo_plugin.php", + "title": "How can I create a plugin for Shaarli?" + }, + { + "location": "/Plugin-System/#plugin-initialization", + "text": "At the beginning of Shaarli execution, all enabled plugins are loaded. At this point, the plugin system looks for an init() function to execute and run it if it exists. This function must be named this way, and takes the ConfigManager as parameter. _init($conf) This function can be used to create initial data, load default settings, etc. But also to set plugin errors . If the initialization function returns an array of strings, they will be understand as errors, and displayed in the header to logged in users.", + "title": "Plugin initialization" + }, + { + "location": "/Plugin-System/#understanding-hooks", + "text": "A plugin is a set of functions. Each function will be triggered by the plugin system at certain point in Shaarli execution. These functions need to be named with this pattern: hook__($data, $conf) Parameters: data: see $data section conf: the ConfigManager instance. For exemple, if my plugin want to add data to the header, this function is needed: hook_demo_plugin_render_header If this function is declared, and the plugin enabled, it will be called every time Shaarli is rendering the header.", + "title": "Understanding hooks" + }, + { + "location": "/Plugin-System/#plugins-data", + "text": "", + "title": "Plugin's data" + }, + { + "location": "/Plugin-System/#parameters", + "text": "Every hook function has a $data parameter. Its content differs for each hooks. This parameter needs to be returned every time , otherwise data is lost. return $data;", + "title": "Parameters" + }, + { + "location": "/Plugin-System/#filling-templates-placeholder", + "text": "Template placeholders are displayed in template in specific places. RainTPL displays every element contained in the placeholder's array. These element can be added by plugins. For example, let's add a value in the placeholder top_placeholder which is displayed at the top of my page: $data['top_placeholder'][] = 'My content';\n# OR\narray_push($data['top_placeholder'], 'My', 'content');\n\nreturn $data;", + "title": "Filling templates placeholder" + }, + { + "location": "/Plugin-System/#data-manipulation", + "text": "When a page is displayed, every variable send to the template engine is passed to plugins before that in $data . The data contained by this array can be altered before template rendering. For exemple, in linklist, it is possible to alter every title: // mind the reference if you want $data to be altered\nforeach ($data['links'] as &$value) {\n // String reverse every title.\n $value['title'] = strrev($value['title']);\n}\n\nreturn $data;", + "title": "Data manipulation" + }, + { + "location": "/Plugin-System/#metadata", + "text": "Every plugin needs a .meta file, which is in fact an .ini file ( KEY=\"VALUE\" ), to be listed in plugin administration. Each file contain two keys: description : plugin description parameters : user parameter names, separated by a ; . parameter. : add a text description the specified parameter. Note: In PHP, parse_ini_file() seems to want strings to be between by quotes \" in the ini file.", + "title": "Metadata" + }, + { + "location": "/Plugin-System/#its-not-working", + "text": "Use demo_plugin as a functional example. It covers most of the plugin system features. If it's still not working, please open an issue .", + "title": "It's not working!" + }, + { + "location": "/Plugin-System/#hooks", + "text": "Hooks Description render_header Allow plugin to add content in page headers. render_includes Allow plugin to include their own CSS files. render_footer Allow plugin to add content in page footer and include their own JS files. render_linklist It allows to add content at the begining and end of the page, after every link displayed and to alter link data. render_editlink Allow to add fields in the form, or display elements. render_tools Allow to add content at the end of the page. render_picwall Allow to add content at the top and bottom of the page. render_tagcloud Allow to add content at the top and bottom of the page, and after all tags. render_taglist Allow to add content at the top and bottom of the page, and after all tags. render_daily Allow to add content at the top and bottom of the page, the bottom of each link and to alter data. render_feed Allow to do add tags in RSS and ATOM feeds. save_link Allow to alter the link being saved in the datastore. delete_link Allow to do an action before a link is deleted from the datastore.", + "title": "Hooks" + }, + { + "location": "/Plugin-System/#render_header", + "text": "Triggered on every page. Allow plugin to add content in page headers.", + "title": "render_header" + }, + { + "location": "/Plugin-System/#data", + "text": "$data is an array containing: _PAGE_ : current target page (eg: linklist , picwall , etc.). _LOGGEDIN_ : true if user is logged in, false otherwise.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: buttons_toolbar : after the list of buttons in the header. fields_toolbar : after search fields in the header. Note: This will only be called in linklist.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_includes", + "text": "Triggered on every page. Allow plugin to include their own CSS files.", + "title": "render_includes" + }, + { + "location": "/Plugin-System/#data_1", + "text": "$data is an array containing: _PAGE_ : current target page (eg: linklist , picwall , etc.). _LOGGEDIN_ : true if user is logged in, false otherwise.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_1", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: css_files : called after loading default CSS. Note: only add the path of the CSS file. E.g: plugins/demo_plugin/custom_demo.css .", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_footer", + "text": "Triggered on every page. Allow plugin to add content in page footer and include their own JS files.", + "title": "render_footer" + }, + { + "location": "/Plugin-System/#data_2", + "text": "$data is an array containing: _PAGE_ : current target page (eg: linklist , picwall , etc.). _LOGGEDIN_ : true if user is logged in, false otherwise.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_2", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: text : called after the end of the footer text. endofpage : called at the end of the page. js_files : called at the end of the page, to include custom JS scripts. Note: only add the path of the JS file. E.g: plugins/demo_plugin/custom_demo.js .", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_linklist", + "text": "Triggered when linklist is displayed (list of links, permalink, search, tag filtered, etc.). It allows to add content at the begining and end of the page, after every link displayed and to alter link data.", + "title": "render_linklist" + }, + { + "location": "/Plugin-System/#data_3", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. All templates data, including links.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_3", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: action_plugin : next to the button \"private only\" at the top and bottom of the page. link_plugin : for every link, between permalink and link URL. plugin_start_zone : before displaying the template content. plugin_end_zone : after displaying the template content.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_editlink", + "text": "Triggered when the link edition form is displayed. Allow to add fields in the form, or display elements.", + "title": "render_editlink" + }, + { + "location": "/Plugin-System/#data_4", + "text": "$data is an array containing: All templates data.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_4", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: edit_link_plugin : after tags field.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_tools", + "text": "Triggered when the \"tools\" page is displayed. Allow to add content at the end of the page.", + "title": "render_tools" + }, + { + "location": "/Plugin-System/#data_5", + "text": "$data is an array containing: All templates data.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_5", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: tools_plugin : at the end of the page.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_picwall", + "text": "Triggered when picwall is displayed. Allow to add content at the top and bottom of the page.", + "title": "render_picwall" + }, + { + "location": "/Plugin-System/#data_6", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. All templates data.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_6", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: plugin_start_zone : before displaying the template content. plugin_end_zone : after displaying the template content.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_tagcloud", + "text": "Triggered when tagcloud is displayed. Allow to add content at the top and bottom of the page.", + "title": "render_tagcloud" + }, + { + "location": "/Plugin-System/#data_7", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. All templates data.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_7", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: plugin_start_zone : before displaying the template content. plugin_end_zone : after displaying the template content. For each tag, the following placeholder can be used: tag_plugin : after each tag", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_taglist", + "text": "Triggered when taglist is displayed. Allow to add content at the top and bottom of the page.", + "title": "render_taglist" + }, + { + "location": "/Plugin-System/#data_8", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. All templates data.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_8", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: plugin_start_zone : before displaying the template content. plugin_end_zone : after displaying the template content. For each tag, the following placeholder can be used: tag_plugin : after each tag", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_daily", + "text": "Triggered when tagcloud is displayed. Allow to add content at the top and bottom of the page, the bottom of each link and to alter data.", + "title": "render_daily" + }, + { + "location": "/Plugin-System/#data_9", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. All templates data, including links.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_9", + "text": "Items can be displayed in templates by adding an entry in $data[''] array. List of placeholders: link_plugin : used at bottom of each link. plugin_start_zone : before displaying the template content. plugin_end_zone : after displaying the template content.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#render_feed", + "text": "Triggered when the ATOM or RSS feed is displayed. Allow to add tags in the feed, either in the header or for each items. Items (links) can also be altered before being rendered.", + "title": "render_feed" + }, + { + "location": "/Plugin-System/#data_10", + "text": "$data is an array containing: _LOGGEDIN_ : true if user is logged in, false otherwise. _PAGE_ : containing either rss or atom . All templates data, including links.", + "title": "Data" + }, + { + "location": "/Plugin-System/#template-placeholders_10", + "text": "Tags can be added in feeds by adding an entry in $data[''] array. List of placeholders: feed_plugins_header : used as a header tag in the feed. For each links: feed_plugins : additional tag for every link entry.", + "title": "Template placeholders" + }, + { + "location": "/Plugin-System/#save_link", + "text": "Triggered when a link is save (new link or edit). Allow to alter the link being saved in the datastore.", + "title": "save_link" + }, + { + "location": "/Plugin-System/#data_11", + "text": "$data is an array containing the link being saved: id title url shorturl description private tags created updated", + "title": "Data" + }, + { + "location": "/Plugin-System/#delete_link", + "text": "Triggered when a link is deleted. Allow to execute any action before the link is actually removed from the datastore", + "title": "delete_link" + }, + { + "location": "/Plugin-System/#data_12", + "text": "$data is an array containing the link being saved: id title url shorturl description private tags created updated", + "title": "Data" + }, + { + "location": "/Plugin-System/#guide-for-template-designer", + "text": "", + "title": "Guide for template designer" + }, + { + "location": "/Plugin-System/#plugin-administration", + "text": "Your theme must include a plugin administration page: pluginsadmin.html . Note: repo's template link needs to be added when the PR is merged. Use the default one as an example. Aside from classic RainTPL loops, plugins order is handle by JavaScript. You can just include plugin_admin.js , only if: you're using a table. you call orderUp() and orderUp() onclick on arrows. you add data-line and data-order to your rows. Otherwise, you can use your own JS as long as this field is send by the form:", + "title": "Plugin administration" + }, + { + "location": "/Plugin-System/#placeholder-system", + "text": "In order to make plugins work with every custom themes, you need to add variable placeholder in your templates. It's a RainTPL loop like this: {loop=\"$plugin_variable\"}\n {$value}\n{/loop} You should enable demo_plugin for testing purpose, since it uses every placeholder available.", + "title": "Placeholder system" + }, + { + "location": "/Plugin-System/#list-of-placeholders", + "text": "page.header.html At the end of the menu: {loop=\"$plugins_header.buttons_toolbar\"}\n {$value}\n{/loop} At the end of file, before clearing floating blocks: {if=\"!empty($plugin_errors) && isLoggedIn()\"}\n
      \n {loop=\"plugin_errors\"}\n
    • {$value}
      • \n {/loop}\n
    \n{/if} includes.html At the end of the file: {loop=\"$plugins_includes.css_files\"}\n\n{/loop} page.footer.html At the end of your footer notes: {loop=\"$plugins_footer.text\"}\n {$value}\n{/loop} At the end of file: {loop=\"$plugins_footer.js_files\"}\n \n{/loop} linklist.html After search fields: {loop=\"$plugins_header.fields_toolbar\"}\n {$value}\n{/loop} Before displaying the link list (after paging): {loop=\"$plugin_start_zone\"}\n {$value}\n{/loop} For every links (icons): {loop=\"$value.link_plugin\"}\n {$value}\n{/loop} Before end paging: {loop=\"$plugin_end_zone\"}\n {$value}\n{/loop} linklist.paging.html After the \"private only\" icon: {loop=\"$action_plugin\"}\n {$value}\n{/loop} editlink.html After tags field: {loop=\"$edit_link_plugin\"}\n {$value}\n{/loop} tools.html After the last tool: {loop=\"$tools_plugin\"}\n {$value}\n{/loop} picwall.html Top:
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    Bottom:
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    tagcloud.html Top:
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    Bottom:
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    daily.html Top:
    \n {loop=\"$plugin_start_zone\"}\n {$value}\n {/loop}\n
    After every link:
    \n {loop=\"$link.link_plugin\"}\n {$value}\n {/loop}\n
    Bottom:
    \n {loop=\"$plugin_end_zone\"}\n {$value}\n {/loop}\n
    feed.atom.xml and feed.rss.xml : In headers tags section: {loop=\"$feed_plugins_header\"}\n {$value}\n{/loop} After each entry: {loop=\"$value.feed_plugins\"}\n {$value}\n{/loop}", + "title": "List of placeholders" + }, + { + "location": "/Release-Shaarli/", + "text": "See \nGit - Maintaining a project - Tagging your \nreleases\n.\n\n\nPrerequisites\n\n\nThis guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your \n~/.gitconfig\n \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - \norigin\n pointing to your GitHub fork\n - \nupstream\n pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- \nComposer\n and \nPandoc\n need to be installed\n\n\nGitHub release draft and \nCHANGELOG.md\n\n\nSee http://keepachangelog.com/en/0.3.0/ for changelog formatting.\n\n\nGitHub release draft\n\n\nGitHub allows drafting the release note for the upcoming release, from the \nReleases\n page. This way, the release note can be drafted while contributions are merged to \nmaster\n.\n\n\nCHANGELOG.md\n\n\nThis file should contain the same information as the release note draft for the upcoming version.\n\n\nUpdate it to:\n- add new entries (additions, fixes, etc.)\n- mark the current version as released by setting its date and link\n- add a new section for the future unreleased version\n\n\n$ cd /path/to/shaarli\n\n$ nano CHANGELOG.md\n\n[...]\n## vA.B.C - UNRELEASED\nTBA\n\n## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD\n[...]\n\n\n\n\nIncrement the version code, updated docs, create and push a signed tag\n\n\nGenerate documentation\n\n\n$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the documentation from the wiki\n$ make htmldoc\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0\n\n\n\n\nCreate and merge a Pull Request\n\n\nThis one is pretty straightforward ;-)\n\n\nBump Shaarli version to v0.x branch\n\n\n$ git checkout master\n$ git fetch upstream\n$ git pull upstream master\n\n# IF the branch doesn't exists\n$ git checkout -b v0.5\n# OR if the branch already exists\n$ git checkout v0.5\n$ git rebase upstream/master\n\n# Bump shaarli version from dev to 0.5.0, **without the `v`**\n$ vim shaarli_version.php\n$ git add shaarli_version\n$ git commit -s -m \"Bump Shaarli version to v0.5.0\"\n$ git push upstream v0.5\n\n\n\n\nCreate and push a signed tag\n\n\n# update your local copy\n$ git checkout v0.5\n$ git fetch upstream\n$ git pull upstream v0.5\n\n# create a signed tag\n$ git tag -s -m \"Release v0.5.0\" v0.5.0\n\n# push it to \"upstream\"\n$ git push --tags upstream\n\n\n\n\nVerify a signed tag\n\n\nv0.5.0\n is the first GPG-signed tag pushed on the Community Shaarli.\n\n\nLet's have a look at its signature!\n\n\n$ cd /path/to/shaarli\n$ git fetch upstream\n\n# get the SHA1 reference of the tag\n$ git show-ref tags/v0.5.0\nf7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0\n\n# verify the tag signature information\n$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1\ngpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F\ngpg: Good signature from \"VirtualTam \" [ultimate]\n\n\n\n\nPublish the GitHub release\n\n\nUpdate release badges\n\n\nUpdate \nREADME.md\n so version badges display and point to the newly released Shaarli version(s), in the \nmaster\n branch.\n\n\nCreate a GitHub release from a Git tag\n\n\nFrom the previously drafted release:\n- edit the release notes (if needed)\n- specify the appropriate Git tag\n- publish the release\n- profit!\n\n\nGenerate and upload all-in-one release archives\n\n\nUsers with a shared hosting may have:\n- no SSH access\n- no possibility to install PHP packages or server extensions\n- no possibility to run scripts\n\n\nTo ease Shaarli installations, it is possible to generate and upload additional release archives,\nthat will contain Shaarli code plus all required third-party libraries.\n\n\nFrom the \nv0.5\n branch:\n\n\n$ make release_archive\n\n\n\n\nThis will create the following archives:\n- \nshaarli-vX.Y.Z-full.tar\n\n- \nshaarli-vX.Y.Z-full.zip\n\n\nThe archives need to be manually uploaded on the previously created GitHub release.\n\n\nUpdate \nstable\n and \nlatest\n branches\n\n\n$ git checkout latest\n# latest release\n$ git merge v0.5.0\n# fix eventual conflicts\n$ make test\n$ git push upstream latest\n$ git checkout stable\n# latest previous major\n$ git merge v0.4.5 \n# fix eventual conflicts\n$ make test\n$ git push upstream stable", + "title": "Release Shaarli" + }, + { + "location": "/Release-Shaarli/#prerequisites", + "text": "This guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your ~/.gitconfig \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - origin pointing to your GitHub fork\n - upstream pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- Composer and Pandoc need to be installed", + "title": "Prerequisites" + }, + { + "location": "/Release-Shaarli/#github-release-draft-and-changelogmd", + "text": "See http://keepachangelog.com/en/0.3.0/ for changelog formatting.", + "title": "GitHub release draft and CHANGELOG.md" + }, + { + "location": "/Release-Shaarli/#github-release-draft", + "text": "GitHub allows drafting the release note for the upcoming release, from the Releases page. This way, the release note can be drafted while contributions are merged to master .", + "title": "GitHub release draft" + }, + { + "location": "/Release-Shaarli/#changelogmd", + "text": "This file should contain the same information as the release note draft for the upcoming version. Update it to:\n- add new entries (additions, fixes, etc.)\n- mark the current version as released by setting its date and link\n- add a new section for the future unreleased version $ cd /path/to/shaarli\n\n$ nano CHANGELOG.md\n\n[...]\n## vA.B.C - UNRELEASED\nTBA\n\n## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD\n[...]", + "title": "CHANGELOG.md" + }, + { + "location": "/Release-Shaarli/#increment-the-version-code-updated-docs-create-and-push-a-signed-tag", + "text": "", + "title": "Increment the version code, updated docs, create and push a signed tag" + }, + { + "location": "/Release-Shaarli/#generate-documentation", + "text": "$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the documentation from the wiki\n$ make htmldoc\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0", + "title": "Generate documentation" + }, + { + "location": "/Release-Shaarli/#create-and-merge-a-pull-request", + "text": "This one is pretty straightforward ;-)", + "title": "Create and merge a Pull Request" + }, + { + "location": "/Release-Shaarli/#bump-shaarli-version-to-v0x-branch", + "text": "$ git checkout master\n$ git fetch upstream\n$ git pull upstream master\n\n# IF the branch doesn't exists\n$ git checkout -b v0.5\n# OR if the branch already exists\n$ git checkout v0.5\n$ git rebase upstream/master\n\n# Bump shaarli version from dev to 0.5.0, **without the `v`**\n$ vim shaarli_version.php\n$ git add shaarli_version\n$ git commit -s -m \"Bump Shaarli version to v0.5.0\"\n$ git push upstream v0.5", + "title": "Bump Shaarli version to v0.x branch" + }, + { + "location": "/Release-Shaarli/#create-and-push-a-signed-tag", + "text": "# update your local copy\n$ git checkout v0.5\n$ git fetch upstream\n$ git pull upstream v0.5\n\n# create a signed tag\n$ git tag -s -m \"Release v0.5.0\" v0.5.0\n\n# push it to \"upstream\"\n$ git push --tags upstream", + "title": "Create and push a signed tag" + }, + { + "location": "/Release-Shaarli/#verify-a-signed-tag", + "text": "v0.5.0 is the first GPG-signed tag pushed on the Community Shaarli. Let's have a look at its signature! $ cd /path/to/shaarli\n$ git fetch upstream\n\n# get the SHA1 reference of the tag\n$ git show-ref tags/v0.5.0\nf7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0\n\n# verify the tag signature information\n$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1\ngpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F\ngpg: Good signature from \"VirtualTam \" [ultimate]", + "title": "Verify a signed tag" + }, + { + "location": "/Release-Shaarli/#publish-the-github-release", + "text": "", + "title": "Publish the GitHub release" + }, + { + "location": "/Release-Shaarli/#update-release-badges", + "text": "Update README.md so version badges display and point to the newly released Shaarli version(s), in the master branch.", + "title": "Update release badges" + }, + { + "location": "/Release-Shaarli/#create-a-github-release-from-a-git-tag", + "text": "From the previously drafted release:\n- edit the release notes (if needed)\n- specify the appropriate Git tag\n- publish the release\n- profit!", + "title": "Create a GitHub release from a Git tag" + }, + { + "location": "/Release-Shaarli/#generate-and-upload-all-in-one-release-archives", + "text": "Users with a shared hosting may have:\n- no SSH access\n- no possibility to install PHP packages or server extensions\n- no possibility to run scripts To ease Shaarli installations, it is possible to generate and upload additional release archives,\nthat will contain Shaarli code plus all required third-party libraries. From the v0.5 branch: $ make release_archive This will create the following archives:\n- shaarli-vX.Y.Z-full.tar \n- shaarli-vX.Y.Z-full.zip The archives need to be manually uploaded on the previously created GitHub release.", + "title": "Generate and upload all-in-one release archives" + }, + { + "location": "/Release-Shaarli/#update-stable-and-latest-branches", + "text": "$ git checkout latest\n# latest release\n$ git merge v0.5.0\n# fix eventual conflicts\n$ make test\n$ git push upstream latest\n$ git checkout stable\n# latest previous major\n$ git merge v0.4.5 \n# fix eventual conflicts\n$ make test\n$ git push upstream stable", + "title": "Update stable and latest branches" + }, + { + "location": "/Versioning-and-Branches/", + "text": "WORK IN PROGRESS\n\n\nIt's important to understand how Shaarli branches work, especially if you're maintaining a 3rd party tools for Shaarli (theme, plugin, etc.), to be sure stay compatible.\n\n\nmaster\n branch\n\n\nThe \nmaster\n branch is the development branch. Any new change MUST go through this branch using Pull Requests.\n\n\nRemarks:\n\n\n\n\nThis branch shouldn't be used for production as it isn't necessary stable.\n\n\n3rd party aren't required to be compatible with the latest changes.\n\n\nOfficial plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch.\n\n\nThe version in this branch is always \ndev\n.\n\n\n\n\nv0.x\n branch\n\n\nThis \nv0.x\n branch, points to the latest \nv0.x.y\n release.\n\n\nExplanation:\n\n\nWhen a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli.\n\n\nIn this case, the issue is fixed in the \nmaster\n branch, and the fix is backported the to the \nv0.x\n branch. Then a new release is made from the \nv0.x\n branch.\n\n\nThis workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon.\n\n\nlatest\n branch\n\n\nThis branch point the latest release. It recommended to use it to get the latest tested changes.\n\n\nstable\n branch\n\n\nThe \nstable\n branch doesn't contain any major bug, and is one major digit version behind the latest release.\n\n\nFor example, the current latest release is \nv0.8.3\n, the stable branch is an alias to the latest \nv0.7.x\n release. When the \nv0.9.0\n version will be released, the stable will move to the latest \nv0.8.x\n release.\n\n\nRemarks:\n\n\n\n\nShaarli release pace isn't fast, and the stable branch might be a few months behind the latest release.\n\n\n\n\nReleases\n\n\nReleases are always made from the latest \nv0.x\n branch.\n\n\nNote that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step.\n\n\nAdvices on 3rd party git repos workflow\n\n\nVersioning\n\n\nAny time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the \nchangelog\n (\nDraft\n means not released yet) and the commit log (like \ntpl\n folder\n for themes)). You can either:\n\n\n\n\nuse the Shaarli version number, with your repo version. For example, if Shaarli \nv0.8.3\n is released, publish a \nv0.8.3-1\n release, where \nv0.8.3\n states Shaarli compatibility and \n-1\n is your own version digit for the current Shaarli version.\n\n\nuse your own versioning scheme, and state Shaarli compatibility in the release description.\n\n\n\n\nUsing this, any user will be able to pick the release matching his own Shaarli version.\n\n\nMajor bugfix backport releases\n\n\nTo be able to support backported fixes, it recommended to use our workflow:\n\n\n# In master, fix the major bug\ngit commit -m \"Katastrophe\"\ngit push origin master\n# Get your commit hash\ngit log --format=\"%H\" -n 1\n# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name)\ngit checkout -b katastrophe v0.8.2-1\n# Backport the fix commit to your brand new branch\ngit cherry-pick \ngit push origin katastrophe\n# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1`", + "title": "Versioning and Branches" + }, + { + "location": "/Versioning-and-Branches/#master-branch", + "text": "The master branch is the development branch. Any new change MUST go through this branch using Pull Requests. Remarks: This branch shouldn't be used for production as it isn't necessary stable. 3rd party aren't required to be compatible with the latest changes. Official plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch. The version in this branch is always dev .", + "title": "master branch" + }, + { + "location": "/Versioning-and-Branches/#v0x-branch", + "text": "This v0.x branch, points to the latest v0.x.y release. Explanation: When a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli. In this case, the issue is fixed in the master branch, and the fix is backported the to the v0.x branch. Then a new release is made from the v0.x branch. This workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon.", + "title": "v0.x branch" + }, + { + "location": "/Versioning-and-Branches/#latest-branch", + "text": "This branch point the latest release. It recommended to use it to get the latest tested changes.", + "title": "latest branch" + }, + { + "location": "/Versioning-and-Branches/#stable-branch", + "text": "The stable branch doesn't contain any major bug, and is one major digit version behind the latest release. For example, the current latest release is v0.8.3 , the stable branch is an alias to the latest v0.7.x release. When the v0.9.0 version will be released, the stable will move to the latest v0.8.x release. Remarks: Shaarli release pace isn't fast, and the stable branch might be a few months behind the latest release.", + "title": "stable branch" + }, + { + "location": "/Versioning-and-Branches/#releases", + "text": "Releases are always made from the latest v0.x branch. Note that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step.", + "title": "Releases" + }, + { + "location": "/Versioning-and-Branches/#advices-on-3rd-party-git-repos-workflow", + "text": "", + "title": "Advices on 3rd party git repos workflow" + }, + { + "location": "/Versioning-and-Branches/#versioning", + "text": "Any time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the changelog ( Draft means not released yet) and the commit log (like tpl folder for themes)). You can either: use the Shaarli version number, with your repo version. For example, if Shaarli v0.8.3 is released, publish a v0.8.3-1 release, where v0.8.3 states Shaarli compatibility and -1 is your own version digit for the current Shaarli version. use your own versioning scheme, and state Shaarli compatibility in the release description. Using this, any user will be able to pick the release matching his own Shaarli version.", + "title": "Versioning" + }, + { + "location": "/Versioning-and-Branches/#major-bugfix-backport-releases", + "text": "To be able to support backported fixes, it recommended to use our workflow: # In master, fix the major bug\ngit commit -m \"Katastrophe\"\ngit push origin master\n# Get your commit hash\ngit log --format=\"%H\" -n 1\n# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name)\ngit checkout -b katastrophe v0.8.2-1\n# Backport the fix commit to your brand new branch\ngit cherry-pick \ngit push origin katastrophe\n# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1`", + "title": "Major bugfix backport releases" + }, + { + "location": "/Security/", + "text": "Client browser\n\n\n\n\nShaarli relies on \nHTTP_REFERER\n for some functions (like redirects and clicking on tags). If you have disabled or masqueraded \nHTTP_REFERER\n in your browser, some features of Shaarli may not work\n\n\n\n\nPHP\n\n\n\n\nmagic_quotes\n is an horrible option of PHP which is often activated on servers. No serious developer should rely on this horror to secure their code against SQL injections. You should disable it (and Shaarli expects this option to be disabled). Nevertheless, I have added code to cope with \nmagic_quotes\n on, so you should not be bothered even on crappy hosts.\n\n\n\n\nServer and sessions\n\n\n\n\nDirectories are protected using \n.htaccess\n files\n\n\nForms are protected against XSRF (Cross-site requests forgery):\n\n\nForms which act on data (save,delete\u2026) contain a token generated by the server.\n\n\nAny posted form which does not contain a valid token is rejected.\n\n\nAny token can only be used once.\n\n\nTokens are attached to the session and cannot be reused in another session.\n\n\nSessions automatically expire after 60 minutes.\n\n\nSessions are protected against hijacking: the session ID cannot be used from a different IP address.\n\n\n\n\nShaarli datastore and configuration\n\n\n\n\nThe password is salted, hashed and stored in the data subdirectory, in a PHP file, and protected by htaccess. Even if the webserver does not support htaccess, the hash is not readable by URL. Even if the .php file is stolen, the password cannot deduced from the hash. The salt prevents rainbow-tables attacks.\n\n\nLinks are stored as an associative array which is serialized, compressed (with deflate), base64-encoded and saved as a comment in a \n.php\n file.\n\n\nEven if the server does not support \n.htaccess\n files, the data file will still not be readable by URL.\n\n\nThe database looks like this:\n\n\n\n\n\n\n\n\n\n\n\nSmall hashes are used to make a link to an entry in Shaarli. They are unique. In fact, the date of the items (eg. \n20110923_150523\n) is hashed with CRC32, then converted to base64 and some characters are replaced. They are always 6 characters longs and use only \nA-Z a-z 0-9 - _\n and \n@\n.", + "title": "Security" + }, + { + "location": "/Security/#client-browser", + "text": "Shaarli relies on HTTP_REFERER for some functions (like redirects and clicking on tags). If you have disabled or masqueraded HTTP_REFERER in your browser, some features of Shaarli may not work", + "title": "Client browser" + }, + { + "location": "/Security/#php", + "text": "magic_quotes is an horrible option of PHP which is often activated on servers. No serious developer should rely on this horror to secure their code against SQL injections. You should disable it (and Shaarli expects this option to be disabled). Nevertheless, I have added code to cope with magic_quotes on, so you should not be bothered even on crappy hosts.", + "title": "PHP" + }, + { + "location": "/Security/#server-and-sessions", + "text": "Directories are protected using .htaccess files Forms are protected against XSRF (Cross-site requests forgery): Forms which act on data (save,delete\u2026) contain a token generated by the server. Any posted form which does not contain a valid token is rejected. Any token can only be used once. Tokens are attached to the session and cannot be reused in another session. Sessions automatically expire after 60 minutes. Sessions are protected against hijacking: the session ID cannot be used from a different IP address.", + "title": "Server and sessions" + }, + { + "location": "/Security/#shaarli-datastore-and-configuration", + "text": "The password is salted, hashed and stored in the data subdirectory, in a PHP file, and protected by htaccess. Even if the webserver does not support htaccess, the hash is not readable by URL. Even if the .php file is stolen, the password cannot deduced from the hash. The salt prevents rainbow-tables attacks. Links are stored as an associative array which is serialized, compressed (with deflate), base64-encoded and saved as a comment in a .php file. Even if the server does not support .htaccess files, the data file will still not be readable by URL. The database looks like this: Small hashes are used to make a link to an entry in Shaarli. They are unique. In fact, the date of the items (eg. 20110923_150523 ) is hashed with CRC32, then converted to base64 and some characters are replaced. They are always 6 characters longs and use only A-Z a-z 0-9 - _ and @ .", + "title": "Shaarli datastore and configuration" + }, + { + "location": "/Static-analysis/", + "text": "WIP\n\n\nThis topic is currently being discussed here:\n- \nFix coding style (static analysis)\n (#95)\n- \nContinuous Integration tools & features\n (#130)\n\n\nUsage\n\n\nStatic analysis tools can be installed with Composer, and used through Shaarli's \nMakefile\n.\n\n\nFor an overview of the available features, see:\n- \nCode quality: Makefile to run static code checkers\n (#124)\n- \nRun PHPCS against different coding standards\n (#276)", + "title": "Static analysis" + }, + { + "location": "/Static-analysis/#wip", + "text": "This topic is currently being discussed here:\n- Fix coding style (static analysis) (#95)\n- Continuous Integration tools & features (#130)", + "title": "WIP" + }, + { + "location": "/Static-analysis/#usage", + "text": "Static analysis tools can be installed with Composer, and used through Shaarli's Makefile . For an overview of the available features, see:\n- Code quality: Makefile to run static code checkers (#124)\n- Run PHPCS against different coding standards (#276)", + "title": "Usage" + }, + { + "location": "/Theming/", + "text": "Foreword\n\n\nThere are two ways of customizing how Shaarli looks:\n\n\n\n\nby using a custom CSS to override Shaarli's CSS\n\n\nby using a full theme that provides its own RainTPL templates, CSS and Javascript resources\n\n\n\n\nCustom CSS\n\n\nShaarli's appearance can be modified by adding CSS rules to:\n- Shaarli < \nv0.9.0\n: \ninc/user.css\n\n- Shaarli >= \nv0.9.0\n: \ndata/user.css\n\n\nThis file allows overriding rules defined in the template CSS files (only add changed rules), or define a whole new theme.\n\n\nNote\n: Do not edit \ntpl/default/css/shaarli.css\n! Your changes would be overridden when updating Shaarli.\n\n\nSee also \nDownload CSS styles from an OPML list\n\n\nThemes\n\n\nWARNING - This feature is currently being worked on and will be improved in the next releases. Experimental.\n\n\nInstallation:\n- find a theme you'd like to install\n- copy or clone the theme folder under \ntpl/\n\n- enable the theme:\n - Shaarli < \nv0.9.0\n: edit \ndata/config.json.php\n and set the value of \nraintpl_tpl\n to the new theme name:\n \n\"raintpl_tpl\": \"tpl\\/my-template\\/\"\n\n - Shaarli >= \nv0.9.0\n: select the theme through the \nTools\n page\n\n\nCommunity CSS & themes\n\n\nCustom CSS\n\n\n\n\nmrjovanovic/serious-theme-shaarli\n - A serious theme for Shaarli\n\n\nshaarli/shaarli-themes\n\n\n\n\nThemes\n\n\n\n\nAkibaTech/Shaarli Superhero Theme\n - A template/theme for Shaarli\n\n\nalexisju/albinomouse-template\n - A full template for Shaarli\n\n\nArthurHoaro/shaarli-launch\n - Customizable Shaarli theme\n\n\ndhoko/ShaarliTemplate\n - A template/theme for Shaarli\n\n\nkalvn/shaarli-blocks\n - A template/theme for Shaarli\n\n\nkalvn/Shaarli-Material\n - A theme (template) based on Google's Material Design for Shaarli, the superfast delicious clone\n\n\nManufacturaInd/shaarli-2004licious-theme\n - A template/theme as a humble homage to the early looks of the del.icio.us site\n\n\n\n\nShaarli forks\n\n\n\n\nmisterair/Limonade\n - A fork of (legacy) Shaarli with a new template\n\n\nvivienhaese/shaarlitheme\n - A Shaarli fork meant to be run in an openshift instance\n\n\n\n\nExample installation: AlbinoMouse theme\n\n\nWith the following configuration:\n- Apache 2 / PHP 5.6\n- user sites are enabled, e.g. \n/home/user/public_html/somedir\n is served as \nhttp://localhost/~user/somedir\n\n- \nhttp\n is the name of the Apache user\n\n\n$ cd ~/public_html\n\n# clone repositories\n$ git clone https://github.com/shaarli/Shaarli.git shaarli\n$ pushd shaarli/tpl\n$ git clone https://github.com/alexisju/albinomouse-template.git\n$ popd\n\n# set access rights for Apache\n$ chgrp -R http shaarli\n$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp\n\n\n\n\nGet config written:\n- go to the freshly installed site\n- fill the install form\n- log in to Shaarli\n\n\nEdit Shaarli's \nconfiguration|Shaarli configuration\n:\n\n\n# the file should be owned by Apache, thus not writeable => sudo\n$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php", + "title": "Theming" + }, + { + "location": "/Theming/#foreword", + "text": "There are two ways of customizing how Shaarli looks: by using a custom CSS to override Shaarli's CSS by using a full theme that provides its own RainTPL templates, CSS and Javascript resources", + "title": "Foreword" + }, + { + "location": "/Theming/#custom-css", + "text": "Shaarli's appearance can be modified by adding CSS rules to:\n- Shaarli < v0.9.0 : inc/user.css \n- Shaarli >= v0.9.0 : data/user.css This file allows overriding rules defined in the template CSS files (only add changed rules), or define a whole new theme. Note : Do not edit tpl/default/css/shaarli.css ! Your changes would be overridden when updating Shaarli. See also Download CSS styles from an OPML list", + "title": "Custom CSS" + }, + { + "location": "/Theming/#themes", + "text": "WARNING - This feature is currently being worked on and will be improved in the next releases. Experimental. Installation:\n- find a theme you'd like to install\n- copy or clone the theme folder under tpl/ \n- enable the theme:\n - Shaarli < v0.9.0 : edit data/config.json.php and set the value of raintpl_tpl to the new theme name:\n \"raintpl_tpl\": \"tpl\\/my-template\\/\" \n - Shaarli >= v0.9.0 : select the theme through the Tools page", + "title": "Themes" + }, + { + "location": "/Theming/#community-css-themes", + "text": "", + "title": "Community CSS & themes" + }, + { + "location": "/Theming/#custom-css_1", + "text": "mrjovanovic/serious-theme-shaarli - A serious theme for Shaarli shaarli/shaarli-themes", + "title": "Custom CSS" + }, + { + "location": "/Theming/#themes_1", + "text": "AkibaTech/Shaarli Superhero Theme - A template/theme for Shaarli alexisju/albinomouse-template - A full template for Shaarli ArthurHoaro/shaarli-launch - Customizable Shaarli theme dhoko/ShaarliTemplate - A template/theme for Shaarli kalvn/shaarli-blocks - A template/theme for Shaarli kalvn/Shaarli-Material - A theme (template) based on Google's Material Design for Shaarli, the superfast delicious clone ManufacturaInd/shaarli-2004licious-theme - A template/theme as a humble homage to the early looks of the del.icio.us site", + "title": "Themes" + }, + { + "location": "/Theming/#shaarli-forks", + "text": "misterair/Limonade - A fork of (legacy) Shaarli with a new template vivienhaese/shaarlitheme - A Shaarli fork meant to be run in an openshift instance", + "title": "Shaarli forks" + }, + { + "location": "/Theming/#example-installation-albinomouse-theme", + "text": "With the following configuration:\n- Apache 2 / PHP 5.6\n- user sites are enabled, e.g. /home/user/public_html/somedir is served as http://localhost/~user/somedir \n- http is the name of the Apache user $ cd ~/public_html\n\n# clone repositories\n$ git clone https://github.com/shaarli/Shaarli.git shaarli\n$ pushd shaarli/tpl\n$ git clone https://github.com/alexisju/albinomouse-template.git\n$ popd\n\n# set access rights for Apache\n$ chgrp -R http shaarli\n$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp Get config written:\n- go to the freshly installed site\n- fill the install form\n- log in to Shaarli Edit Shaarli's configuration|Shaarli configuration : # the file should be owned by Apache, thus not writeable => sudo\n$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php", + "title": "Example installation: AlbinoMouse theme" + }, + { + "location": "/Unit-tests/", + "text": "Setup your environment for tests\n\n\nThe framework used is \nPHPUnit\n; it can be installed with \nComposer\n, which is a dependency management tool.\n\n\nRegarding Composer, you can either use:\n\n a system-wide version, e.g. installed through your distro's package manager\n\n a local version, downloadable \nhere\n\n\nSample usage\n\n\n# system-wide version\n$ composer install\n$ composer update\n\n# local version\n$ php composer.phar self-update\n$ php composer.phar install\n$ php composer.phar update\n\n\n\n\nInstall Shaarli dev dependencies\n\n\n$ cd /path/to/shaarli\n$ composer update\n\n\n\n\nInstall and enable Xdebug to generate PHPUnit coverage reports\n\n\nFor Debian-based distros:\n\n\n$ aptitude install php5-xdebug\n\n\n\n\nFor ArchLinux:\n\n\n$ pacman -S xdebug\n\n\n\n\nThen add the following line to \n/etc/php/php.ini\n:\n\n\nzend_extension=xdebug.so\n\n\n\n\nRun unit tests\n\n\nSuccessful test suite:\n\n\n$ make test\n\n-------\nPHPUNIT\n-------\nPHPUnit 4.6.9 by Sebastian Bergmann and contributors.\n\nConfiguration read from /home/virtualtam/public_html/shaarli/phpunit.xml\n\n....................................\n\nTime: 759 ms, Memory: 8.25Mb\n\nOK (36 tests, 65 assertions)\n\n\n\n\nTest suite with failures and errors:\n\n\n$ make test\n-------\nPHPUNIT\n-------\nPHPUnit 4.6.9 by Sebastian Bergmann and contributors.\n\nConfiguration read from /home/virtualtam/public_html/shaarli/phpunit.xml\n\nE..FF...............................\n\nTime: 802 ms, Memory: 8.25Mb\n\nThere was 1 error:\n\n1) LinkDBTest::testConstructLoggedIn\nMissing argument 2 for LinkDB::__construct(), called in /home/virtualtam/public_html/shaarli/tests/Link\\\nDBTest.php on line 79 and defined\n\n/home/virtualtam/public_html/shaarli/application/LinkDB.php:58\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:79\n\n--\n\nThere were 2 failures:\n\n1) LinkDBTest::testCheckDBNew\nFailed asserting that two strings are equal.\n--- Expected\n+++ Actual\n@@ @@\n-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'\n+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'\n\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:121\n\n2) LinkDBTest::testCheckDBLoad\nFailed asserting that two strings are equal.\n--- Expected\n+++ Actual\n@@ @@\n-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'\n+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'\n\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:133\n\nFAILURES!\nTests: 36, Assertions: 63, Errors: 1, Failures: 2.\n\n\n\n\nTest results and coverage\n\n\nBy default, PHPUnit will run all suitable tests found under the \ntests\n directory.\n\n\nEach test has 3 possible outcomes:\n\n \n.\n - success\n\n \nF\n - failure: the test was run but its results are invalid\n * the code does not behave as expected\n * dependencies to external elements: globals, session, cache...\n* \nE\n - error: something went wrong and the tested code has crashed\n * typos in the code, or in the test code\n * dependencies to missing external elements\n\n\nIf Xdebug has been installed and activated, two coverage reports will be generated:\n\n a summary in the console\n\n a detailed HTML report with metrics for tested code\n * to open it in a web browser: \nfirefox coverage/index.html &\n\n\nExecuting specific tests\n\n\nAdd a \n@group\n annotation in a test class or method comment:\n\n\n/**\n * Netscape bookmark import\n * @group WIP\n */\nclass BookmarkImportTest extends PHPUnit_Framework_TestCase\n{\n [...]\n}\n\n\n\n\nTo run all tests annotated with \n@group WIP\n:\n\n\n$ vendor/bin/phpunit --group WIP tests/", + "title": "Unit tests" + }, + { + "location": "/Unit-tests/#setup-your-environment-for-tests", + "text": "The framework used is PHPUnit ; it can be installed with Composer , which is a dependency management tool. Regarding Composer, you can either use: a system-wide version, e.g. installed through your distro's package manager a local version, downloadable here", + "title": "Setup your environment for tests" + }, + { + "location": "/Unit-tests/#sample-usage", + "text": "# system-wide version\n$ composer install\n$ composer update\n\n# local version\n$ php composer.phar self-update\n$ php composer.phar install\n$ php composer.phar update", + "title": "Sample usage" + }, + { + "location": "/Unit-tests/#install-shaarli-dev-dependencies", + "text": "$ cd /path/to/shaarli\n$ composer update", + "title": "Install Shaarli dev dependencies" + }, + { + "location": "/Unit-tests/#install-and-enable-xdebug-to-generate-phpunit-coverage-reports", + "text": "For Debian-based distros: $ aptitude install php5-xdebug For ArchLinux: $ pacman -S xdebug Then add the following line to /etc/php/php.ini : zend_extension=xdebug.so", + "title": "Install and enable Xdebug to generate PHPUnit coverage reports" + }, + { + "location": "/Unit-tests/#run-unit-tests", + "text": "Successful test suite: $ make test\n\n-------\nPHPUNIT\n-------\nPHPUnit 4.6.9 by Sebastian Bergmann and contributors.\n\nConfiguration read from /home/virtualtam/public_html/shaarli/phpunit.xml\n\n....................................\n\nTime: 759 ms, Memory: 8.25Mb\n\nOK (36 tests, 65 assertions) Test suite with failures and errors: $ make test\n-------\nPHPUNIT\n-------\nPHPUnit 4.6.9 by Sebastian Bergmann and contributors.\n\nConfiguration read from /home/virtualtam/public_html/shaarli/phpunit.xml\n\nE..FF...............................\n\nTime: 802 ms, Memory: 8.25Mb\n\nThere was 1 error:\n\n1) LinkDBTest::testConstructLoggedIn\nMissing argument 2 for LinkDB::__construct(), called in /home/virtualtam/public_html/shaarli/tests/Link\\\nDBTest.php on line 79 and defined\n\n/home/virtualtam/public_html/shaarli/application/LinkDB.php:58\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:79\n\n--\n\nThere were 2 failures:\n\n1) LinkDBTest::testCheckDBNew\nFailed asserting that two strings are equal.\n--- Expected\n+++ Actual\n@@ @@\n-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'\n+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'\n\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:121\n\n2) LinkDBTest::testCheckDBLoad\nFailed asserting that two strings are equal.\n--- Expected\n+++ Actual\n@@ @@\n-'e3edea8ea7bb50be4bcb404df53fbb4546a7156e'\n+'85eab0c610d4f68025f6ed6e6b6b5fabd4b55834'\n\n/home/virtualtam/public_html/shaarli/tests/LinkDBTest.php:133\n\nFAILURES!\nTests: 36, Assertions: 63, Errors: 1, Failures: 2.", + "title": "Run unit tests" + }, + { + "location": "/Unit-tests/#test-results-and-coverage", + "text": "By default, PHPUnit will run all suitable tests found under the tests directory. Each test has 3 possible outcomes: . - success F - failure: the test was run but its results are invalid\n * the code does not behave as expected\n * dependencies to external elements: globals, session, cache...\n* E - error: something went wrong and the tested code has crashed\n * typos in the code, or in the test code\n * dependencies to missing external elements If Xdebug has been installed and activated, two coverage reports will be generated: a summary in the console a detailed HTML report with metrics for tested code\n * to open it in a web browser: firefox coverage/index.html &", + "title": "Test results and coverage" + }, + { + "location": "/Unit-tests/#executing-specific-tests", + "text": "Add a @group annotation in a test class or method comment: /**\n * Netscape bookmark import\n * @group WIP\n */\nclass BookmarkImportTest extends PHPUnit_Framework_TestCase\n{\n [...]\n} To run all tests annotated with @group WIP : $ vendor/bin/phpunit --group WIP tests/", + "title": "Executing specific tests" + }, + { + "location": "/FAQ/", + "text": "Why did you create Shaarli ?\n\n\nI was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And\u2026 oh\u2026 \ntheir Firefox addon sends to Diigo every single URL you visit\n (Don't believe me ? Use \nTamper Data\n and open any page).\n\n\nEnough is enough. Saving simple links should not be a complicated heavy thing. I ditched them all and wrote my own: Shaarli. It's simple, but it does the job and does it well. And my data is not hosted on a foreign server, but on my server.\n\n\nWhy use Shaarli and not Delicious/Diigo ?\n\n\nWith Shaarli:\n\n\n\n\nThe data is yours: It's hosted on your server.\n\n\nNever fear of having your data locked-in.\n\n\nNever fear to have your data sold to third party.\n\n\nYour private links are not hosted on a third party server.\n\n\nYou are not tracked by browser addons (like Diigo does)\n\n\nYou can change the look and feel of the pages if you want.\n\n\nYou can change the behaviour of the program.\n\n\nIt's magnitude faster than most bookmarking services.\n\n\n\n\nWhat does Shaarli mean?\n\n\nShaarli is for shaaring your links.\n\n\nMy Shaarli is broken!\n\n\nFirst of all, ensure that both the \nweb server\n and \nShaarli\n are correctly configured, and that your installation is \nsupported\n.\n\n\nIf everything looks right but the issue(s) remain(s), please:\n- take a look at the \ntroubleshooting\n section\n- come \nchat with us\n on Gitter, we'll be happy to help ;-)\n- browse active \nissues\n and \nPull Requests\n\n - if you find one that is related to the issue, feel free to comment and provide additional details (host/Shaarli setup)\n - else, \nopen a new issue\n, and provide information about the problem:\n - \nwhat happens?\n - display glitches, invalid data, security flaws...\n - \nwhat is your configuration?\n - OS, server version, activated extensions, web browser...\n - \nis it reproducible?\n\n\nWhy not use a real database? Files are slow!\n\n\nDoes browsing \nthis page\n feel slow? Try browsing older pages, too.\n\n\nIt's not slow at all, is it? And don't forget the database contains more than 16000 links, and it's on a shared host, with 32000 visitors/day for my website alone. And it's still damn fast. Why?\n\n\nThe data file is only 3.7 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.", + "title": "FAQ" + }, + { + "location": "/FAQ/#why-did-you-create-shaarli", + "text": "I was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And\u2026 oh\u2026 their Firefox addon sends to Diigo every single URL you visit (Don't believe me ? Use Tamper Data and open any page). Enough is enough. Saving simple links should not be a complicated heavy thing. I ditched them all and wrote my own: Shaarli. It's simple, but it does the job and does it well. And my data is not hosted on a foreign server, but on my server.", + "title": "Why did you create Shaarli ?" + }, + { + "location": "/FAQ/#why-use-shaarli-and-not-deliciousdiigo", + "text": "With Shaarli: The data is yours: It's hosted on your server. Never fear of having your data locked-in. Never fear to have your data sold to third party. Your private links are not hosted on a third party server. You are not tracked by browser addons (like Diigo does) You can change the look and feel of the pages if you want. You can change the behaviour of the program. It's magnitude faster than most bookmarking services.", + "title": "Why use Shaarli and not Delicious/Diigo ?" + }, + { + "location": "/FAQ/#what-does-shaarli-mean", + "text": "Shaarli is for shaaring your links.", + "title": "What does Shaarli mean?" + }, + { + "location": "/FAQ/#my-shaarli-is-broken", + "text": "First of all, ensure that both the web server and Shaarli are correctly configured, and that your installation is supported . If everything looks right but the issue(s) remain(s), please:\n- take a look at the troubleshooting section\n- come chat with us on Gitter, we'll be happy to help ;-)\n- browse active issues and Pull Requests \n - if you find one that is related to the issue, feel free to comment and provide additional details (host/Shaarli setup)\n - else, open a new issue , and provide information about the problem:\n - what happens? - display glitches, invalid data, security flaws...\n - what is your configuration? - OS, server version, activated extensions, web browser...\n - is it reproducible?", + "title": "My Shaarli is broken!" + }, + { + "location": "/FAQ/#why-not-use-a-real-database-files-are-slow", + "text": "Does browsing this page feel slow? Try browsing older pages, too. It's not slow at all, is it? And don't forget the database contains more than 16000 links, and it's on a shared host, with 32000 visitors/day for my website alone. And it's still damn fast. Why? The data file is only 3.7 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.", + "title": "Why not use a real database? Files are slow!" + }, + { + "location": "/Community-&-Related-software/", + "text": "Unofficial but related work on Shaarli. If you maintain one of these, please get in touch with us to help us find a way to adapt your work to our fork.\n\n\nTODO: contact repos owners to see if they'd like to standardize their work with the community fork.\n\n\nCommunity\n\n\n\n\nLiens en vrac de sebsauvage\n - the original Shaarli\n\n\nA large list of Shaarlis\n\n\nA list of working Shaarli aggregators\n\n\nA list of some known Shaarlis\n\n\nAdieu Delicious, Diigo et StumbleUpon. Salut Shaarli ! - sebsauvage.net\n (fr) \n16/09/2011 - the original post about Shaarli\n\n\nOriginal ideas/fixme/TODO page\n\n\nOriginal discussion page\n (fr)\n\n\nOriginal revisions history\n\n\nShaarli.fr/my\n - Unofficial, unsupported (old fork) hosted Shaarlis provider, courtesy of \nDMeloni\n\n\n\n\nArticles and social media discussions\n\n\n\n\n2016-09-22 - Hacker News - https://news.ycombinator.com/item?id=12552176\n\n\n2015-08-15 - Reddit - \nQuestion about migrating from WordPress to Shaarli.\n\n\n2015-06-22 - Hacker News - https://news.ycombinator.com/item?id=9755366\n\n\n2015-05-12 - Reddit - \nshaarli - Self hosted Bookmarking / Delicious (PHP, MySQL)\n\n\n\n\nThird party plugins\n\n\n\n\nautosave\n by \n@kalvn\n: Automatically saves data when editing a link to avoid any loss in case of crash or unexpected shutdown.\n\n\nCode Coloration\n by \n@ArthurHoaro\n: client side code syntax highlighter.\n\n\nDisqus\n by \n@kalvn\n: Adds Disqus comment system to your Shaarli.\n\n\nemojione\n by \n@NerosTie\n: Add colorful emojis to your Shaarli.\n\n\ngoogle analytics\n by \n@ericjuden\n: Adds Google Analytics tracking support\n\n\nlaunch\n - Launch Plugin is a plugin designed to enhance and customize Launch Theme for Shaarli.\n\n\nrelated\n by \n@ilesinge\n - Show related links based on the number of identical tags.\n\n\nsocial\n by \n@alexisju\n: share links to social networks.\n\n\nshaarli2twitter\n by \n@ArthurHoaro\n - Automatically tweet your shared links from Shaarli\n\n\n\n\nThemes\n\n\nSee \nTheming\n for the list of community-contributed themes, and an installation guide.\n\n\nServer apps\n\n\n\n\nshaarchiver\n - Archive your Shaarli bookmarks and their content\n\n\nshaarli-river\n - An aggregator for shaarlis with many features \n\n\nShaarlo\n - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: \nshaarli.fr\n)\n\n\nShaarlimages\n - An image-oriented aggregator for Shaarlis\n\n\nmknexen/shaarli-api\n - A REST API for Shaarli\n\n\nSelf dead link\n - Detect dead links on shaarli. This version use the database of shaarli. \nAnother version\n, can be used for other shaarli instances (but is more resource consuming).\n\n\nBookmark Archiver\n - Save an archived copy of all websites starred using browser bookmarks/Shaarli/Delicious/Instapaper/Unmark.it/Pocket/Pinboard. Outputs browseable html. \n\n\n\n\nMobile Apps\n\n\n\n\nShaarliOS\n iOS share extension - see \n#308\n for some promo codes,\n\n\nShaarli for Android\n - Android application that adds Shaarli as a sharing provider\n\n\nShaarlier for Android\n - Android application to simply add links directly into your Shaarli\n\n\n\n\nIntegration with other platforms\n\n\n\n\ntt-rss-shaarli\n - \nTiny-Tiny RSS\n plugin that adds support for sharing articles with Shaarli\n\n\noctopress-shaarli\n - Octopress plugin to retrieve Shaarli links on the sidebar\n\n\nScuttle to Shaarli\n - Import bookmarks from Scuttle\n\n\n\n\nAlternatives to Shaarli\n\n\nSee the \nbookmarks & link sharing\n section on \nawesome-selfhosted\n.", + "title": "Community & Related software" + }, + { + "location": "/Community-&-Related-software/#community", + "text": "Liens en vrac de sebsauvage - the original Shaarli A large list of Shaarlis A list of working Shaarli aggregators A list of some known Shaarlis Adieu Delicious, Diigo et StumbleUpon. Salut Shaarli ! - sebsauvage.net (fr) 16/09/2011 - the original post about Shaarli Original ideas/fixme/TODO page Original discussion page (fr) Original revisions history Shaarli.fr/my - Unofficial, unsupported (old fork) hosted Shaarlis provider, courtesy of DMeloni", + "title": "Community" + }, + { + "location": "/Community-&-Related-software/#articles-and-social-media-discussions", + "text": "2016-09-22 - Hacker News - https://news.ycombinator.com/item?id=12552176 2015-08-15 - Reddit - Question about migrating from WordPress to Shaarli. 2015-06-22 - Hacker News - https://news.ycombinator.com/item?id=9755366 2015-05-12 - Reddit - shaarli - Self hosted Bookmarking / Delicious (PHP, MySQL)", + "title": "Articles and social media discussions" + }, + { + "location": "/Community-&-Related-software/#third-party-plugins", + "text": "autosave by @kalvn : Automatically saves data when editing a link to avoid any loss in case of crash or unexpected shutdown. Code Coloration by @ArthurHoaro : client side code syntax highlighter. Disqus by @kalvn : Adds Disqus comment system to your Shaarli. emojione by @NerosTie : Add colorful emojis to your Shaarli. google analytics by @ericjuden : Adds Google Analytics tracking support launch - Launch Plugin is a plugin designed to enhance and customize Launch Theme for Shaarli. related by @ilesinge - Show related links based on the number of identical tags. social by @alexisju : share links to social networks. shaarli2twitter by @ArthurHoaro - Automatically tweet your shared links from Shaarli", + "title": "Third party plugins" + }, + { + "location": "/Community-&-Related-software/#themes", + "text": "See Theming for the list of community-contributed themes, and an installation guide.", + "title": "Themes" + }, + { + "location": "/Community-&-Related-software/#server-apps", + "text": "shaarchiver - Archive your Shaarli bookmarks and their content shaarli-river - An aggregator for shaarlis with many features Shaarlo - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: shaarli.fr ) Shaarlimages - An image-oriented aggregator for Shaarlis mknexen/shaarli-api - A REST API for Shaarli Self dead link - Detect dead links on shaarli. This version use the database of shaarli. Another version , can be used for other shaarli instances (but is more resource consuming). Bookmark Archiver - Save an archived copy of all websites starred using browser bookmarks/Shaarli/Delicious/Instapaper/Unmark.it/Pocket/Pinboard. Outputs browseable html.", + "title": "Server apps" + }, + { + "location": "/Community-&-Related-software/#mobile-apps", + "text": "ShaarliOS iOS share extension - see #308 for some promo codes, Shaarli for Android - Android application that adds Shaarli as a sharing provider Shaarlier for Android - Android application to simply add links directly into your Shaarli", + "title": "Mobile Apps" + }, + { + "location": "/Community-&-Related-software/#integration-with-other-platforms", + "text": "tt-rss-shaarli - Tiny-Tiny RSS plugin that adds support for sharing articles with Shaarli octopress-shaarli - Octopress plugin to retrieve Shaarli links on the sidebar Scuttle to Shaarli - Import bookmarks from Scuttle", + "title": "Integration with other platforms" + }, + { + "location": "/Community-&-Related-software/#alternatives-to-shaarli", + "text": "See the bookmarks & link sharing section on awesome-selfhosted .", + "title": "Alternatives to Shaarli" + } + ] +} \ No newline at end of file diff --git a/doc/html/search.html b/doc/html/search.html new file mode 100644 index 00000000..b492b8bd --- /dev/null +++ b/doc/html/search.html @@ -0,0 +1,324 @@ + + + + + + + + + + + Shaarli Documentation + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + +
    +
    +
    +
      +
    • Docs »
      • + + +
    • + +
      • +
    +
    +
    +
    +
    + + +

    Search Results

    + +
    + + +
    + +
    + Searching... +
    + + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + GitHub + + + + +
    + + + + diff --git a/doc/html/sitemap.xml b/doc/html/sitemap.xml new file mode 100644 index 00000000..534f02b5 --- /dev/null +++ b/doc/html/sitemap.xml @@ -0,0 +1,266 @@ + + + + + + / + 2017-06-18 + daily + + + + + + + /Download-and-Installation/ + 2017-06-18 + daily + + + + /Upgrade-and-migration/ + 2017-06-18 + daily + + + + /Server-requirements/ + 2017-06-18 + daily + + + + /Server-configuration/ + 2017-06-18 + daily + + + + /Server-security/ + 2017-06-18 + daily + + + + /Shaarli-configuration/ + 2017-06-18 + daily + + + + /Plugins/ + 2017-06-18 + daily + + + + + + + + /Docker-101/ + 2017-06-18 + daily + + + + /Shaarli-images/ + 2017-06-18 + daily + + + + /Reverse-proxy-configuration/ + 2017-06-18 + daily + + + + /Docker-resources/ + 2017-06-18 + daily + + + + + + + + /Features/ + 2017-06-18 + daily + + + + /Bookmarklet/ + 2017-06-18 + daily + + + + /Browsing-and-searching/ + 2017-06-18 + daily + + + + /Firefox-share/ + 2017-06-18 + daily + + + + /RSS-feeds/ + 2017-06-18 + daily + + + + /REST-API/ + 2017-06-18 + daily + + + + + + + + /Backup,-restore,-import-and-export/ + 2017-06-18 + daily + + + + /Copy-an-existing-installation-over-SSH-and-serve-it-locally/ + 2017-06-18 + daily + + + + /Create-and-serve-multiple-Shaarlis-(farm)/ + 2017-06-18 + daily + + + + /Download-CSS-styles-from-an-OPML-list/ + 2017-06-18 + daily + + + + /Datastore-hacks/ + 2017-06-18 + daily + + + + + + + /Troubleshooting/ + 2017-06-18 + daily + + + + + + + /Development-guidelines/ + 2017-06-18 + daily + + + + /Continuous-integration-tools/ + 2017-06-18 + daily + + + + /GnuPG-signature/ + 2017-06-18 + daily + + + + /Coding-guidelines/ + 2017-06-18 + daily + + + + /Directory-structure/ + 2017-06-18 + daily + + + + /3rd-party-libraries/ + 2017-06-18 + daily + + + + /Plugin-System/ + 2017-06-18 + daily + + + + /Release-Shaarli/ + 2017-06-18 + daily + + + + /Versioning-and-Branches/ + 2017-06-18 + daily + + + + /Security/ + 2017-06-18 + daily + + + + /Static-analysis/ + 2017-06-18 + daily + + + + /Theming/ + 2017-06-18 + daily + + + + /Unit-tests/ + 2017-06-18 + daily + + + + + + + + /FAQ/ + 2017-06-18 + daily + + + + /Community-&-Related-software/ + 2017-06-18 + daily + + + + + \ No newline at end of file diff --git a/doc/3rd-party-libraries.md b/doc/md/3rd-party-libraries.md similarity index 73% rename from doc/3rd-party-libraries.md rename to doc/md/3rd-party-libraries.md index e6370549..ebab7a46 100644 --- a/doc/3rd-party-libraries.md +++ b/doc/md/3rd-party-libraries.md @@ -1,14 +1,13 @@ -#3rd party libraries ## CSS -- Yahoo UI [CSS Reset](http://yuilibrary.com/yui/docs/cssreset/)[](.html) +- Yahoo UI [CSS Reset](http://yuilibrary.com/yui/docs/cssreset/) - resets default CSS properties for all HTML elements (overriding browsers' default values) - ensures custom CSS stylessheets will provide the same results on all browsers ## Javascript -- [Awesomeplete](https://leaverou.github.io/awesomplete/) ([GitHub](https://github.com/LeaVerou/awesomplete)) - autocompletion in input forms[](.html) -- [bLazy](http://dinbror.dk/blazy/) ([GitHub](https://github.com/dinbror/blazy)) - lazy loading for thumbnails[](.html) -- [qr.js](http://neocotic.com/qr.js/) ([GitHub](https://github.com/neocotic/qr.js)) - QR code generation[](.html) +- [Awesomeplete](https://leaverou.github.io/awesomplete/) ([GitHub](https://github.com/LeaVerou/awesomplete)) - autocompletion in input forms +- [bLazy](http://dinbror.dk/blazy/) ([GitHub](https://github.com/dinbror/blazy)) - lazy loading for thumbnails +- [qr.js](http://neocotic.com/qr.js/) ([GitHub](https://github.com/neocotic/qr.js)) - QR code generation ## PHP -- [shaarli/netscape-bookmark-parser](https://github.com/shaarli/netscape-bookmark-parser) - Netscape bookmark parser[](.html) -- [RainTPL](https://github.com/rainphp/raintpl) - HTML templating for PHP[](.html) +- [shaarli/netscape-bookmark-parser](https://github.com/shaarli/netscape-bookmark-parser) - Netscape bookmark parser +- [RainTPL](https://github.com/rainphp/raintpl) - HTML templating for PHP diff --git a/doc/Backup,-restore,-import-and-export.md b/doc/md/Backup,-restore,-import-and-export.md similarity index 87% rename from doc/Backup,-restore,-import-and-export.md rename to doc/md/Backup,-restore,-import-and-export.md index 9f5598ef..d3252226 100644 --- a/doc/Backup,-restore,-import-and-export.md +++ b/doc/md/Backup,-restore,-import-and-export.md @@ -1,9 +1,8 @@ -#Backup, restore, import and export - * [Backup and restore the datastore file](#backup-and-restore-the-datastore-file)[](.html) - * [Export links as...](#export-links-as)[](.html) - * [Import links from...](#import-links-from)[](.html) - * [Import Shaarli links to Firefox](#import-shaarli-links-to-firefox)[](.html) + * [Backup and restore the datastore file](#backup-and-restore-the-datastore-file) + * [Export links as...](#export-links-as) + * [Import links from...](#import-links-from) + * [Import Shaarli links to Firefox](#import-shaarli-links-to-firefox) ---------------------- @@ -24,7 +23,7 @@ To export links as an HTML file, under _Tools > Export_, choose: - _Export private_ to export private links only Restore by using the `Import` feature. -* This can be done using the [shaarchiver](https://github.com/nodiscc/shaarchiver) tool.[](.html) +* This can be done using the [shaarchiver](https://github.com/nodiscc/shaarchiver) tool. Example command: ```bash @@ -33,23 +32,21 @@ Example command: ## Import links from... - ### Diigo If you export your bookmark from Diigo, make sure you use the Delicious export, not the Netscape export. (Their Netscape export is broken, and they don't seem to be interested in fixing it.) - ### Mister Wong -See [this issue](https://github.com/sebsauvage/Shaarli/issues/146) for import tweaks.[](.html) +See [this issue](https://github.com/sebsauvage/Shaarli/issues/146) for import tweaks. ### SemanticScuttle -To correctly import the tags from a [SemanticScuttle](http://semanticscuttle.sourceforge.net/) HTML export, edit the HTML file before importing and replace all occurences of `tags=` (lowercase) to `TAGS=` (uppercase).[](.html) +To correctly import the tags from a [SemanticScuttle](http://semanticscuttle.sourceforge.net/) HTML export, edit the HTML file before importing and replace all occurences of `tags=` (lowercase) to `TAGS=` (uppercase). ### Scuttle -Shaarli cannot import data directly from [Scuttle](https://github.com/scronide/scuttle). However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer.[](.html) +Shaarli cannot import data directly from [Scuttle](https://github.com/scronide/scuttle). However, you can use this third party tool: https://github.com/q2apro/scuttle-to-shaarli to export the Scuttle database to the Netscape HTML format compatible with the Shaarli importer. ## Import Shaarli links to Firefox @@ -62,5 +59,5 @@ Your bookmarks will be imported in Firefox, ready to use, with tags and descript You may be interested in these Firefox addons to manage links imported from Shaarli - * [Bookmark Deduplicator](https://addons.mozilla.org/en-US/firefox/addon/bookmark-deduplicator/) - provides an easy way to deduplicate your bookmarks[](.html) - * [TagSieve](https://addons.mozilla.org/en-US/firefox/addon/tagsieve/) - browse your bookmarks by their tags[](.html) + * [Bookmark Deduplicator](https://addons.mozilla.org/en-US/firefox/addon/bookmark-deduplicator/) - provides an easy way to deduplicate your bookmarks + * [TagSieve](https://addons.mozilla.org/en-US/firefox/addon/tagsieve/) - browse your bookmarks by their tags diff --git a/doc/Sharing-button.md b/doc/md/Bookmarklet.md similarity index 76% rename from doc/Sharing-button.md rename to doc/md/Bookmarklet.md index e4388863..265ced44 100644 --- a/doc/Sharing-button.md +++ b/doc/md/Bookmarklet.md @@ -1,4 +1,3 @@ -#Sharing button ### Add the sharing button (_bookmarklet_) to your browser * Open your Shaarli and `Login` @@ -7,14 +6,14 @@ _This bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar._ -![(images/bookmarklet.png)]((images/bookmarklet.png).html) +![](images/bookmarklet.png) ### Share links using the _bookmarklet_ * When you are visiting a webpage you would like to share with Shaarli, click the _bookmarklet_ you just added. * A window opens. * You can freely edit title, description, tags... to find it later using the text search or tag filtering. - * You will be able to edit this link later using the ![(https://raw.githubusercontent.com/shaarli/Shaarli/master/images/edit_icon.png) edit button.]((https://raw.githubusercontent.com/shaarli/Shaarli/master/images/edit_icon.png)-edit-button..html) + * You will be able to edit this link later using the ![](https://raw.githubusercontent.com/shaarli/Shaarli/master/images/edit_icon.png) edit button. * You can also check the “Private” box so that the link is saved but only visible to you. * Click `Save`.**Voilà! Your link is now shared.** @@ -22,7 +21,7 @@ _This bookmarklet button is compatible with Firefox, Opera, Chrome and Safari. U Websites which enforce Content Security Policy (CSP), such as github.com, disallow usage of bookmarklets. Unfortunatly, there is nothing Shaarli can do about it. -See [#196](https://github.com/shaarli/Shaarli#196).[](.html) +See [#196](https://github.com/shaarli/Shaarli#196). There is an open bug for both Firefox and Chromium: diff --git a/doc/Browsing-and-searching.md b/doc/md/Browsing-and-searching.md similarity index 83% rename from doc/Browsing-and-searching.md rename to doc/md/Browsing-and-searching.md index 854b6b60..ad62c2f0 100644 --- a/doc/Browsing-and-searching.md +++ b/doc/md/Browsing-and-searching.md @@ -1,8 +1,3 @@ -#Browsing and searching -# Browsing and Searching - -![(http://pix.toile-libre.org/upload/original/1455571378.png)]((http://pix.toile-libre.org/upload/original/1455571378.png).html) - ## Plain text search Use the `Search text` field to search in _any_ of the fields of all links (Title, URL, Description...) @@ -25,4 +20,4 @@ To search for links that are not tagged, enter `""` in the tag search field. ## Filtering RSS feeds/Picture wall -RSS feeds can also be restricted to only return items matching a text/tag search: see [RSS feeds](RSS-feeds.html). +RSS feeds can also be restricted to only return items matching a text/tag search: see [[RSS feeds]]. diff --git a/doc/Coding-guidelines.md b/doc/md/Coding-guidelines.md similarity index 64% rename from doc/Coding-guidelines.md rename to doc/md/Coding-guidelines.md index 1fb28a5b..da47c498 100644 --- a/doc/Coding-guidelines.md +++ b/doc/md/Coding-guidelines.md @@ -1,5 +1,5 @@ -#Coding guidelines ## WIP + This topic is currently being discussed here: -- [Fix coding style (static analysis)](https://github.com/shaarli/Shaarli/issues/95) (#95)[](.html) -- [Continuous Integration tools & features](https://github.com/shaarli/Shaarli/issues/130) (#130)[](.html) +- [Fix coding style (static analysis)](https://github.com/shaarli/Shaarli/issues/95) (#95) +- [Continuous Integration tools & features](https://github.com/shaarli/Shaarli/issues/130) (#130) diff --git a/doc/Community-&-Related-software.md b/doc/md/Community-&-Related-software.md similarity index 64% rename from doc/Community-&-Related-software.md rename to doc/md/Community-&-Related-software.md index 52123a1e..6ff7ed45 100644 --- a/doc/Community-&-Related-software.md +++ b/doc/md/Community-&-Related-software.md @@ -1,61 +1,60 @@ -#Community & Related software _Unofficial but related work on Shaarli. If you maintain one of these, please get in touch with us to help us find a way to adapt your work to our fork._ _TODO: contact repos owners to see if they'd like to standardize their work with the community fork._ ## Community -- [Liens en vrac de sebsauvage](http://sebsauvage.net/links/) - the original Shaarli[](.html) -- [A large list of Shaarlis](http://porneia.free.fr/pub/links/ou-est-shaarli.html)[](.html) -- [A list of working Shaarli aggregators](https://raw.githubusercontent.com/Oros42/find_shaarlis/master/annuaires.json)[](.html) -- [A list of some known Shaarlis](https://github.com/Oros42/shaarlis_list)[](.html) -- [Adieu Delicious, Diigo et StumbleUpon. Salut Shaarli ! - sebsauvage.net](http://sebsauvage.net/rhaa/index.php?2011/09/16/09/29/58-adieu-delicious-diigo-et-stumbleupon-salut-shaarli-) (fr) _16/09/2011 - the original post about Shaarli_[](.html) -- [Original ideas/fixme/TODO page](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:ideas)[](.html) -- [Original discussion page](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:discussion) (fr)[](.html) -- [Original revisions history](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:history)[](.html) -- [Shaarli.fr/my](https://www.shaarli.fr/my.php) - Unofficial, unsupported (old fork) hosted Shaarlis provider, courtesy of [DMeloni](https://github.com/DMeloni)[](.html) +- [Liens en vrac de sebsauvage](http://sebsauvage.net/links/) - the original Shaarli +- [A large list of Shaarlis](http://porneia.free.fr/pub/links/ou-est-shaarli.html) +- [A list of working Shaarli aggregators](https://raw.githubusercontent.com/Oros42/find_shaarlis/master/annuaires.json) +- [A list of some known Shaarlis](https://github.com/Oros42/shaarlis_list) +- [Adieu Delicious, Diigo et StumbleUpon. Salut Shaarli ! - sebsauvage.net](http://sebsauvage.net/rhaa/index.php?2011/09/16/09/29/58-adieu-delicious-diigo-et-stumbleupon-salut-shaarli-) (fr) _16/09/2011 - the original post about Shaarli_ +- [Original ideas/fixme/TODO page](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:ideas) +- [Original discussion page](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:discussion) (fr) +- [Original revisions history](http://sebsauvage.net/wiki/doku.php?id=php:shaarli:history) +- [Shaarli.fr/my](https://www.shaarli.fr/my.php) - Unofficial, unsupported (old fork) hosted Shaarlis provider, courtesy of [DMeloni](https://github.com/DMeloni) ### Articles and social media discussions - 2016-09-22 - Hacker News - https://news.ycombinator.com/item?id=12552176 -- 2015-08-15 - Reddit - [Question about migrating from WordPress to Shaarli.](https://www.reddit.com/r/selfhosted/comments/3h3zwh/question_about_migrating_from_wordpress_to_shaarli/)[](.html) +- 2015-08-15 - Reddit - [Question about migrating from WordPress to Shaarli.](https://www.reddit.com/r/selfhosted/comments/3h3zwh/question_about_migrating_from_wordpress_to_shaarli/) - 2015-06-22 - Hacker News - https://news.ycombinator.com/item?id=9755366 -- 2015-05-12 - Reddit - [shaarli - Self hosted Bookmarking / Delicious (PHP, MySQL)](https://www.reddit.com/r/selfhosted/comments/35pkkc/shaarli_self_hosted_bookmarking_delicious_php/)[](.html) +- 2015-05-12 - Reddit - [shaarli - Self hosted Bookmarking / Delicious (PHP, MySQL)](https://www.reddit.com/r/selfhosted/comments/35pkkc/shaarli_self_hosted_bookmarking_delicious_php/) ### Third party plugins - * [autosave](https://github.com/kalvn/shaarli-plugin-autosave) by [@kalvn](https://github.com/kalvn): Automatically saves data when editing a link to avoid any loss in case of crash or unexpected shutdown.[](.html) - * [Code Coloration](https://github.com/ArthurHoaro/code-coloration) by [@ArthurHoaro](https://github.com/ArthurHoaro): client side code syntax highlighter.[](.html) - * [Disqus](https://github.com/kalvn/shaarli-plugin-disqus) by [@kalvn](https://github.com/kalvn): Adds Disqus comment system to your Shaarli.[](.html) - * [emojione](https://github.com/NerosTie/emojione) by [@NerosTie](https://github.com/NerosTie): Add colorful emojis to your Shaarli.[](.html) - * [google analytics](https://github.com/ericjuden/Shaarli-Google-Analytics-Plugin) by [@ericjuden](http://github.com/ericjuden): Adds Google Analytics tracking support[](.html) - * [launch](https://github.com/ArthurHoaro/launch-plugin) - Launch Plugin is a plugin designed to enhance and customize Launch Theme for Shaarli.[](.html) - * [social](https://github.com/alexisju/social) by [@alexisju](https://github.com/alexisju): share links to social networks.[](.html) - * [shaarli2twitter](https://github.com/ArthurHoaro/shaarli2twitter) by [@ArthurHoaro](https://github.com/ArthurHoaro) - Automatically tweet your shared links from Shaarli[](.html) + * [autosave](https://github.com/kalvn/shaarli-plugin-autosave) by [@kalvn](https://github.com/kalvn): Automatically saves data when editing a link to avoid any loss in case of crash or unexpected shutdown. + * [Code Coloration](https://github.com/ArthurHoaro/code-coloration) by [@ArthurHoaro](https://github.com/ArthurHoaro): client side code syntax highlighter. + * [Disqus](https://github.com/kalvn/shaarli-plugin-disqus) by [@kalvn](https://github.com/kalvn): Adds Disqus comment system to your Shaarli. + * [emojione](https://github.com/NerosTie/emojione) by [@NerosTie](https://github.com/NerosTie): Add colorful emojis to your Shaarli. + * [google analytics](https://github.com/ericjuden/Shaarli-Google-Analytics-Plugin) by [@ericjuden](http://github.com/ericjuden): Adds Google Analytics tracking support + * [launch](https://github.com/ArthurHoaro/launch-plugin) - Launch Plugin is a plugin designed to enhance and customize Launch Theme for Shaarli. + * [related](https://github.com/ilesinge/shaarli-related) by [@ilesinge](https://github.com/ilesinge) - Show related links based on the number of identical tags. + * [social](https://github.com/alexisju/social) by [@alexisju](https://github.com/alexisju): share links to social networks. + * [shaarli2twitter](https://github.com/ArthurHoaro/shaarli2twitter) by [@ArthurHoaro](https://github.com/ArthurHoaro) - Automatically tweet your shared links from Shaarli ### Themes -See [Theming](Theming.html) for the list of community-contributed themes, and an installation guide. +See [[Theming]] for the list of community-contributed themes, and an installation guide. ### Server apps -- [shaarchiver](https://github.com/nodiscc/shaarchiver) - Archive your Shaarli bookmarks and their content[](.html) -- [shaarli-river](https://github.com/mknexen/shaarli-river) - An aggregator for shaarlis with many features [](.html) -- [Shaarlo](https://github.com/DMeloni/shaarlo) - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: [shaarli.fr](http://shaarli.fr/))[](.html) -- [Shaarlimages](https://github.com/BoboTiG/shaarlimages) - An image-oriented aggregator for Shaarlis[](.html) -- [mknexen/shaarli-api](https://github.com/mknexen/shaarli-api) - A REST API for Shaarli[](.html) -- [Self dead link](https://github.com/qwertygc/shaarli-dev-code/blob/master/self-dead-link.php) - Detect dead links on shaarli. This version use the database of shaarli. [Another version](https://github.com/qwertygc/shaarli-dev-code/blob/master/dead-link.php), can be used for other shaarli instances (but is more resource consuming).[](.html) +- [shaarchiver](https://github.com/nodiscc/shaarchiver) - Archive your Shaarli bookmarks and their content +- [shaarli-river](https://github.com/mknexen/shaarli-river) - An aggregator for shaarlis with many features +- [Shaarlo](https://github.com/DMeloni/shaarlo) - An aggregator for shaarlis with many features (a very popular running instance among french shaarliers: [shaarli.fr](http://shaarli.fr/)) +- [Shaarlimages](https://github.com/BoboTiG/shaarlimages) - An image-oriented aggregator for Shaarlis +- [mknexen/shaarli-api](https://github.com/mknexen/shaarli-api) - A REST API for Shaarli +- [Self dead link](https://github.com/qwertygc/shaarli-dev-code/blob/master/self-dead-link.php) - Detect dead links on shaarli. This version use the database of shaarli. [Another version](https://github.com/qwertygc/shaarli-dev-code/blob/master/dead-link.php), can be used for other shaarli instances (but is more resource consuming). +- [Bookmark Archiver](https://github.com/pirate/bookmark-archiver) - Save an archived copy of all websites starred using browser bookmarks/Shaarli/Delicious/Instapaper/Unmark.it/Pocket/Pinboard. Outputs browseable html. ### Mobile Apps -- [Shaarli💫](http://app.mro.name/Shaarli💫) iOS share extension - see [#308](https://github.com/shaarli/Shaarli/issues/308#issuecomment-184592070) for some promo codes,[](.html) -- [Shaarli for Android](http://sebsauvage.net/links/?ZAyDzg) - Android application that adds Shaarli as a sharing provider[](.html) -- [Shaarlier for Android](https://github.com/dimtion/Shaarlier) - Android application to simply add links directly into your Shaarli[](.html) +- [ShaarliOS](https://github.com/mro/ShaarliOS) iOS share extension - see [#308](https://github.com/shaarli/Shaarli/issues/308#issuecomment-184592070) for some promo codes, +- [Shaarli for Android](http://sebsauvage.net/links/?ZAyDzg) - Android application that adds Shaarli as a sharing provider +- [Shaarlier for Android](https://github.com/dimtion/Shaarlier) - Android application to simply add links directly into your Shaarli ## Integration with other platforms -- [tt-rss-shaarli](https://github.com/jcsaaddupuy/tt-rss-shaarli) - [TinyTiny RSS](http://tt-rss.org/) plugin that adds support for sharing articles with Shaarli[](.html) -- [octopress-shaarli](https://github.com/ahmet2mir/octopress-shaarli) - Octopress plugin to retrieve Shaarli links on the sidebar[](.html) -- [Scuttle to Shaarli](https://github.com/q2apro/scuttle-to-shaarli) - Import bookmarks from Scuttle[](.html) +- [tt-rss-shaarli](https://github.com/jcsaaddupuy/tt-rss-shaarli) - [Tiny-Tiny RSS](http://tt-rss.org/) plugin that adds support for sharing articles with Shaarli +- [octopress-shaarli](https://github.com/ahmet2mir/octopress-shaarli) - Octopress plugin to retrieve Shaarli links on the sidebar +- [Scuttle to Shaarli](https://github.com/q2apro/scuttle-to-shaarli) - Import bookmarks from Scuttle ## Alternatives to Shaarli -- [Shaarli alternatives](http://alternativeto.net/software/shaarli/) (alternativeto.net)[](.html) -- [Bookie](https://github.com/bookieio/bookie) - Another self-hostable, free bookmark sharing software, written in Python[](.html) -- [Unmark](https://github.com/plainmade/unmark) - An open source todo app for bookmarks ([Homepage](https://unmark.it/))[](.html) -- [Wordpress bookmarks](https://wordpress.org/plugins/wp-bookmarks/)[](.html) + +See the [bookmarks & link sharing](https://github.com/Kickball/awesome-selfhosted/#bookmarks--link-sharing) section on [awesome-selfhosted](https://github.com/Kickball/awesome-selfhosted/). diff --git a/doc/md/Continuous-integration-tools.md b/doc/md/Continuous-integration-tools.md new file mode 100644 index 00000000..30dc474d --- /dev/null +++ b/doc/md/Continuous-integration-tools.md @@ -0,0 +1,24 @@ +## Local development +A [`Makefile`](https://github.com/shaarli/Shaarli/blob/master/Makefile) is available to perform project-related operations: +- Documentation - generate a local HTML copy of the GitHub wiki +- [[Static analysis]] - check that the code is compliant to PHP conventions +- [[Unit tests]] - ensure there are no regressions introduced by new commits + +## Automatic builds +[Travis CI](http://docs.travis-ci.com/) is a Continuous Integration build server, that runs a build: +- each time a commit is merged to the mainline (`master` branch) +- each time a Pull Request is submitted or updated + +A build is composed of several jobs: one for each supported PHP version (see [[Server requirements]]). + +Each build job: +- updates Composer +- installs 3rd-party test dependencies with Composer +- runs [[Unit tests]] + +After all jobs have finished, Travis returns the results to GitHub: +- a status icon represents the result for the `master` branch: [![](https://api.travis-ci.org/shaarli/Shaarli.svg)](https://travis-ci.org/shaarli/Shaarli) +- Pull Requests are updated with the Travis result + - Green: all tests have passed + - Red: some tests failed + - Orange: tests are pending diff --git a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md b/doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md similarity index 88% rename from doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md rename to doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md index 88d191da..7583c9ea 100644 --- a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md +++ b/doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md @@ -1,4 +1,3 @@ -#Copy an existing installation over SSH and serve it locally Example bash script: ```bash @@ -61,7 +60,7 @@ Listening on http://localhost:7431 Document root is /home/user/local-shaarli/shaarli Press Ctrl-C to quit. -[Mon Sep 1 21:56:27 2014] ::1:57868 [200]: /[](.html) -[Mon Sep 1 21:56:27 2014] ::1:57869 [200]: /index.html[](.html) -[Mon Sep 1 21:56:37 2014] ::1:57881 [200]: /...[](.html) +[Mon Sep 1 21:56:27 2014] ::1:57868 [200]: / +[Mon Sep 1 21:56:27 2014] ::1:57869 [200]: /index.html +[Mon Sep 1 21:56:37 2014] ::1:57881 [200]: /... ``` diff --git a/doc/Create-and-serve-multiple-Shaarlis-(farm).md b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md similarity index 77% rename from doc/Create-and-serve-multiple-Shaarlis-(farm).md rename to doc/md/Create-and-serve-multiple-Shaarlis-(farm).md index a71f6520..d0d812a3 100644 --- a/doc/Create-and-serve-multiple-Shaarlis-(farm).md +++ b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md @@ -1,4 +1,3 @@ -#Create and serve multiple Shaarlis (farm) Example bash script (creates multiple shaarli instances and generates an HTML index of them) ```bash @@ -13,12 +12,12 @@ shaarli_repo_url='https://github.com/shaarli/Shaarli' ref="master" #clone multiple shaarli instances -if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi[](.html) +if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi for account in $accounts; do - if [ -d "$shaarli_base_dir/$account" ];[](.html) - then echo "[info] account $account already exists, skipping";[](.html) - else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi[](.html) + if [ -d "$shaarli_base_dir/$account" ]; + then echo "[info] account $account already exists, skipping"; + else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi done #generate html index of shaarlis @@ -46,13 +45,13 @@ htmlfooter=' for account in $accounts; do accountlinks="$accountlinks\n
  • $account
    • "; done -if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi[](.html) -echo "[info] generating new index of shaarlis"[](.html) +if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi +echo "[info] generating new index of shaarlis" echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html" -echo '[info] done.'[](.html) -echo "[info] list of accounts: $accounts"[](.html) -echo "[info] contents of $shaarli_base_dir:"[](.html) +echo '[info] done.' +echo "[info] list of accounts: $accounts" +echo "[info] contents of $shaarli_base_dir:" tree -a -L 1 "$shaarli_base_dir" ``` -This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/)[](.html) +This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/) \ No newline at end of file diff --git a/doc/Datastore-hacks.md b/doc/md/Datastore-hacks.md similarity index 98% rename from doc/Datastore-hacks.md rename to doc/md/Datastore-hacks.md index ef6f6d50..78baa005 100644 --- a/doc/Datastore-hacks.md +++ b/doc/md/Datastore-hacks.md @@ -1,5 +1,5 @@ -#Datastore hacks ### Decode datastore content + To display the array representing the data saved in `data/datastore.php`, use the following snippet: ```php @@ -18,6 +18,7 @@ php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace("!.*/ ``` ### Changing the timestamp for a link + * Look for `` in `tpl/editlink.tpl` (line 14) * Replace `type="hidden"` with `type="text"` from this line * A new date/time field becomes available in the edit/new link dialog. diff --git a/doc/md/Development-guidelines.md b/doc/md/Development-guidelines.md new file mode 100644 index 00000000..1480ec89 --- /dev/null +++ b/doc/md/Development-guidelines.md @@ -0,0 +1,9 @@ +## Development guidelines + +Please have a look at the following pages: +- [Contributing to Shaarli](https://github.com/shaarli/Shaarli/tree/master/CONTRIBUTING.md) +- [[Static analysis]] - patches should try to stick to the [PHP Standard Recommendations](http://www.php-fig.org/psr/) (PSR), especially: + - [PSR-1](http://www.php-fig.org/psr/psr-1/) - Basic Coding Standard + - [PSR-2](http://www.php-fig.org/psr/psr-2/) - Coding Style Guide +- [[Unit tests]] +- [[GnuPG signature]] for tags/releases diff --git a/doc/Directory-structure.md b/doc/md/Directory-structure.md similarity index 98% rename from doc/Directory-structure.md rename to doc/md/Directory-structure.md index 3a1c4309..eb50965b 100644 --- a/doc/Directory-structure.md +++ b/doc/md/Directory-structure.md @@ -1,4 +1,5 @@ -#Directory structure +TODO: This page is out of date + Here is the directory structure of Shaarli and the purpose of the different files: ```bash diff --git a/doc/md/Docker-101.md b/doc/md/Docker-101.md new file mode 100644 index 00000000..b02dd149 --- /dev/null +++ b/doc/md/Docker-101.md @@ -0,0 +1,62 @@ +## Basics +Install [Docker](https://www.docker.com/), by following the instructions relevant +to your OS / distribution, and start the service. + +### Search an image on [DockerHub](https://hub.docker.com/) + +```bash +$ docker search debian + +NAME DESCRIPTION STARS OFFICIAL AUTOMATED +ubuntu Ubuntu is a Debian-based Linux operating s... 2065 [OK] +debian Debian is a Linux distribution that's comp... 603 [OK] +google/debian 47 [OK] +``` + +### Show available tags for a repository +```bash +$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool + +% Total % Received % Xferd Average Speed Time Time Time Current +Dload Upload Total Spent Left Speed +100 1283 0 1283 0 0 433 0 --:--:-- 0:00:02 --:--:-- 433 +``` + +Sample output: +```json +[ + { + "layer": "85a02782", + "name": "stretch" + }, + { + "layer": "59abecbc", + "name": "testing" + }, + { + "layer": "bf0fd686", + "name": "unstable" + }, + { + "layer": "60c52dbe", + "name": "wheezy" + }, + { + "layer": "c5b806fe", + "name": "wheezy-backports" + } +] + +``` + +### Pull an image from DockerHub +```bash +$ docker pull repository[:tag] + +$ docker pull debian:wheezy +wheezy: Pulling from debian +4c8cbfd2973e: Pull complete +60c52dbe9d91: Pull complete +Digest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe +Status: Downloaded newer image for debian:wheezy +``` diff --git a/doc/md/Docker-resources.md b/doc/md/Docker-resources.md new file mode 100644 index 00000000..082d4a46 --- /dev/null +++ b/doc/md/Docker-resources.md @@ -0,0 +1,19 @@ +### Docker + +- [Interactive Docker training portal](https://www.katacoda.com/courses/docker/) on [Katakoda](https://www.katacoda.com/) +- [Where are Docker images stored?](http://blog.thoward37.me/articles/where-are-docker-images-stored/) +- [Dockerfile reference](https://docs.docker.com/reference/builder/) +- [Dockerfile best practices](https://docs.docker.com/articles/dockerfile_best-practices/) +- [Volumes](https://docs.docker.com/userguide/dockervolumes/) + +### DockerHub + +- [Repositories](https://docs.docker.com/userguide/dockerrepos/) +- [Teams and organizations](https://docs.docker.com/docker-hub/orgs/) +- [GitHub automated build](https://docs.docker.com/docker-hub/github/) + +### Service management + +- [Using supervisord](https://docs.docker.com/articles/using_supervisord/) +- [Nginx in the foreground](http://nginx.org/en/docs/ngx_core_module.html#daemon) +- [supervisord](http://supervisord.org/) diff --git a/doc/Download-CSS-styles-from-an-OPML-list.md b/doc/md/Download-CSS-styles-from-an-OPML-list.md similarity index 92% rename from doc/Download-CSS-styles-from-an-OPML-list.md rename to doc/md/Download-CSS-styles-from-an-OPML-list.md index eb66f955..26b7fb3e 100644 --- a/doc/Download-CSS-styles-from-an-OPML-list.md +++ b/doc/md/Download-CSS-styles-from-an-OPML-list.md @@ -1,4 +1,3 @@ -#Download CSS styles from an OPML list ###Download CSS styles for shaarlis listed in an opml file Example php script: @@ -34,8 +33,8 @@ function createShaarliHashFromOPMLL($opmlFile) { $opmlXml = simplexml_load_string($opml); $outlineElements = $opmlXml->xpath("body/outline"); foreach($outlineElements as $site) { - $siteUrl = siteUrl((string) $site['htmlUrl']);[](.html) - $result[$siteUrl]=((string) $site['text']);[](.html) + $siteUrl = siteUrl((string) $site['htmlUrl']); + $result[$siteUrl]=((string) $site['text']); } return $result; } @@ -47,7 +46,7 @@ function getSiteFolder($url) { function get_http_response_code($theURL) { $headers = get_headers($theURL); - return substr($headers[0], 9, 3);[](.html) + return substr($headers[0], 9, 3); } /** @@ -122,7 +121,7 @@ function getDirectoryList ($directory) { while ($file = readdir($handler)) { // if file isn't this directory or its parent, add it to the results if ($file != "." && $file != "..") { - $results[ = realpath($realPath . "/" . $file);](-=-realpath($realPath-.-"/"-.-$file);.html) + $results[] = realpath($realPath . "/" . $file); } } // tidy up: close the handler @@ -142,7 +141,7 @@ function findKnownStyles() { $configFile = $folder."/config.ini"; if(file_exists($configFile)) { $iniParameters = parse_ini_file($configFile); - array_push($result, $iniParameters['site_url']);[](.html) + array_push($result, $iniParameters['site_url']); } } return $result; @@ -152,4 +151,4 @@ $knownStyles = findKnownStyles(); copyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles); -``` +``` \ No newline at end of file diff --git a/doc/Download-and-Installation.md b/doc/md/Download-and-Installation.md similarity index 88% rename from doc/Download-and-Installation.md rename to doc/md/Download-and-Installation.md index 970144a5..7880aef4 100644 --- a/doc/Download-and-Installation.md +++ b/doc/md/Download-and-Installation.md @@ -1,7 +1,4 @@ -#Download and Installation -# Get Shaarli! - -To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your [server](Server-requirements) is properly [configured](Server-configuration).[](.html) +To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your [server](Server-requirements) is properly [configured](Server-configuration). Several releases are available: @@ -9,7 +6,7 @@ Several releases are available: ## Latest release (recommended) ### Download as an archive -Get the latest released version from the [releases](https://github.com/shaarli/Shaarli/releases) page.[](.html) +Get the latest released version from the [releases](https://github.com/shaarli/Shaarli/releases) page. **Download our *shaarli-full* archive** to include dependencies. @@ -23,7 +20,7 @@ $ unzip shaarli-v0.8.4-full.zip $ mv Shaarli /path/to/shaarli/ ``` -| ! |In most cases, download Shaarli from the [releases](https://github.com/shaarli/Shaarli/releases) page. Cloning using `git` or downloading Github branches as zip files requires additional steps (see below).|[](.html) +| ! |In most cases, download Shaarli from the [releases](https://github.com/shaarli/Shaarli/releases) page. Cloning using `git` or downloading Github branches as zip files requires additional steps (see below).| |-----|--------------------------| ### Using git @@ -60,7 +57,7 @@ $ mv Shaarli-stable /path/to/shaarli/ ### Clone with Git -[Composer](https://getcomposer.org/) is required to build a functional Shaarli installation when pulling from git.[](.html) +[Composer](https://getcomposer.org/) is required to build a functional Shaarli installation when pulling from git. ```bash $ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/ @@ -91,7 +88,7 @@ $ composer install --no-dev Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser. -![install screenshot](http://i.imgur.com/wuMpDSN.png)[](.html) +![install screenshot](http://i.imgur.com/wuMpDSN.png) Setup your Shaarli installation, and it's ready to use! @@ -99,4 +96,4 @@ Setup your Shaarli installation, and it's ready to use! ## Updating Shaarli -See [Upgrade and Migration](Upgrade-and-migration)[](.html) +See [Upgrade and Migration](Upgrade-and-migration) diff --git a/doc/Example-patch---add-new-via-field-for-links.md b/doc/md/Example-patch---add-new-via-field-for-links.md similarity index 80% rename from doc/Example-patch---add-new-via-field-for-links.md rename to doc/md/Example-patch---add-new-via-field-for-links.md index 883adf40..d84ef25a 100644 --- a/doc/Example-patch---add-new-via-field-for-links.md +++ b/doc/md/Example-patch---add-new-via-field-for-links.md @@ -1,4 +1,3 @@ -#Example patch add new via field for links Example patch to add a new field ("via") for links, an input field to set the "via" property from the "edit link" dialog, and display the "via" field in the link list display. **Untested, use at your own risk** Thanks to @Knah-Tsaeb in https://github.com/sebsauvage/Shaarli/pull/158 @@ -7,7 +6,7 @@ Thanks to @Knah-Tsaeb in https://github.com/sebsauvage/Shaarli/pull/158 From e0f363c18e8fe67990ed2bb1a08652e24e70bbcb Mon Sep 17 00:00:00 2001 From: Knah Tsaeb Date: Fri, 11 Oct 2013 15:18:37 +0200 -Subject: [PATCH] Add a "via"/origin property for links, add new input in "edit link" dialog[](.html) +Subject: [PATCH] Add a "via"/origin property for links, add new input in "edit link" dialog Thanks to: * https://github.com/Knah-Tsaeb/Shaarli/commit/040eb18ec8cdabd5ea855e108f81f97fbf0478c4 * https://github.com/Knah-Tsaeb/Shaarli/commit/4123658eae44d7564d1128ce52ddd5689efee813 @@ -23,27 +22,27 @@ diff --git a/index.php b/index.php index 6fae2f8..53f798e 100644 --- a/index.php +++ b/index.php -@@ -436,6 +436,12 @@ if (isset($_POST['login']))[](.html) +@@ -436,6 +436,12 @@ if (isset($_POST['login'])) // ------------------------------------------------------------------------------------------ // Misc utility functions: +// Try to get just domain for @via +function getJustDomain($url){ + $parts = parse_url($url); -+ return trim($parts['host']);[](.html) ++ return trim($parts['host']); + } + // Returns the server URL (including port and http/https), without path. // e.g. "http://myserver.com:8080" - // You can append $_SERVER['SCRIPT_NAME'] to get the current script URL.[](.html) + // You can append $_SERVER['SCRIPT_NAME'] to get the current script URL. @@ -799,7 +805,8 @@ class linkdb implements Iterator, Countable, ArrayAccess - $found= (strpos(strtolower($l['title']),$s)!==false)[](.html) - || (strpos(strtolower($l['description']),$s)!==false)[](.html) - || (strpos(strtolower($l['url']),$s)!==false)[](.html) -- || (strpos(strtolower($l['tags']),$s)!==false);[](.html) -+ || (strpos(strtolower($l['tags']),$s)!==false)[](.html) -+ || (!empty($l['via']) && (strpos(strtolower($l['via']),$s)!==false));[](.html) - if ($found) $filtered[$l['linkdate'[ = $l;](-=-$l;.html) + $found= (strpos(strtolower($l['title']),$s)!==false) + || (strpos(strtolower($l['description']),$s)!==false) + || (strpos(strtolower($l['url']),$s)!==false) +- || (strpos(strtolower($l['tags']),$s)!==false); ++ || (strpos(strtolower($l['tags']),$s)!==false) ++ || (!empty($l['via']) && (strpos(strtolower($l['via']),$s)!==false)); + if ($found) $filtered[$l['linkdate']] = $l; } krsort($filtered); @@ -814,7 +821,7 @@ class linkdb implements Iterator, Countable, ArrayAccess @@ -53,74 +52,74 @@ index 6fae2f8..53f798e 100644 - foreach($this->links as $l) + foreach($this-> links as $l) { - $linktags = explode(' ',($casesensitive?$l['tags']:strtolower($l['tags'])));[](.html) + $linktags = explode(' ',($casesensitive?$l['tags']:strtolower($l['tags']))); if (count(array_intersect($linktags,$searchtags)) == count($searchtags)) @@ -905,7 +912,7 @@ function showRSS() else $linksToDisplay = $LINKSDB; $nblinksToDisplay = 50; // Number of links to display. - if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links.[](.html) + if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links. - { + { - $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ;[](.html) + $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ; } @@ -944,7 +951,12 @@ function showRSS() // If user wants permalinks first, put the final link in description if ($usepermalinks===true) $descriptionlink = '(Link)'; - if (strlen($link['description'])>0) $descriptionlink = '
    '.$descriptionlink;[](.html) -- echo ''."\n\n";](>'."\n\n";.html) -+ if(!empty($link['via'])){[](.html) -+ $via = '
    Origine => '.htmlspecialchars(getJustDomain($link['via'])).'';[](.html) + if (strlen($link['description'])>0) $descriptionlink = '
    '.$descriptionlink; +- echo ''."\n\n"; ++ if(!empty($link['via'])){ ++ $via = '
    Origine => '.htmlspecialchars(getJustDomain($link['via'])).''; + } else { + $via = ''; + } -+ echo ''."\n\n";](>'."\n\n";.html) ++ echo ''."\n\n"; $i++; } echo ''; @@ -980,7 +992,7 @@ function showATOM() else $linksToDisplay = $LINKSDB; $nblinksToDisplay = 50; // Number of links to display. - if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links.[](.html) + if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links. - { + { - $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ;[](.html) + $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ; } @@ -1006,11 +1018,16 @@ function showATOM() // Add permalink in description $descriptionlink = htmlspecialchars('(Permalink)'); -+ if(isset($link['via']) && !empty($link['via'])){[](.html) -+ $via = htmlspecialchars('
    Origine => '.getJustDomain($link['via']).'');[](.html) ++ if(isset($link['via']) && !empty($link['via'])){ ++ $via = htmlspecialchars('
    Origine => '.getJustDomain($link['via']).''); + } else { + $via = ''; + } // If user wants permalinks first, put the final link in description if ($usepermalinks===true) $descriptionlink = htmlspecialchars('(Link)'); - if (strlen($link['description'])>0) $descriptionlink = '<br>'.$descriptionlink;[](.html) + if (strlen($link['description'])>0) $descriptionlink = '<br>'.$descriptionlink; -- $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink."\n";[](.html) -+ $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink.$via."\n";[](.html) - if ($link['tags']!='') // Adding tags to each ATOM entry (as mentioned in ATOM specification)[](.html) +- $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink."\n"; ++ $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink.$via."\n"; + if ($link['tags']!='') // Adding tags to each ATOM entry (as mentioned in ATOM specification) { - foreach(explode(' ',$link['tags']) as $tag)[](.html) + foreach(explode(' ',$link['tags']) as $tag) @@ -1478,7 +1495,7 @@ function renderPage() if (!startsWith($url,'http:') && !startsWith($url,'https:') && !startsWith($url,'ftp:') && !startsWith($url,'magnet:') && !startsWith($url,'?')) $url = 'http://'.$url; - $link = array('title'=>trim($_POST['lf_title']),'url'=>$url,'description'=>trim($_POST['lf_description']),'private'=>(isset($_POST['lf_private']) ? 1 : 0),[](.html) + $link = array('title'=>trim($_POST['lf_title']),'url'=>$url,'description'=>trim($_POST['lf_description']),'private'=>(isset($_POST['lf_private']) ? 1 : 0), - 'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags)); -+ 'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags), 'via'=>trim($_POST['lf_via']));[](.html) - if ($link['title']=='') $link['title']=$link['url']; // If title is empty, use the URL as title.[](.html) - $LINKSDB[$linkdate] = $link;[](.html) ++ 'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags), 'via'=>trim($_POST['lf_via'])); + if ($link['title']=='') $link['title']=$link['url']; // If title is empty, use the URL as title. + $LINKSDB[$linkdate] = $link; $LINKSDB->savedb(); // Save to disk. @@ -1556,7 +1573,8 @@ function renderPage() - $title = (empty($_GET['title']) ? '' : $_GET['title'] ); // Get title if it was provided in URL (by the bookmarklet).[](.html) - $description = (empty($_GET['description']) ? '' : $_GET['description']); // Get description if it was provided in URL (by the bookmarklet). [Bronco added that][](.html) - $tags = (empty($_GET['tags']) ? '' : $_GET['tags'] ); // Get tags if it was provided in URL[](.html) -- $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL [](.html) -+ $via = (empty($_GET['via']) ? '' : $_GET['via'] );[](.html) -+ $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL[](.html) + $title = (empty($_GET['title']) ? '' : $_GET['title'] ); // Get title if it was provided in URL (by the bookmarklet). + $description = (empty($_GET['description']) ? '' : $_GET['description']); // Get description if it was provided in URL (by the bookmarklet). [Bronco added that] + $tags = (empty($_GET['tags']) ? '' : $_GET['tags'] ); // Get tags if it was provided in URL +- $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL ++ $via = (empty($_GET['via']) ? '' : $_GET['via'] ); ++ $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL if (($url!='') && parse_url($url,PHP_URL_SCHEME)=='') $url = 'http://'.$url; // If this is an HTTP link, we try go get the page to extract the title (otherwise we will to straight to the edit form.) if (empty($title) && parse_url($url,PHP_URL_SCHEME)=='http') @@ -131,10 +130,10 @@ index 6fae2f8..53f798e 100644 - + // If found, extract encoding. - if (!empty($meta[0]))[](.html) + if (!empty($meta[0])) { @@ -1577,7 +1595,7 @@ function renderPage() - $html_charset = (!empty($enc[1])) ? strtolower($enc[1]) : 'utf-8';[](.html) + $html_charset = (!empty($enc[1])) ? strtolower($enc[1]) : 'utf-8'; } else { $html_charset = 'utf-8'; } - @@ -152,13 +151,13 @@ index 6fae2f8..53f798e 100644 $PAGE = new pageBuilder; @@ -1842,6 +1860,9 @@ function buildLinkList($PAGE,$LINKSDB) - $taglist = explode(' ',$link['tags']);[](.html) + $taglist = explode(' ',$link['tags']); uasort($taglist, 'strcasecmp'); - $link['taglist']=$taglist;[](.html) -+ if(!empty($link['via'])){[](.html) -+ $link['via']=htmlspecialchars($link['via']);[](.html) + $link['taglist']=$taglist; ++ if(!empty($link['via'])){ ++ $link['via']=htmlspecialchars($link['via']); + } - $linkDisp[$keys[$i[ = $link;](-=-$link;.html) + $linkDisp[$keys[$i]] = $link; $i++; } diff --git a/tpl/editlink.html b/tpl/editlink.html @@ -170,7 +169,7 @@ index 4a2c30c..14d4f9c 100644 Description

    Tags

    + Origine

    - {if condition="($link_is_new && $GLOBALS['privateLinkByDefault']==true) || $link.private == true"}[](.html) + {if condition="($link_is_new && $GLOBALS['privateLinkByDefault']==true) || $link.private == true"}  
    diff --git a/tpl/linklist.html b/tpl/linklist.html @@ -182,9 +181,9 @@ index ddc38cb..0a8475f 100644
    {if="$value.description"}
    {$value.description}
    {/if} + {if condition="isset($value.via) && !empty($value.via)"}{/if} - {if="!$GLOBALS['config'['HIDE_TIMESTAMPS'] || isLoggedIn()"}]('HIDE_TIMESTAMPS']-||-isLoggedIn()"}.html) + {if="!$GLOBALS['config']['HIDE_TIMESTAMPS'] || isLoggedIn()"} {$value.localdate|htmlspecialchars} - permalink - {else} -- 2.1.1 -``` +``` \ No newline at end of file diff --git a/doc/FAQ.md b/doc/md/FAQ.md similarity index 89% rename from doc/FAQ.md rename to doc/md/FAQ.md index 4c69763f..151dcef5 100644 --- a/doc/FAQ.md +++ b/doc/md/FAQ.md @@ -1,7 +1,6 @@ -#FAQ ### Why did you create Shaarli ? -I was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And… oh… **their Firefox addon sends to Diigo every single URL you visit** (Don't believe me ? Use [Tamper Data](https://addons.mozilla.org/en-US/firefox/addon/tamper-data/) and open any page).[](.html) +I was a StumbleUpon user. Then I got fed up with they big toolbar. I switched to delicious, which was lighter, faster and more beautiful. Until Yahoo bought it. Then the export API broke all the time, delicious became slow and was ditched by Yahoo. I switched to Diigo, which is not bad, but does too much. And Diigo is sslllooooowww and their Firefox extension a bit buggy. And… oh… **their Firefox addon sends to Diigo every single URL you visit** (Don't believe me ? Use [Tamper Data](https://addons.mozilla.org/en-US/firefox/addon/tamper-data/) and open any page). Enough is enough. Saving simple links should not be a complicated heavy thing. I ditched them all and wrote my own: Shaarli. It's simple, but it does the job and does it well. And my data is not hosted on a foreign server, but on my server. @@ -23,21 +22,21 @@ With Shaarli: Shaarli is for shaaring your links. ### My Shaarli is broken! -First of all, ensure that both the [web server](Server-configuration) and [Shaarli](Shaarli-configuration) are correctly configured, and that your installation is [supported](Server-requirements).[](.html) +First of all, ensure that both the [web server](Server-configuration) and [Shaarli](Shaarli-configuration) are correctly configured, and that your installation is [supported](Server-requirements). If everything looks right but the issue(s) remain(s), please: -- take a look at the [troubleshooting](Troubleshooting) section[](.html) -- come [chat with us](https://gitter.im/shaarli/Shaarli) on Gitter, we'll be happy to help ;-)[](.html) -- browse active [issues](https://github.com/shaarli/Shaarli/issues) and [Pull Requests](https://github.com/shaarli/Shaarli/pulls)[](.html) +- take a look at the [troubleshooting](Troubleshooting) section +- come [chat with us](https://gitter.im/shaarli/Shaarli) on Gitter, we'll be happy to help ;-) +- browse active [issues](https://github.com/shaarli/Shaarli/issues) and [Pull Requests](https://github.com/shaarli/Shaarli/pulls) - if you find one that is related to the issue, feel free to comment and provide additional details (host/Shaarli setup) - - else, [open a new issue](https://github.com/shaarli/Shaarli/issues/new), and provide information about the problem:[](.html) + - else, [open a new issue](https://github.com/shaarli/Shaarli/issues/new), and provide information about the problem: - _what happens?_ - display glitches, invalid data, security flaws... - _what is your configuration?_ - OS, server version, activated extensions, web browser... - _is it reproducible?_ ### Why not use a real database? Files are slow! -Does browsing [this page](http://sebsauvage.net/links/) feel slow? Try browsing older pages, too.[](.html) +Does browsing [this page](http://sebsauvage.net/links/) feel slow? Try browsing older pages, too. It's not slow at all, is it? And don't forget the database contains more than 16000 links, and it's on a shared host, with 32000 visitors/day for my website alone. And it's still damn fast. Why? diff --git a/doc/Usage.md b/doc/md/Features.md similarity index 96% rename from doc/Usage.md rename to doc/md/Features.md index 30ad1466..116b1c9c 100644 --- a/doc/Usage.md +++ b/doc/md/Features.md @@ -1,4 +1,3 @@ -#Usage ### Main features Shaarli is intended: * to share, comment and save interesting links and news @@ -13,7 +12,7 @@ Shaarli is intended: * to store playlists (e.g. with the `music` or `video` tags) * to keep extracts/comments from webpages that may disappear * to keep track of ongoing discussions (for example items tagged `discussion`) - * [to feed RSS aggregators](http://shaarli.chassegnouf.net/?9Efeiw) (planets) with specific tags[](.html) + * [to feed RSS aggregators](http://shaarli.chassegnouf.net/?9Efeiw) (planets) with specific tags * to feed other social networks, blogs... using RSS feeds and external services (dlvr.it, ifttt.com ...) ### Using Shaarli as a blog, notepad, pastebin... diff --git a/doc/Firefox-share.md b/doc/md/Firefox-share.md similarity index 86% rename from doc/Firefox-share.md rename to doc/md/Firefox-share.md index 58adc58f..9ba57b04 100644 --- a/doc/Firefox-share.md +++ b/doc/md/Firefox-share.md @@ -1,4 +1,3 @@ -#Firefox share ### Add Shaarli as a sharing service to Firefox * Open your Shaarli and `Login` @@ -9,7 +8,7 @@ ### Sharing links using Firefox share * Add the sharing service as described above - * When you are visiting a webpage you would like to share with Shaarli, click the Firefox _Share_ button [images/firefoxshare.png](images/firefoxshare.png.html) + * When you are visiting a webpage you would like to share with Shaarli, click the Firefox _Share_ button [[images/firefoxshare.png]] * You can edit your link before and after saving, just like the bookmarklet above. |  | Your Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections. | diff --git a/doc/GnuPG-signature.md b/doc/md/GnuPG-signature.md similarity index 87% rename from doc/GnuPG-signature.md rename to doc/md/GnuPG-signature.md index b0028d55..1fb3b42f 100644 --- a/doc/GnuPG-signature.md +++ b/doc/md/GnuPG-signature.md @@ -1,27 +1,26 @@ -#GnuPG signature ## Introduction ### PGP and GPG -[Gnu Privacy Guard](https://gnupg.org/) (GnuPG) is an Open Source implementation of the [Pretty Good [](.html) +[Gnu Privacy Guard](https://gnupg.org/) (GnuPG) is an Open Source implementation of the [Pretty Good Privacy](https://en.wikipedia.org/wiki/Pretty_Good_Privacy#OpenPGP) (OpenPGP) specification. Its main purposes are digital authentication, signature and encryption. -It is often used by the [FLOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) community to verify:[](.html) -- Linux package signatures: Debian [SecureApt](https://wiki.debian.org/SecureApt), ArchLinux [Master [](.html) +It is often used by the [FLOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) community to verify: +- Linux package signatures: Debian [SecureApt](https://wiki.debian.org/SecureApt), ArchLinux [Master Keys](https://www.archlinux.org/master-keys/) -- [SCM](https://en.wikipedia.org/wiki/Revision_control) releases & maintainer identity[](.html) +- [SCM](https://en.wikipedia.org/wiki/Revision_control) releases & maintainer identity ### Trust -To quote Phil Pennock (the author of the [SKS](https://bitbucket.org/skskeyserver/sks-keyserver/wiki/Home) key server - http://sks.spodhuis.org/):[](.html) +To quote Phil Pennock (the author of the [SKS](https://bitbucket.org/skskeyserver/sks-keyserver/wiki/Home) key server - http://sks.spodhuis.org/): > You MUST understand that presence of data in the keyserver (pools) in no way connotes trust. Anyone can generate a key, with any name or email address, and upload it. All security and trust comes from evaluating security at the “object level”, via PGP Web-Of-Trust signatures. This keyserver makes it possible to retrieve keys, looking them up via various indices, but the collection of keys in this public pool is KNOWN to contain malicious and fraudulent keys. It is the common expectation of server operators that users understand this and use software which, like all known common OpenPGP implementations, evaluates trust accordingly. This expectation is so common that it is not normally explicitly stated. -Trust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during [key signing parties](https://en.wikipedia.org/wiki/Key_signing_party), see:[](.html) -- [The Keysigning party HOWTO](http://www.cryptnet.net/fdp/crypto/keysigning_party/en/keysigning_party.html)[](.html) -- [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust)[](.html) +Trust can be gained by having your key signed by other people (and signing their key back, too :) ), for instance during [key signing parties](https://en.wikipedia.org/wiki/Key_signing_party), see: +- [The Keysigning party HOWTO](http://www.cryptnet.net/fdp/crypto/keysigning_party/en/keysigning_party.html) +- [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust) ## Generate a GPG key -- [Generating a GPG key for Git tagging](http://stackoverflow.com/a/16725717) (StackOverflow)[](.html) -- [Generating a GPG key](https://help.github.com/articles/generating-a-gpg-key/) (GitHub)[](.html) +- [Generating a GPG key for Git tagging](http://stackoverflow.com/a/16725717) (StackOverflow) +- [Generating a GPG key](https://help.github.com/articles/generating-a-gpg-key/) (GitHub) ### gpg - provide identity information ```bash @@ -62,7 +61,7 @@ gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model gpg: depth: 0 valid: 2 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 2u pub rsa2048/A9D53A3E 2015-07-31 Key fingerprint = AF2A 5381 E54B 2FD2 14C4 A9A3 0E35 ACA4 A9D5 3A3E -uid [ultimate] Marvin the Paranoid Android [](.html) +uid [ultimate] Marvin the Paranoid Android sub rsa2048/8C0EACF1 2015-07-31 ``` @@ -74,4 +73,4 @@ gpg: sending key A9D53A3E to hkp server pgp.mit.edu ## Create and push a GPG-signed tag -See [Release Shaarli](Release-Shaarli.html). +See [[Release Shaarli]]. diff --git a/doc/Plugin-System.md b/doc/md/Plugin-System.md similarity index 88% rename from doc/Plugin-System.md rename to doc/md/Plugin-System.md index addd792d..d55ffe7e 100644 --- a/doc/Plugin-System.md +++ b/doc/md/Plugin-System.md @@ -1,7 +1,6 @@ -#Plugin System -[**I am a developer.** Developer API.](#developer-api)[](.html) +[**I am a developer.** Developer API.](#developer-api) -[**I am a template designer.** Guide for template designer.](#guide-for-template-designer)[](.html) +[**I am a template designer.** Guide for template designer.](#guide-for-template-designer) ## Developer API @@ -48,7 +47,7 @@ hook__($data, $conf) Parameters: - - data: see [$data section](https://github.com/shaarli/Shaarli/wiki/Plugin-System#plugins-data)[](.html) + - data: see [$data section](https://github.com/shaarli/Shaarli/wiki/Plugin-System#plugins-data) - conf: the `ConfigManager` instance. For exemple, if my plugin want to add data to the header, this function is needed: @@ -76,9 +75,9 @@ RainTPL displays every element contained in the placeholder's array. These eleme For example, let's add a value in the placeholder `top_placeholder` which is displayed at the top of my page: ```php -$data['top_placeholder'[] = 'My content';](]-=-'My-content';.html) +$data['top_placeholder'][] = 'My content'; # OR -array_push($data['top_placeholder'], 'My', 'content');[](.html) +array_push($data['top_placeholder'], 'My', 'content'); return $data; ``` @@ -93,9 +92,9 @@ For exemple, in linklist, it is possible to alter every title: ```php // mind the reference if you want $data to be altered -foreach ($data['links'] as &$value) {[](.html) +foreach ($data['links'] as &$value) { // String reverse every title. - $value['title'] = strrev($value['title']);[](.html) + $value['title'] = strrev($value['title']); } return $data; @@ -117,25 +116,25 @@ Each file contain two keys: Use `demo_plugin` as a functional example. It covers most of the plugin system features. -If it's still not working, please [open an issue](https://github.com/shaarli/Shaarli/issues/new).[](.html) +If it's still not working, please [open an issue](https://github.com/shaarli/Shaarli/issues/new). ### Hooks | Hooks | Description | | ------------- |:-------------:| -| [render_header](#render_header) | Allow plugin to add content in page headers. |[](.html) -| [render_includes](#render_includes) | Allow plugin to include their own CSS files. |[](.html) -| [render_footer](#render_footer) | Allow plugin to add content in page footer and include their own JS files. | [](.html) -| [render_linklist](#render_linklist) | It allows to add content at the begining and end of the page, after every link displayed and to alter link data. |[](.html) -| [render_editlink](#render_editlink) | Allow to add fields in the form, or display elements. |[](.html) -| [render_tools](#render_tools) | Allow to add content at the end of the page. |[](.html) -| [render_picwall](#render_picwall) | Allow to add content at the top and bottom of the page. |[](.html) -| [render_tagcloud](#render_tagcloud) | Allow to add content at the top and bottom of the page, and after all tags. |[](.html) -| [render_taglist](#render_taglist) | Allow to add content at the top and bottom of the page, and after all tags. |[](.html) -| [render_daily](#render_daily) | Allow to add content at the top and bottom of the page, the bottom of each link and to alter data. |[](.html) -| [render_feed](#render_feed) | Allow to do add tags in RSS and ATOM feeds. |[](.html) -| [save_link](#save_link) | Allow to alter the link being saved in the datastore. |[](.html) -| [delete_link](#delete_link) | Allow to do an action before a link is deleted from the datastore. |[](.html) +| [render_header](#render_header) | Allow plugin to add content in page headers. | +| [render_includes](#render_includes) | Allow plugin to include their own CSS files. | +| [render_footer](#render_footer) | Allow plugin to add content in page footer and include their own JS files. | +| [render_linklist](#render_linklist) | It allows to add content at the begining and end of the page, after every link displayed and to alter link data. | +| [render_editlink](#render_editlink) | Allow to add fields in the form, or display elements. | +| [render_tools](#render_tools) | Allow to add content at the end of the page. | +| [render_picwall](#render_picwall) | Allow to add content at the top and bottom of the page. | +| [render_tagcloud](#render_tagcloud) | Allow to add content at the top and bottom of the page, and after all tags. | +| [render_taglist](#render_taglist) | Allow to add content at the top and bottom of the page, and after all tags. | +| [render_daily](#render_daily) | Allow to add content at the top and bottom of the page, the bottom of each link and to alter data. | +| [render_feed](#render_feed) | Allow to do add tags in RSS and ATOM feeds. | +| [save_link](#save_link) | Allow to alter the link being saved in the datastore. | +| [delete_link](#delete_link) | Allow to do an action before a link is deleted from the datastore. | @@ -154,19 +153,19 @@ Allow plugin to add content in page headers. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `buttons_toolbar`: after the list of buttons in the header. -![buttons_toolbar_example](http://i.imgur.com/ssJUOrt.png)[](.html) +![buttons_toolbar_example](http://i.imgur.com/ssJUOrt.png) * `fields_toolbar`: after search fields in the header. > Note: This will only be called in linklist. -![fields_toolbar_example](http://i.imgur.com/3GMifI2.png)[](.html) +![fields_toolbar_example](http://i.imgur.com/3GMifI2.png) #### render_includes @@ -183,7 +182,7 @@ Allow plugin to include their own CSS files. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: @@ -206,14 +205,14 @@ Allow plugin to add content in page footer and include their own JS files. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `text`: called after the end of the footer text. * `endofpage`: called at the end of the page. -![text_example](http://i.imgur.com/L5S2YEH.png)[](.html) +![text_example](http://i.imgur.com/L5S2YEH.png) * `js_files`: called at the end of the page, to include custom JS scripts. @@ -234,25 +233,25 @@ It allows to add content at the begining and end of the page, after every link d ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `action_plugin`: next to the button "private only" at the top and bottom of the page. -![action_plugin_example](http://i.imgur.com/Q12PWg0.png)[](.html) +![action_plugin_example](http://i.imgur.com/Q12PWg0.png) * `link_plugin`: for every link, between permalink and link URL. -![link_plugin_example](http://i.imgur.com/3oDPhWx.png)[](.html) +![link_plugin_example](http://i.imgur.com/3oDPhWx.png) * `plugin_start_zone`: before displaying the template content. -![plugin_start_zone_example](http://i.imgur.com/OVBkGy3.png)[](.html) +![plugin_start_zone_example](http://i.imgur.com/OVBkGy3.png) * `plugin_end_zone`: after displaying the template content. -![plugin_end_zone_example](http://i.imgur.com/6IoRuop.png)[](.html) +![plugin_end_zone_example](http://i.imgur.com/6IoRuop.png) #### render_editlink @@ -268,13 +267,13 @@ Allow to add fields in the form, or display elements. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `edit_link_plugin`: after tags field. -![edit_link_plugin_example](http://i.imgur.com/5u17Ens.png)[](.html) +![edit_link_plugin_example](http://i.imgur.com/5u17Ens.png) #### render_tools @@ -290,13 +289,13 @@ Allow to add content at the end of the page. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `tools_plugin`: at the end of the page. -![tools_plugin_example](http://i.imgur.com/Bqhu9oQ.png)[](.html) +![tools_plugin_example](http://i.imgur.com/Bqhu9oQ.png) #### render_picwall @@ -313,7 +312,7 @@ Allow to add content at the top and bottom of the page. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: @@ -321,7 +320,7 @@ List of placeholders: * `plugin_end_zone`: after displaying the template content. -![plugin_start_end_zone_example](http://i.imgur.com/tVTQFER.png)[](.html) +![plugin_start_end_zone_example](http://i.imgur.com/tVTQFER.png) #### render_tagcloud @@ -338,7 +337,7 @@ Allow to add content at the top and bottom of the page. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: @@ -350,7 +349,7 @@ For each tag, the following placeholder can be used: * `tag_plugin`: after each tag -![plugin_start_end_zone_example](http://i.imgur.com/vHmyT3a.png)[](.html) +![plugin_start_end_zone_example](http://i.imgur.com/vHmyT3a.png) #### render_taglist @@ -368,7 +367,7 @@ Allow to add content at the top and bottom of the page. ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: @@ -395,13 +394,13 @@ Allow to add content at the top and bottom of the page, the bottom of each link ##### Template placeholders -Items can be displayed in templates by adding an entry in `$data['']` array.[](.html) +Items can be displayed in templates by adding an entry in `$data['']` array. List of placeholders: * `link_plugin`: used at bottom of each link. -![link_plugin_example](http://i.imgur.com/hzhMfSZ.png)[](.html) +![link_plugin_example](http://i.imgur.com/hzhMfSZ.png) * `plugin_start_zone`: before displaying the template content. @@ -423,7 +422,7 @@ Allow to add tags in the feed, either in the header or for each items. Items (li ##### Template placeholders -Tags can be added in feeds by adding an entry in `$data['']` array.[](.html) +Tags can be added in feeds by adding an entry in `$data['']` array. List of placeholders: diff --git a/doc/Plugins.md b/doc/md/Plugins.md similarity index 86% rename from doc/Plugins.md rename to doc/md/Plugins.md index e3192a60..b52b8090 100644 --- a/doc/Plugins.md +++ b/doc/md/Plugins.md @@ -1,4 +1,3 @@ -#Plugins ## Plugin installation There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them. @@ -26,7 +25,7 @@ In Shaarli's administration page (`Tools` link), go to `Plugin administration`. Here you can enable and disable all plugins available, and configure them. -![administration screenshot](https://camo.githubusercontent.com/5da68e191969007492ca0fbeb25f3b2357b748cc/687474703a2f2f692e696d6775722e636f6d2f766837544643712e706e67)[](.html) +![administration screenshot](https://camo.githubusercontent.com/5da68e191969007492ca0fbeb25f3b2357b748cc/687474703a2f2f692e696d6775722e636f6d2f766837544643712e706e67) ## Plugin order @@ -41,14 +40,14 @@ This is important in case plugins are depending on each other. Read plugins READ Enabled plugin are stored in your `config.php` parameters file, under the `array`: ```php -$GLOBALS['config'['ENABLED_PLUGINS']]('ENABLED_PLUGINS'].html) +$GLOBALS['config']['ENABLED_PLUGINS'] ``` You can edit them manually here. Example: ```php -$GLOBALS['config'['ENABLED_PLUGINS'] = array(]('ENABLED_PLUGINS']-=-array(.html) +$GLOBALS['config']['ENABLED_PLUGINS'] = array( 'qrcode', 'archiveorg', 'wallabag', @@ -64,13 +63,13 @@ Usage of each plugin is documented in it's README file: * `addlink-toolbar`: Adds the addlink input on the linklist page * `archiveorg`: For each link, add an Archive.org icon - * [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax.[](.html) - * [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos.[](.html) + * [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax. + * [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos. * `qrcode`: For each link, add a QRCode icon. - * [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each link, add a Wallabag icon to save it in your instance.[](.html) + * [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each link, add a Wallabag icon to save it in your instance. #### Third party plugins -See [Community & related software](https://github.com/shaarli/Shaarli/wiki/Community-%26-Related-software#third-party-plugins)[](.html) +See [Community & related software](https://github.com/shaarli/Shaarli/wiki/Community-%26-Related-software#third-party-plugins) diff --git a/doc/md/REST-API.md b/doc/md/REST-API.md new file mode 100644 index 00000000..8f3f7303 --- /dev/null +++ b/doc/md/REST-API.md @@ -0,0 +1,104 @@ +## Usage + +See the [REST API documentation](http://shaarli.github.io/api-documentation/). + +## Authentication + +All requests to Shaarli's API must include a JWT token to verify their authenticity. + +This token has to be included as an HTTP header called `Authentication: Bearer `. + +JWT resources : + + * [jwt.io](https://jwt.io) (including a list of client per language). + * RFC : https://tools.ietf.org/html/rfc7519 + * https://float-middle.com/json-web-tokens-jwt-vs-sessions/ + * HackerNews thread: https://news.ycombinator.com/item?id=11929267 + + +### Shaarli JWT Token + +JWT tokens are composed by three parts, separated by a dot `.` and encoded in base64: + +``` +[header].[payload].[signature] +``` + +#### Header + +Shaarli only allow one hash algorithm, so the header will always be the same: + +```json +{ + "typ": "JWT", + "alg": "HS512" +} +``` + +Encoded in base64, it gives: + +``` +ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ== +``` + +#### Payload + +**Validity duration** + +To avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key `iat` (issued at). This token will be accepted during 9 minutes. + +```json +{ + "iat": 1468663519 +} +``` + +See [RFC reference](https://tools.ietf.org/html/rfc7519#section-4.1.6). + + +#### Signature + +The signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot `.`, hashed in SHA512 with the API secret available in Shaarli administration page. + +Signature example with PHP: + +```php +$content = base64_encode($header) . '.' . base64_encode($payload); +$signature = hash_hmac('sha512', $content, $secret); +``` + + +### Complete example + +#### PHP + +```php +function generateToken($secret) { + $header = base64_encode('{ + "typ": "JWT", + "alg": "HS512" + }'); + $payload = base64_encode('{ + "iat": '. time() .' + }'); + $signature = hash_hmac('sha512', $header .'.'. $payload , $secret); + return $header .'.'. $payload .'.'. $signature; +} + +$secret = 'mysecret'; +$token = generateToken($secret); +echo $token; +``` + +> `ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68` + +```php +$options = [ + 'http' => [ + 'method' => 'GET', + 'jwt' => $token, + ], +]; +$context = stream_context_create($options); +file_get_contents($apiEndpoint, false, $context); +``` diff --git a/doc/RSS-feeds.md b/doc/md/RSS-feeds.md similarity index 93% rename from doc/RSS-feeds.md rename to doc/md/RSS-feeds.md index 757bed9a..9d718172 100644 --- a/doc/RSS-feeds.md +++ b/doc/md/RSS-feeds.md @@ -1,4 +1,3 @@ -#RSS feeds ### Feeds options Feeds are available in ATOM with `?do=atom` and RSS with `do=RSS`. @@ -24,4 +23,4 @@ For example, if you want to subscribe only to links tagged `photography`: - `https://my.shaarli.domain/?do=rss&searchtags=nature` - `https://my.shaarli.domain/links/?do=picwall&searchterm=poney` -![(images/rss-filter-1.png) !]((images/rss-filter-1.png)-!.html)(images/rss-filter-2.png) +![](images/rss-filter-1.png) ![](images/rss-filter-2.png) diff --git a/doc/Release-Shaarli.md b/doc/md/Release-Shaarli.md similarity index 74% rename from doc/Release-Shaarli.md rename to doc/md/Release-Shaarli.md index ced58853..cce5e209 100644 --- a/doc/Release-Shaarli.md +++ b/doc/md/Release-Shaarli.md @@ -1,5 +1,4 @@ -#Release Shaarli -See [Git - Maintaining a project - Tagging your [](.html) +See [Git - Maintaining a project - Tagging your releases](http://git-scm.com/book/en/v2/Distributed-Git-Maintaining-a-Project#Tagging-Your-Releases). ## Prerequisites @@ -13,13 +12,13 @@ This guide assumes that you have: - maintainer permissions on the main Shaarli repository, to: - push the signed tag - create a new release -- [Composer](https://getcomposer.org/) and [Pandoc](http://pandoc.org/) need to be installed[](.html) +- [Composer](https://getcomposer.org/) and [Pandoc](http://pandoc.org/) need to be installed ## GitHub release draft and `CHANGELOG.md` See http://keepachangelog.com/en/0.3.0/ for changelog formatting. ### GitHub release draft -GitHub allows drafting the release note for the upcoming release, from the [Releases](https://github.com/shaarli/Shaarli/releases) page. This way, the release note can be drafted while contributions are merged to `master`.[](.html) +GitHub allows drafting the release note for the upcoming release, from the [Releases](https://github.com/shaarli/Shaarli/releases) page. This way, the release note can be drafted while contributions are merged to `master`. ### `CHANGELOG.md` This file should contain the same information as the release note draft for the upcoming version. @@ -34,17 +33,17 @@ $ cd /path/to/shaarli $ nano CHANGELOG.md -[...][](.html) +[...] ## vA.B.C - UNRELEASED TBA -## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD[](.html) -[...][](.html) +## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD +[...] ``` -## Increment the version code, create and push a signed tag -### Bump Shaarli's version +## Increment the version code, updated docs, create and push a signed tag +### Generate documentation ```bash $ cd /path/to/shaarli @@ -52,15 +51,12 @@ $ cd /path/to/shaarli $ git fetch upstream $ git checkout upstream/master -b v0.5.0 -# bump the version number -$ vim index.php shaarli_version.php - # rebuild the documentation from the wiki $ make htmldoc # commit the changes -$ git add index.php shaarli_version.php doc -$ git commit -s -m "Bump version to v0.5.0" +$ git add doc +$ git commit -s -m "Generate documentation for v0.5.0" # push the commit on your GitHub fork $ git push origin v0.5.0 @@ -69,13 +65,33 @@ $ git push origin v0.5.0 ### Create and merge a Pull Request This one is pretty straightforward ;-) -### Create and push a signed tag -```bash -# update your local copy +### Bump Shaarli version to v0.x branch + +``` $ git checkout master $ git fetch upstream $ git pull upstream master +# IF the branch doesn't exists +$ git checkout -b v0.5 +# OR if the branch already exists +$ git checkout v0.5 +$ git rebase upstream/master + +# Bump shaarli version from dev to 0.5.0, **without the `v`** +$ vim shaarli_version.php +$ git add shaarli_version +$ git commit -s -m "Bump Shaarli version to v0.5.0" +$ git push upstream v0.5 +``` + +### Create and push a signed tag +```bash +# update your local copy +$ git checkout v0.5 +$ git fetch upstream +$ git pull upstream v0.5 + # create a signed tag $ git tag -s -m "Release v0.5.0" v0.5.0 @@ -84,7 +100,7 @@ $ git push --tags upstream ``` ### Verify a signed tag -[`v0.5.0`](https://github.com/shaarli/Shaarli/releases/tag/v0.5.0) is the first GPG-signed tag pushed on the Community Shaarli.[](.html) +[`v0.5.0`](https://github.com/shaarli/Shaarli/releases/tag/v0.5.0) is the first GPG-signed tag pushed on the Community Shaarli. Let's have a look at its signature! @@ -99,12 +115,12 @@ f7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0 # verify the tag signature information $ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1 gpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F -gpg: Good signature from "VirtualTam " [ultimate][](.html) +gpg: Good signature from "VirtualTam " [ultimate] ``` ## Publish the GitHub release ### Update release badges -Update `README.md` so version badges display and point to the newly released Shaarli version(s). +Update `README.md` so version badges display and point to the newly released Shaarli version(s), in the `master` branch. ### Create a GitHub release from a Git tag From the previously drafted release: @@ -120,7 +136,9 @@ Users with a shared hosting may have: - no possibility to run scripts To ease Shaarli installations, it is possible to generate and upload additional release archives, -that will contain Shaarli code plus all required third-party libraries: +that will contain Shaarli code plus all required third-party libraries. + +**From the `v0.5` branch:** ```bash $ make release_archive @@ -131,3 +149,20 @@ This will create the following archives: - `shaarli-vX.Y.Z-full.zip` The archives need to be manually uploaded on the previously created GitHub release. + +### Update `stable` and `latest` branches + +``` +$ git checkout latest +# latest release +$ git merge v0.5.0 +# fix eventual conflicts +$ make test +$ git push upstream latest +$ git checkout stable +# latest previous major +$ git merge v0.4.5 +# fix eventual conflicts +$ make test +$ git push upstream stable +``` diff --git a/doc/md/Reverse-proxy-configuration.md b/doc/md/Reverse-proxy-configuration.md new file mode 100644 index 00000000..91ffecff --- /dev/null +++ b/doc/md/Reverse-proxy-configuration.md @@ -0,0 +1,6 @@ + +TODO, see https://github.com/shaarli/Shaarli/issues/888 + +## HAProxy + +## Nginx diff --git a/doc/Security.md b/doc/md/Security.md similarity index 99% rename from doc/Security.md rename to doc/md/Security.md index 7947460c..aec37fa0 100644 --- a/doc/Security.md +++ b/doc/md/Security.md @@ -1,4 +1,3 @@ -#Security ## Client browser * Shaarli relies on `HTTP_REFERER` for some functions (like redirects and clicking on tags). If you have disabled or masqueraded `HTTP_REFERER` in your browser, some features of Shaarli may not work diff --git a/doc/Server-configuration.md b/doc/md/Server-configuration.md similarity index 92% rename from doc/Server-configuration.md rename to doc/md/Server-configuration.md index 81cc1a72..23fdbc8b 100644 --- a/doc/Server-configuration.md +++ b/doc/md/Server-configuration.md @@ -1,8 +1,7 @@ -#Server configuration *Example virtual host configurations for popular web servers* -- [Apache](#apache)[](.html) -- [Nginx](#nginx)[](.html) +- [Apache](#apache) +- [Nginx](#nginx) ## Prerequisites ### Shaarli @@ -14,8 +13,8 @@ ### HTTPS, TLS and self-signed certificates Related guides: -* [How to Create Self-Signed SSL Certificates with OpenSSL](http://www.xenocafe.com/tutorials/linux/centos/openssl/self_signed_certificates/index.php)[](.html) -* [How do I create my own Certificate Authority?](https://workaround.org/certificate-authority)[](.html) +* [How to Create Self-Signed SSL Certificates with OpenSSL](http://www.xenocafe.com/tutorials/linux/centos/openssl/self_signed_certificates/index.php) +* [How do I create my own Certificate Authority?](https://workaround.org/certificate-authority) * Generate a self-signed certificate (will trigger browser warnings) with apache2: `make-ssl-cert generate-default-snakeoil --force-overwrite` will create `/etc/ssl/certs/ssl-cert-snakeoil.pem` and `/etc/ssl/private/ssl-cert-snakeoil.key` ### Proxies @@ -24,7 +23,7 @@ If Shaarli is served behind a proxy (i.e. there is a proxy server between client - `X-Forwarded-Host`; - `X-Forwarded-For`. -See also [proxy-related](https://github.com/shaarli/Shaarli/issues?utf8=%E2%9C%93&q=label%3Aproxy+) issues.[](.html) +See also [proxy-related](https://github.com/shaarli/Shaarli/issues?utf8=%E2%9C%93&q=label%3Aproxy+) issues. ## Apache ### Minimal @@ -38,8 +37,8 @@ See also [proxy-related](https://github.com/shaarli/Shaarli/issues?utf8=%E2%9C%9 This configuration will log both Apache and PHP errors, which may prove useful to identify server configuration errors. See: -* [Apache/PHP - error log per VirtualHost](http://stackoverflow.com/q/176) (StackOverflow)[](.html) -* [PHP: php_value vs php_admin_value and the use of php_flag explained](https://ma.ttias.be/php-php_value-vs-php_admin_value-and-the-use-of-php_flag-explained/)[](.html) +* [Apache/PHP - error log per VirtualHost](http://stackoverflow.com/q/176) (StackOverflow) +* [PHP: php_value vs php_admin_value and the use of php_flag explained](https://ma.ttias.be/php-php_value-vs-php_admin_value-and-the-use-of-php_flag-explained/) ```apache @@ -70,7 +69,7 @@ See: ``` ### Paranoid - Redirect HTTP (:80) to HTTPS (:443) -See [Server-side TLS](https://wiki.mozilla.org/Security/Server_Side_TLS#Apache) (Mozilla).[](.html) +See [Server-side TLS](https://wiki.mozilla.org/Security/Server_Side_TLS#Apache) (Mozilla). ```apache @@ -106,7 +105,7 @@ See [Server-side TLS](https://wiki.mozilla.org/Security/Server_Side_TLS#Apache) Shaarli use `.htaccess` Apache files to deny access to files that shouldn't be directly accessed (datastore, config, etc.). You need the directive `AllowOverride All` in your virtual host configuration for them to work. -**Warning**: If you use Apache 2.2 or lower, you need [mod_version](https://httpd.apache.org/docs/current/mod/mod_version.html) to be installed and enabled.[](.html) +**Warning**: If you use Apache 2.2 or lower, you need [mod_version](https://httpd.apache.org/docs/current/mod/mod_version.html) to be installed and enabled. Apache module `mod_rewrite` **must** be enabled to use the REST API. URL rewriting rules for the Slim microframework are stated in the root `.htaccess` file. @@ -114,20 +113,20 @@ Apache module `mod_rewrite` **must** be enabled to use the REST API. URL rewriti ## Nginx ### Foreword -Nginx does not natively interpret PHP scripts; to this effect, we will run a [FastCGI](https://en.wikipedia.org/wiki/FastCGI) service, to which Nginx's FastCGI module will proxy all requests to PHP resources.[](.html) +Nginx does not natively interpret PHP scripts; to this effect, we will run a [FastCGI](https://en.wikipedia.org/wiki/FastCGI) service, to which Nginx's FastCGI module will proxy all requests to PHP resources. Required packages: -- [nginx](http://nginx.org)[](.html) -- [php-fpm](http://php-fpm.org) - PHP FastCGI Process Manager[](.html) +- [nginx](http://nginx.org) +- [php-fpm](http://php-fpm.org) - PHP FastCGI Process Manager Official documentation: -- [Beginner's guide](http://nginx.org/en/docs/beginners_guide.html)[](.html) -- [ngx_http_fastcgi_module](http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html)[](.html) -- [Pitfalls](http://wiki.nginx.org/Pitfalls)[](.html) +- [Beginner's guide](http://nginx.org/en/docs/beginners_guide.html) +- [ngx_http_fastcgi_module](http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html) +- [Pitfalls](http://wiki.nginx.org/Pitfalls) Community resources: -- [Server-side TLS (Nginx)](https://wiki.mozilla.org/Security/Server_Side_TLS#Nginx) (Mozilla)[](.html) -- [PHP configuration examples](http://kbeezie.com/nginx-configuration-examples/) (Karl Blessing)[](.html) +- [Server-side TLS (Nginx)](https://wiki.mozilla.org/Security/Server_Side_TLS#Nginx) (Mozilla) +- [PHP configuration examples](http://kbeezie.com/nginx-configuration-examples/) (Karl Blessing) ### Common setup Once Nginx and PHP-FPM are installed, we need to ensure: @@ -154,7 +153,7 @@ which corresponds to the following service configuration: user = john group = users -[...][](.html) +[...] listen.owner = john listen.group = users ``` @@ -164,7 +163,7 @@ listen.group = users user john users; http { - [...][](.html) + [...] } ``` @@ -177,20 +176,20 @@ To increase upload size, you will need to modify both nginx and PHP configuratio # /etc/nginx/nginx.conf http { - [...][](.html) + [...] client_max_body_size 10m; - [...][](.html) + [...] } ``` ```ini # /etc/php5/fpm/php.ini -[...][](.html) +[...] post_max_size = 10M -[...][](.html) +[...] upload_max_filesize = 10M ``` @@ -293,10 +292,10 @@ location ~* \.(?:ico|css|js|gif|jpe?g|png)$ { ```nginx # /etc/nginx/nginx.conf -[...][](.html) +[...] http { - [...][](.html) + [...] root /home/john/web; access_log /var/log/nginx/access.log; @@ -347,10 +346,10 @@ Assuming you have generated a (self-signed) key and certificate, and they are lo ```nginx # /etc/nginx/nginx.conf -[...][](.html) +[...] http { - [...][](.html) + [...] index index.html index.php; diff --git a/doc/Server-requirements.md b/doc/md/Server-requirements.md similarity index 73% rename from doc/Server-requirements.md rename to doc/md/Server-requirements.md index 07e70ab3..b6bbd66a 100644 --- a/doc/Server-requirements.md +++ b/doc/md/Server-requirements.md @@ -1,11 +1,11 @@ -#Server requirements ## PHP + ### Release information -- [PHP: Supported versions](http://php.net/supported-versions.php)[](.html) -- [PHP: Unsupported versions](http://php.net/eol.php) _(EOL - End Of Life)_[](.html) -- [PHP 7 Changelog](http://php.net/ChangeLog-7.php)[](.html) -- [PHP 5 Changelog](http://php.net/ChangeLog-5.php)[](.html) -- [PHP: Bugs](https://bugs.php.net/)[](.html) +- [PHP: Supported versions](http://php.net/supported-versions.php) +- [PHP: Unsupported versions](http://php.net/eol.php) _(EOL - End Of Life)_ +- [PHP 7 Changelog](http://php.net/ChangeLog-7.php) +- [PHP 5 Changelog](http://php.net/ChangeLog-5.php) +- [PHP: Bugs](https://bugs.php.net/) ### Supported versions Version | Status | Shaarli compatibility @@ -18,23 +18,23 @@ Version | Status | Shaarli compatibility 5.3 | EOL: 2014-08-14 | :white_check_mark: (up to Shaarli 0.8.x) See also: -- [Travis configuration](https://github.com/shaarli/Shaarli/blob/master/.travis.yml)[](.html) +- [Travis configuration](https://github.com/shaarli/Shaarli/blob/master/.travis.yml) ### Dependency management -Starting with Shaarli `v0.8.x`, [Composer](https://getcomposer.org/) is used to resolve,[](.html) +Starting with Shaarli `v0.8.x`, [Composer](https://getcomposer.org/) is used to resolve, download and install third-party PHP dependencies. Library | Required? | Usage ---|:---:|--- -[`shaarli/netscape-bookmark-parser`](https://packagist.org/packages/shaarli/netscape-bookmark-parser) | All | Import bookmarks from Netscape files[](.html) -[`erusev/parsedown`](https://packagist.org/packages/erusev/parsedown) | All | Parse MarkDown syntax for the MarkDown plugin[](.html) -[`slim/slim`](https://packagist.org/packages/slim/slim) | All | Handle routes and middleware for the REST API[](.html) +[`shaarli/netscape-bookmark-parser`](https://packagist.org/packages/shaarli/netscape-bookmark-parser) | All | Import bookmarks from Netscape files +[`erusev/parsedown`](https://packagist.org/packages/erusev/parsedown) | All | Parse MarkDown syntax for the MarkDown plugin +[`slim/slim`](https://packagist.org/packages/slim/slim) | All | Handle routes and middleware for the REST API ### Extensions Extension | Required? | Usage ---|:---:|--- -[`openssl`](http://php.net/manual/en/book.openssl.php) | All | OpenSSL, HTTPS[](.html) -[`php-mbstring`](http://php.net/manual/en/book.mbstring.php) | CentOS, Fedora, RHEL, Windows | multibyte (Unicode) string support[](.html) -[`php-gd`](http://php.net/manual/en/book.image.php) | optional | thumbnail resizing[](.html) -[`php-intl`](http://php.net/manual/en/book.intl.php) | optional | localized text sorting (e.g. `e->è->f`)[](.html) -[`php-curl`](http://php.net/manual/en/book.curl.php) | optional | using cURL for fetching webpages and thumbnails in a more robust way[](.html) +[`openssl`](http://php.net/manual/en/book.openssl.php) | All | OpenSSL, HTTPS +[`php-mbstring`](http://php.net/manual/en/book.mbstring.php) | CentOS, Fedora, RHEL, Windows | multibyte (Unicode) string support +[`php-gd`](http://php.net/manual/en/book.image.php) | optional | thumbnail resizing +[`php-intl`](http://php.net/manual/en/book.intl.php) | optional | localized text sorting (e.g. `e->è->f`) +[`php-curl`](http://php.net/manual/en/book.curl.php) | optional | using cURL for fetching webpages and thumbnails in a more robust way diff --git a/doc/Server-security.md b/doc/md/Server-security.md similarity index 93% rename from doc/Server-security.md rename to doc/md/Server-security.md index 50549a21..8df36f46 100644 --- a/doc/Server-security.md +++ b/doc/md/Server-security.md @@ -1,4 +1,3 @@ -#Server security ## php.ini PHP settings are defined in: - a main configuration file, usually found under `/etc/php5/php.ini`; some distributions provide different configuration environments, e.g. @@ -31,8 +30,8 @@ Additional .ini files parsed: /etc/php/conf.d/xdebug.ini ## fail2ban `fail2ban` is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses `iptables` profiles to block brute-force attempts: -- [Official website](http://www.fail2ban.org/wiki/index.php/Main_Page)[](.html) -- [Source code](https://github.com/fail2ban/fail2ban)[](.html) +- [Official website](http://www.fail2ban.org/wiki/index.php/Main_Page) +- [Source code](https://github.com/fail2ban/fail2ban) ### Read Shaarli logs to ban IPs Example configuration: @@ -41,7 +40,7 @@ Example configuration: `/etc/fail2ban/jail.local` ```ini -[shaarli-auth][](.html) +[shaarli-auth] enabled = true port = https,http filter = shaarli-auth @@ -52,9 +51,9 @@ bantime = -1 `/etc/fail2ban/filter.d/shaarli-auth.conf` ```ini -[INCLUDES][](.html) +[INCLUDES] before = common.conf -[Definition][](.html) +[Definition] failregex = \s-\s\s-\sLogin failed for user.*$ ignoreregex = ``` diff --git a/doc/Shaarli-configuration.md b/doc/md/Shaarli-configuration.md similarity index 90% rename from doc/Shaarli-configuration.md rename to doc/md/Shaarli-configuration.md index 25647cb7..933f5245 100644 --- a/doc/Shaarli-configuration.md +++ b/doc/md/Shaarli-configuration.md @@ -1,13 +1,10 @@ -#Shaarli configuration -# Shaarli configuration - ## Foreword **Do not edit configuration options in index.php! Your changes would be lost.** Once your Shaarli instance is installed, the file `data/config.json.php` is generated: * it contains all settings in JSON format, and can be edited to customize values -* it defines which [plugins](Plugin-System) are enabled[(.html)]((.html).html) +* it defines which [plugins](Plugin-System) are enabled[](.html) * its values override those defined in `index.php` * it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration @@ -33,13 +30,13 @@ On a Linux distribution: - to give it access to Shaarli, either: - unzip Shaarli in the default web server location (usually `/var/www/`) and set the web server user as the owner - put users in the same group as the web server, and set the appropriate access rights -- if you have a domain / subdomain to serve Shaarli, [configure the server](Server-configuration) accordingly[(.html)]((.html).html) +- if you have a domain / subdomain to serve Shaarli, [configure the server](Server-configuration) accordingly[](.html) ## Configuration In `data/config.json.php`. -See also [Plugin System](Plugin-System.html).[](.html) +See also [Plugin System](Plugin-System.html). ### Credentials @@ -54,7 +51,7 @@ See also [Plugin System](Plugin-System.html).[](.html) **title**: Shaarli's instance title. **header_link**: Link to the homepage. **links_per_page**: Number of shaares displayed per page. -**timezone**: See [the list of supported timezones](http://php.net/manual/en/timezones.php). [](.html) +**timezone**: See [the list of supported timezones](http://php.net/manual/en/timezones.php). **enabled_plugins**: List of enabled plugins. ### Security @@ -64,7 +61,8 @@ It might be useful if your IP adress often changes. **ban_after**: Failed login attempts before being IP banned. **ban_duration**: IP ban duration in seconds. **open_shaarli**: Anyone can add a new link while logged out if enabled. -**trusted_proxies**: List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy. +**trusted_proxies**: List of trusted IP which won't be banned after failed login attemps. Useful if Shaarli is behind a reverse proxy. +**allowed_protocols**: List of allowed protocols in shaare URLs or markdown-rendered descriptions. Useful if you want to store `javascript:` links (bookmarklets) in Shaarli (default: `["ftp", "ftps", "magnet"]`). ### Resources @@ -121,9 +119,14 @@ It might be useful if your IP adress often changes. "ban_after": 4, "session_protection_disabled": false, "ban_duration": 1800, - "trusted_proxies": [[](.html) + "trusted_proxies": [ "1.2.3.4", "5.6.7.8" + ], + "allowed_protocols": [ + "ftp", + "ftps", + "magnet" ] }, "resources": { @@ -148,7 +151,7 @@ It might be useful if your IP adress often changes. "enable_localcache": true, "check_updates_branch": "stable", "check_updates_interval": 86400, - "enabled_plugins": [[](.html) + "enabled_plugins": [ "markdown", "wallabag", "archiveorg" @@ -168,7 +171,7 @@ It might be useful if your IP adress often changes. "general": { "header_link": "?", "links_per_page": 20, - "enabled_plugins": [[](.html) + "enabled_plugins": [ "markdown", "wallabag" ], @@ -207,6 +210,6 @@ It might be useful if your IP adress often changes. ## Additional configuration The playvideos plugin may require that you adapt your server's -[Content Security Policy](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md#troubleshooting) [](.html) -configuration to work properly.[(.html)]((.html).html) +[Content Security Policy](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md#troubleshooting) +configuration to work properly.[](.html) diff --git a/doc/md/Shaarli-images.md b/doc/md/Shaarli-images.md new file mode 100644 index 00000000..25f6cfdd --- /dev/null +++ b/doc/md/Shaarli-images.md @@ -0,0 +1,72 @@ +## Get and run a Shaarli image + +### DockerHub repository +The images can be found in the [`shaarli/shaarli`](https://hub.docker.com/r/shaarli/shaarli/) +repository. + +### Available image tags +- `latest`: master branch (tarball release) +- `stable`: stable branch (tarball release) +- `dev`: master branch (Git clone) + +All images rely on: +- [Debian 8 Jessie](https://hub.docker.com/_/debian/) +- [PHP5-FPM](http://php-fpm.org/) +- [Nginx](http://nginx.org/) + +### Download from DockerHub +```bash +$ docker pull shaarli/shaarli +latest: Pulling from shaarli/shaarli +32716d9fcddb: Pull complete +84899d045435: Pull complete +4b6ad7444763: Pull complete +e0345ef7a3e0: Pull complete +5c1dd344094f: Pull complete +6422305a200b: Pull complete +7d63f861dbef: Pull complete +3eb97210645c: Pull complete +869319d746ff: Already exists +869319d746ff: Pulling fs layer +902b87aaaec9: Already exists +Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98 +Status: Downloaded newer image for shaarli/shaarli:latest +``` + +### Create and start a new container from the image +```bash +# map the host's :8000 port to the container's :80 port +$ docker create -p 8000:80 shaarli/shaarli +d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 + +# launch the container in the background +$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 +d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 + +# list active containers +$ docker ps +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo +``` + +### Stop and destroy a container +```bash +$ docker stop backstabbing_galileo # those docker guys are really rude to physicists! +backstabbing_galileo + +# check the container is stopped +$ docker ps +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + +# list ALL containers +$ docker ps -a +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo + +# destroy the container +$ docker rm backstabbing_galileo # let's put an end to these barbarian practices +backstabbing_galileo + +$ docker ps -a +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +``` diff --git a/doc/Static-analysis.md b/doc/md/Static-analysis.md similarity index 68% rename from doc/Static-analysis.md rename to doc/md/Static-analysis.md index 5781e055..ee4f5978 100644 --- a/doc/Static-analysis.md +++ b/doc/md/Static-analysis.md @@ -1,12 +1,11 @@ -#Static analysis ## WIP This topic is currently being discussed here: -- [Fix coding style (static analysis)](https://github.com/shaarli/Shaarli/issues/95) (#95)[](.html) -- [Continuous Integration tools & features](https://github.com/shaarli/Shaarli/issues/130) (#130)[](.html) +- [Fix coding style (static analysis)](https://github.com/shaarli/Shaarli/issues/95) (#95) +- [Continuous Integration tools & features](https://github.com/shaarli/Shaarli/issues/130) (#130) ### Usage -Static analysis tools can be installed with Composer, and used through Shaarli's [Makefile](https://github.com/shaarli/Shaarli/blob/master/Makefile).[](.html) +Static analysis tools can be installed with Composer, and used through Shaarli's [Makefile](https://github.com/shaarli/Shaarli/blob/master/Makefile). For an overview of the available features, see: -- [Code quality: Makefile to run static code checkers](https://github.com/shaarli/Shaarli/pull/124) (#124)[](.html) -- [Run PHPCS against different coding standards](https://github.com/shaarli/Shaarli/pull/276) (#276)[](.html) +- [Code quality: Makefile to run static code checkers](https://github.com/shaarli/Shaarli/pull/124) (#124) +- [Run PHPCS against different coding standards](https://github.com/shaarli/Shaarli/pull/276) (#276) diff --git a/doc/Theming.md b/doc/md/Theming.md similarity index 79% rename from doc/Theming.md rename to doc/md/Theming.md index 23877e5d..ae68db38 100644 --- a/doc/Theming.md +++ b/doc/md/Theming.md @@ -1,11 +1,12 @@ -#Theming ## Foreword + There are two ways of customizing how Shaarli looks: 1. by using a custom CSS to override Shaarli's CSS 2. by using a full theme that provides its own RainTPL templates, CSS and Javascript resources ## Custom CSS + Shaarli's appearance can be modified by adding CSS rules to: - Shaarli < `v0.9.0`: `inc/user.css` - Shaarli >= `v0.9.0`: `data/user.css` @@ -14,9 +15,10 @@ This file allows overriding rules defined in the template CSS files (only add ch **Note**: Do not edit `tpl/default/css/shaarli.css`! Your changes would be overridden when updating Shaarli. -See also [Download CSS styles from an OPML list](Download-CSS-styles-from-an-OPML-list.html) +See also [[Download CSS styles from an OPML list]] ## Themes + _WARNING - This feature is currently being worked on and will be improved in the next releases. Experimental._ Installation: @@ -28,24 +30,29 @@ Installation: - Shaarli >= `v0.9.0`: select the theme through the _Tools_ page ## Community CSS & themes + ### Custom CSS -- [mrjovanovic/serious-theme-shaarli](https://github.com/mrjovanovic/serious-theme-shaarli) - A serious theme for Shaarli[](.html) -- [shaarli/shaarli-themes](https://github.com/shaarli/shaarli-themes)[](.html) + +- [mrjovanovic/serious-theme-shaarli](https://github.com/mrjovanovic/serious-theme-shaarli) - A serious theme for Shaarli +- [shaarli/shaarli-themes](https://github.com/shaarli/shaarli-themes) ### Themes -- [AkibaTech/Shaarli Superhero Theme](https://github.com/AkibaTech/Shaarli---SuperHero-Theme) - A template/theme for Shaarli[](.html) -- [alexisju/albinomouse-template](https://github.com/alexisju/albinomouse-template) - A full template for Shaarli[](.html) -- [ArthurHoaro/shaarli-launch](https://github.com/ArthurHoaro/shaarli-launch) - Customizable Shaarli theme[](.html) -- [dhoko/ShaarliTemplate](https://github.com/dhoko/ShaarliTemplate) - A template/theme for Shaarli[](.html) -- [kalvn/shaarli-blocks](https://github.com/kalvn/shaarli-blocks) - A template/theme for Shaarli[](.html) -- [kalvn/Shaarli-Material](https://github.com/kalvn/Shaarli-Material) - A theme (template) based on Google's Material Design for Shaarli, the superfast delicious clone[](.html) -- [ManufacturaInd/shaarli-2004licious-theme](https://github.com/ManufacturaInd/shaarli-2004licious-theme) - A template/theme as a humble homage to the early looks of the del.icio.us site[](.html) + +- [AkibaTech/Shaarli Superhero Theme](https://github.com/AkibaTech/Shaarli---SuperHero-Theme) - A template/theme for Shaarli +- [alexisju/albinomouse-template](https://github.com/alexisju/albinomouse-template) - A full template for Shaarli +- [ArthurHoaro/shaarli-launch](https://github.com/ArthurHoaro/shaarli-launch) - Customizable Shaarli theme +- [dhoko/ShaarliTemplate](https://github.com/dhoko/ShaarliTemplate) - A template/theme for Shaarli +- [kalvn/shaarli-blocks](https://github.com/kalvn/shaarli-blocks) - A template/theme for Shaarli +- [kalvn/Shaarli-Material](https://github.com/kalvn/Shaarli-Material) - A theme (template) based on Google's Material Design for Shaarli, the superfast delicious clone +- [ManufacturaInd/shaarli-2004licious-theme](https://github.com/ManufacturaInd/shaarli-2004licious-theme) - A template/theme as a humble homage to the early looks of the del.icio.us site ### Shaarli forks -- [misterair/Limonade](https://github.com/misterair/limonade) - A fork of (legacy) Shaarli with a new template[](.html) -- [vivienhaese/shaarlitheme](https://github.com/vivienhaese/shaarlitheme) - A Shaarli fork meant to be run in an openshift instance[](.html) + +- [misterair/Limonade](https://github.com/misterair/limonade) - A fork of (legacy) Shaarli with a new template +- [vivienhaese/shaarlitheme](https://github.com/vivienhaese/shaarlitheme) - A Shaarli fork meant to be run in an openshift instance ## Example installation: AlbinoMouse theme + With the following configuration: - Apache 2 / PHP 5.6 - user sites are enabled, e.g. `/home/user/public_html/somedir` is served as `http://localhost/~user/somedir` @@ -70,7 +77,7 @@ Get config written: - fill the install form - log in to Shaarli -Edit Shaarli's [configuration|Shaarli configuration](configuration|Shaarli-configuration.html): +Edit Shaarli's [[configuration|Shaarli configuration]]: ```bash # the file should be owned by Apache, thus not writeable => sudo $ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php diff --git a/doc/Troubleshooting.md b/doc/md/Troubleshooting.md similarity index 92% rename from doc/Troubleshooting.md rename to doc/md/Troubleshooting.md index 8e30fce5..13005526 100644 --- a/doc/Troubleshooting.md +++ b/doc/md/Troubleshooting.md @@ -1,14 +1,18 @@ -#Troubleshooting +# Troubleshooting + ## Browser + ### Redirection issues (HTTP Referer) + Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages. See: -- [HTTP referer](https://en.wikipedia.org/wiki/HTTP_referer) (Wikipedia)[](.html) -- [Improve online privacy by controlling referrer information](http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/)[](.html) -- [Better security, privacy and anonymity in Firefox](http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/)[](.html) +- [HTTP referer](https://en.wikipedia.org/wiki/HTTP_referer) (Wikipedia) +- [Improve online privacy by controlling referrer information](http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/) +- [Better security, privacy and anonymity in Firefox](http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/) ### Firefox HTTP Referer options + HTTP settings are available by browsing `about:config`, here are the available settings and their values. `network.http.sendRefererHeader` - determines when to send the Referer HTTP header @@ -33,6 +37,7 @@ HTTP settings are available by browsing `about:config`, here are the available s - 2: scheme+host+port ### Firefox, localhost and redirections + `localhost` is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly. To solve this, assign a local domain to your host, e.g. @@ -44,25 +49,31 @@ To solve this, assign a local domain to your host, e.g. and browse Shaarli at http://localhost.lan/. Related threads: -- [What is localhost.localdomain for?](https://bbs.archlinux.org/viewtopic.php?id=156064)[](.html) -- [Stop returning to the first page after editing a bookmark from another page](https://github.com/shaarli/Shaarli/issues/311)[](.html) +- [What is localhost.localdomain for?](https://bbs.archlinux.org/viewtopic.php?id=156064) +- [Stop returning to the first page after editing a bookmark from another page](https://github.com/shaarli/Shaarli/issues/311) ## Login + ### I forgot my password! + Delete the file `data/config.php` and display the page again. You will be asked for a new login/password. ### I'm locked out - Login bruteforce protection + Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links. To remove the current IP bans, delete the file `data/ipbans.php` ### List of all login attempts + The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans. Search for `failed` in this file to look for unauthorized login attempts. ## Hosting problems + ### Old PHP versions - * On **free.fr** : free.fr now support php 5.6.x([link](http://les.pages.perso.chez.free.fr/migrations/php5v6.io))and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a `sessions` directory and a `.htaccess` file containing:[](.html) + + * On **free.fr** : free.fr now support php 5.6.x([link](http://les.pages.perso.chez.free.fr/migrations/php5v6.io))and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a `sessions` directory and a `.htaccess` file containing: ```ini @@ -72,7 +83,7 @@ php56 1 * If you have an error such as: `Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx`, it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to `.php5` * On **1and1** : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP). - * If you have the error `Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /…/index.php on line xxx`, it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines:[](.html) + * If you have the error `Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /…/index.php on line xxx`, it means that your host has disabled the ability to fetch a file by HTTP in the php config (Typically in 1and1 hosting). Bad host. Change host. Or comment the following lines: ```php //list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive. @@ -84,24 +95,29 @@ php56 1 * On **lost-oasis**, RSS doesn't work correctly, because of this message at the begining of the RSS/ATOM feed : ``. To fix this, remove this message from `php-include/prepend.php` ### Dates are not properly formatted + Shaarli tries to sniff the language of the browser (using HTTP_ACCEPT_LANGUAGE headers) and choose a date format accordingly. But Shaarli can only use the date formats (and more generaly speaking, the locales) provided by the webserver. So even if you have a browser in French, you may end up with dates in US format (it's the case on sebsauvage.net :-( ) ### Problems on CentOS servers + On **CentOS**/RedHat derivatives, you may need to install the `php-mbstring` package. ### My session expires! I can't stay logged in + This can be caused by several things: * Your php installation may not have a proper directory setup for session files. (eg. on Free.fr you need to create a `session` directory on the root of your website.) You may need to create the session directory of set it up. -* Most hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the `sessions` subdirectory and add `ini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions');`. Make sure this directory is not browsable !)[](.html) +* Most hosts regularly clean the temporary and session directories. Your host may be cleaning those directories too aggressively (eg.OVH hosts), forcing an expire of the session. You may want to set the session directory in your web root. (eg. Create the `sessions` subdirectory and add `ini_set('session.save_path', $_SERVER['DOCUMENT_ROOT'].'/../sessions');`. Make sure this directory is not browsable !) * If your IP address changes during surfing, Shaarli will force expire your session for security reasons (to prevent session cookie hijacking). This can happen when surfing from WiFi or 3G (you may have switched WiFi/3G access point), or in some corporate/university proxies which use load balancing (and may have proxies with several external IP addresses). * Some browser addons may interfer with HTTP headers (ipfuck/ipflood/GreaseMonkey…). Try disabling those. * You may be using OperaTurbo or OperaMini, which use their own proxies which may change from time to time. * If you have another application on the same webserver where Shaarli is installed, these application may forcefully expire php sessions. ## Sessions do not seem to work correctly on your server -Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have **no dots** in the hostname (e.g. `localhost` or `http://my-webserver/shaarli/`), some browsers will not store cookies at all (this respects the [HTTP cookie specification](http://curl.haxx.se/rfc/cookie_spec.html)).[](.html) + +Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have **no dots** in the hostname (e.g. `localhost` or `http://my-webserver/shaarli/`), some browsers will not store cookies at all (this respects the [HTTP cookie specification](http://curl.haxx.se/rfc/cookie_spec.html)). ### pubsubhubbub support -Download [publisher.php](https://pubsubhubbub.googlecode.com/git/publisher_clients/php/library/publisher.php) at the root of your Shaarli installation and set `$GLOBALS['config'['PUBSUBHUB_URL']` in your `config.php`]('PUBSUBHUB_URL']`-in-your-`config.php`.html) + +Download [publisher.php](https://pubsubhubbub.googlecode.com/git/publisher_clients/php/library/publisher.php) at the root of your Shaarli installation and set `$GLOBALS['config']['PUBSUBHUB_URL']` in your `config.php` diff --git a/doc/Unit-tests.md b/doc/md/Unit-tests.md similarity index 96% rename from doc/Unit-tests.md rename to doc/md/Unit-tests.md index 0942ad38..19838721 100644 --- a/doc/Unit-tests.md +++ b/doc/md/Unit-tests.md @@ -1,13 +1,13 @@ -#Unit tests - ### Setup your environment for tests -The framework used is [PHPUnit](https://phpunit.de/); it can be installed with [Composer](https://getcomposer.org/), which is a dependency management tool.[](.html) + +The framework used is [PHPUnit](https://phpunit.de/); it can be installed with [Composer](https://getcomposer.org/), which is a dependency management tool. Regarding Composer, you can either use: * a system-wide version, e.g. installed through your distro's package manager -* a local version, downloadable [here](https://getcomposer.org/download/)[](.html) +* a local version, downloadable [here](https://getcomposer.org/download/) #### Sample usage + ```bash # system-wide version $ composer install @@ -20,12 +20,14 @@ $ php composer.phar update ``` #### Install Shaarli dev dependencies + ```bash $ cd /path/to/shaarli $ composer update ``` #### Install and enable Xdebug to generate PHPUnit coverage reports + For Debian-based distros: ```bash $ aptitude install php5-xdebug @@ -41,6 +43,7 @@ zend_extension=xdebug.so ``` #### Run unit tests + Successful test suite: ```bash $ make test @@ -111,6 +114,7 @@ Tests: 36, Assertions: 63, Errors: 1, Failures: 2. ``` #### Test results and coverage + By default, PHPUnit will run all suitable tests found under the `tests` directory. Each test has 3 possible outcomes: @@ -128,7 +132,8 @@ If Xdebug has been installed and activated, two coverage reports will be generat * to open it in a web browser: `firefox coverage/index.html &` ### Executing specific tests -Add a [`@group`](https://phpunit.de/manual/current/en/appendixes.annotations.html#appendixes.annotations.group) annotation in a test class or method comment:[](.html) + +Add a [`@group`](https://phpunit.de/manual/current/en/appendixes.annotations.html#appendixes.annotations.group) annotation in a test class or method comment: ```php /** @@ -137,7 +142,7 @@ Add a [`@group`](https://phpunit.de/manual/current/en/appendixes.annotations.htm */ class BookmarkImportTest extends PHPUnit_Framework_TestCase { - [...][](.html) + [...] } ``` diff --git a/doc/Upgrade-and-migration.md b/doc/md/Upgrade-and-migration.md similarity index 83% rename from doc/Upgrade-and-migration.md rename to doc/md/Upgrade-and-migration.md index d36eb862..7348891f 100644 --- a/doc/Upgrade-and-migration.md +++ b/doc/md/Upgrade-and-migration.md @@ -1,5 +1,5 @@ -#Upgrade and migration ## Preparation + ### Note your current version If anything goes wrong, it's important for us to know which version you're upgrading from. @@ -13,33 +13,37 @@ Shaarli stores all user data under the `data` directory: - `data/ipbans.php` - banned IP addresses - `data/updates.txt` - contains all automatic update to the configuration and datastore files already run -See [Shaarli configuration](Shaarli-configuration.html) for more information about Shaarli resources. +See [[Shaarli configuration]] for more information about Shaarli resources. It is recommended to backup this repository _before_ starting updating/upgrading Shaarli: - users with SSH access: copy or archive the directory to a temporary location - users with FTP access: download a local copy of your Shaarli installation using your favourite client ### Migrating data from a previous installation + As all user data is kept under `data`, this is the only directory you need to worry about when migrating to a new installation, which corresponds to the following steps: - backup the `data` directory - install or update Shaarli: - - fresh installation - see [Download and installation](Download-and-installation.html) + - fresh installation - see [[Download and installation]] - update - see the following sections - check or restore the `data` directory ## Recommended : Upgrading from release archives -All tagged revisions can be downloaded as tarballs or ZIP archives from the [releases](https://github.com/shaarli/Shaarli/releases) page.[](.html) -We recommend that you use the latest release tarball with the `-full` suffix. It contains the dependencies, please read [Download and installation](Download-and-installation.html) for `git` complete instructions. +All tagged revisions can be downloaded as tarballs or ZIP archives from the [releases](https://github.com/shaarli/Shaarli/releases) page. + +We recommend that you use the latest release tarball with the `-full` suffix. It contains the dependencies, please read [[Download and installation]] for `git` complete instructions. Once downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the `data` directory! -After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to `data/config.json.php` (see [Shaarli configuration](Shaarli-configuration.html) for more details). +After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to `data/config.json.php` (see [[Shaarli configuration]] for more details). ## Upgrading with Git + ### Updating a community Shaarli -If you have installed Shaarli from the [community Git repository](Download#clone-with-git-recommended), simply [pull new changes](https://www.git-scm.com/docs/git-pull) from your local clone:[](.html) + +If you have installed Shaarli from the [community Git repository](Download#clone-with-git-recommended), simply [pull new changes](https://www.git-scm.com/docs/git-pull) from your local clone: ```bash $ cd /path/to/shaarli @@ -55,7 +59,7 @@ Fast-forward 3 files changed, 3 insertions(+), 1 deletion(-) ``` -Shaarli >= `v0.8.x`: install/update third-party PHP dependencies using [Composer](https://getcomposer.org/):[](.html) +Shaarli >= `v0.8.x`: install/update third-party PHP dependencies using [Composer](https://getcomposer.org/): ```bash $ composer install --no-dev @@ -67,18 +71,20 @@ Updating dependencies ``` ### Migrating and upgrading from Sebsauvage's repository -If you have installed Shaarli from [Sebsauvage's original Git repository](https://github.com/sebsauvage/Shaarli), you can use [Git remotes](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) to update your working copy.[](.html) + +If you have installed Shaarli from [Sebsauvage's original Git repository](https://github.com/sebsauvage/Shaarli), you can use [Git remotes](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) to update your working copy. The following guide assumes that: -- you have a basic knowledge of Git [branching](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) and [remote repositories](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes)[](.html) +- you have a basic knowledge of Git [branching](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) and [remote repositories](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) - the default remote is named `origin` and points to Sebsauvage's repository - the current branch is `master` - - if you have personal branches containing customizations, you will need to [rebase them](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break![](.html) + - if you have personal branches containing customizations, you will need to [rebase them](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) after the upgrade; beware though, a lot of changes have been made since the community fork has been created, so things are very likely to break! - the working copy is clean: - no versioned file has been locally modified - no untracked files are present #### Step 0: show repository information + ```bash $ cd /path/to/shaarli @@ -87,7 +93,7 @@ origin https://github.com/sebsauvage/Shaarli (fetch) origin https://github.com/sebsauvage/Shaarli (push) $ git branch -vv -* master 029f75f [origin/master] Update README.md[](.html) +* master 029f75f [origin/master] Update README.md $ git status On branch master @@ -96,6 +102,7 @@ nothing to commit, working directory clean ``` #### Step 1: update Git remotes + ``` $ git remote rename origin sebsauvage $ git remote -v @@ -111,11 +118,11 @@ remote: Total 3015 (delta 446), reused 457 (delta 446), pack-reused 2550 Receiving objects: 100% (3015/3015), 2.59 MiB | 918.00 KiB/s, done. Resolving deltas: 100% (1899/1899), completed with 48 local objects. From https://github.com/shaarli/Shaarli - * [new branch] master -> origin/master[](.html) - * [new branch] stable -> origin/stable[](.html) -[...][](.html) - * [new tag] v0.6.4 -> v0.6.4[](.html) - * [new tag] v0.7.0 -> v0.7.0[](.html) + * [new branch] master -> origin/master + * [new branch] stable -> origin/stable +[...] + * [new tag] v0.6.4 -> v0.6.4 + * [new tag] v0.7.0 -> v0.7.0 ``` #### Step 2: use the stable community branch @@ -126,11 +133,11 @@ Branch stable set up to track remote branch stable from origin. Switched to a new branch 'stable' $ git branch -vv - master 029f75f [sebsauvage/master] Update README.md[](.html) -* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5[](.html) + master 029f75f [sebsauvage/master] Update README.md +* stable 890afc3 [origin/stable] Merge pull request #509 from ArthurHoaro/v0.6.5 ``` -Shaarli >= `v0.8.x`: install/update third-party PHP dependencies using [Composer](https://getcomposer.org/):[](.html) +Shaarli >= `v0.8.x`: install/update third-party PHP dependencies using [Composer](https://getcomposer.org/): ```bash $ composer install --no-dev @@ -162,7 +169,8 @@ Total 3317 (delta 2050), reused 3301 (delta 2034)to ``` #### Step 3: configuration -After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to `data/config.php` (see [Shaarli configuration](Shaarli-configuration.html) for more details). + +After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to `data/config.php` (see [[Shaarli configuration]] for more details). ## Troubleshooting diff --git a/doc/md/Versioning-and-Branches.md b/doc/md/Versioning-and-Branches.md new file mode 100644 index 00000000..e1d998e0 --- /dev/null +++ b/doc/md/Versioning-and-Branches.md @@ -0,0 +1,75 @@ +**WORK IN PROGRESS** + +It's important to understand how Shaarli branches work, especially if you're maintaining a 3rd party tools for Shaarli (theme, plugin, etc.), to be sure stay compatible. + +## `master` branch + +The `master` branch is the development branch. Any new change MUST go through this branch using Pull Requests. + +Remarks: + + * This branch shouldn't be used for production as it isn't necessary stable. + * 3rd party aren't required to be compatible with the latest changes. + * Official plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch. + * The version in this branch is always `dev`. + +## `v0.x` branch + +This `v0.x` branch, points to the latest `v0.x.y` release. + +Explanation: + +When a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli. + +In this case, the issue is fixed in the `master` branch, and the fix is backported the to the `v0.x` branch. Then a new release is made from the `v0.x` branch. + +This workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon. + +## `latest` branch + +This branch point the latest release. It recommended to use it to get the latest tested changes. + +## `stable` branch + +The `stable` branch doesn't contain any major bug, and is one major digit version behind the latest release. + +For example, the current latest release is `v0.8.3`, the stable branch is an alias to the latest `v0.7.x` release. When the `v0.9.0` version will be released, the stable will move to the latest `v0.8.x` release. + +Remarks: + + * Shaarli release pace isn't fast, and the stable branch might be a few months behind the latest release. + +## Releases + +Releases are always made from the latest `v0.x` branch. + +Note that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step. + +## Advices on 3rd party git repos workflow + +### Versioning + +Any time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the [changelog](https://github.com/shaarli/Shaarli/releases) (*Draft* means not released yet) and the commit log (like [`tpl` folder](https://github.com/shaarli/Shaarli/commits/master/tpl/default) for themes)). You can either: + + - use the Shaarli version number, with your repo version. For example, if Shaarli `v0.8.3` is released, publish a `v0.8.3-1` release, where `v0.8.3` states Shaarli compatibility and `-1` is your own version digit for the current Shaarli version. + - use your own versioning scheme, and state Shaarli compatibility in the release description. + +Using this, any user will be able to pick the release matching his own Shaarli version. + +### Major bugfix backport releases + +To be able to support backported fixes, it recommended to use our workflow: + +```bash +# In master, fix the major bug +git commit -m "Katastrophe" +git push origin master +# Get your commit hash +git log --format="%H" -n 1 +# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name) +git checkout -b katastrophe v0.8.2-1 +# Backport the fix commit to your brand new branch +git cherry-pick +git push origin katastrophe +# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1` +``` diff --git a/doc/_Footer.md b/doc/md/_Footer.md similarity index 69% rename from doc/_Footer.md rename to doc/md/_Footer.md index 50fa4f56..648b1298 100644 --- a/doc/_Footer.md +++ b/doc/md/_Footer.md @@ -1,2 +1 @@ -#_Footer -_Shaarli, the personal, minimalist, super-fast, database-free bookmarking service_ +_Shaarli, the personal, minimalist, super-fast, database-free bookmarking service_ \ No newline at end of file diff --git a/doc/md/_Sidebar.md b/doc/md/_Sidebar.md new file mode 100644 index 00000000..fe0e4229 --- /dev/null +++ b/doc/md/_Sidebar.md @@ -0,0 +1,45 @@ +- [[Home]] +- Setup + - [[Download and Installation]] + - [[Upgrade and migration]] + - [[Server requirements]] + - [[Server configuration]] + - [[Server security]] + - [[Shaarli configuration]] + - [[Plugins]] +- Docker + - [[Docker 101]] + - [[Shaarli images]] + - [[Reverse proxy configuration]] + - [[Docker resources]] +- Usage + - [[Features]] + - [[Bookmarklet]] + - [[Browsing and Searching]] + - [[Firefox share]] + - [[RSS feeds]] + - [[REST API]] +- How To + - [[Backup, restore, import and export]] + - [[Copy an existing installation over SSH and serve it locally]] + - [[Create and serve multiple Shaarlis (farm)]] + - [[Download CSS styles from an OPML list]] + - [[Datastore hacks]] +- [[Troubleshooting]] +- Development: + - [[Development guidelines]] + - [[Continuous integration tools]] + - [[GnuPG signature]] + - [[Coding guidelines]] + - [[Directory structure]] + - [[3rd party libraries]] + - [[Plugin System]] + - [[Release Shaarli]] + - [[Versioning and Branches]] + - [[Security]] + - [[Static analysis]] + - [[Theming]] + - [[Unit tests]] +- About + - [[FAQ]] + - [[Community & Related software]] diff --git a/doc/md/config.json b/doc/md/config.json new file mode 100644 index 00000000..cc4de307 --- /dev/null +++ b/doc/md/config.json @@ -0,0 +1,6 @@ +{ + "useSideMenu": true, + "lineBreaks": "gfm", + "additionalFooterText": "", + "title": "Shaarli documentation" +} \ No newline at end of file diff --git a/doc/md/github-markdown.css b/doc/md/github-markdown.css new file mode 100644 index 00000000..581350ae --- /dev/null +++ b/doc/md/github-markdown.css @@ -0,0 +1,287 @@ +#local-sidebar { + width: 230px; + float: right; + position: relative; + z-index: 4; + background-color: #fff; + border: 1px solid #e2e2e2; + border-radius: 3px; +} + +body { + font-family: Helvetica, arial, sans-serif; + font-size: 14px; + line-height: 1.6; + padding-top: 10px; + padding-bottom: 10px; + background-color: white; + padding: 10px 20%; } + +body > *:first-child { + margin-top: 0 !important; } +body > *:last-child { + margin-bottom: 0 !important; } + +a { + color: #4183C4; } +a.absent { + color: #cc0000; } +a.anchor { + display: block; + padding-left: 30px; + margin-left: -30px; + cursor: pointer; + position: absolute; + top: 0; + left: 0; + bottom: 0; } + +h1, h2, h3, h4, h5, h6 { + margin: 20px 0 10px; + padding: 0; + font-weight: bold; + -webkit-font-smoothing: antialiased; + cursor: text; + position: relative; } + +h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor { + background: url("../../images/modules/styleguide/para.png") no-repeat 10px center; + text-decoration: none; } + +h1 tt, h1 code { + font-size: inherit; } + +h2 tt, h2 code { + font-size: inherit; } + +h3 tt, h3 code { + font-size: inherit; } + +h4 tt, h4 code { + font-size: inherit; } + +h5 tt, h5 code { + font-size: inherit; } + +h6 tt, h6 code { + font-size: inherit; } + +h1 { + font-size: 28px; + color: black; } + +h2 { + font-size: 24px; + border-bottom: 1px solid #cccccc; + color: black; } + +h3 { + font-size: 18px; } + +h4 { + font-size: 16px; } + +h5 { + font-size: 14px; } + +h6 { + color: #777777; + font-size: 14px; } + +p, blockquote, ol, dl, table, pre { + margin: 15px 0; } + +hr { + background: transparent url("../../images/modules/pulls/dirty-shade.png") repeat-x 0 0; + border: 0 none; + color: #cccccc; + height: 4px; + padding: 0; } + +body > h2:first-child { + margin-top: 0; + padding-top: 0; } +body > h1:first-child { + margin-top: 0; + padding-top: 0; } + body > h1:first-child + h2 { + margin-top: 0; + padding-top: 0; } +body > h3:first-child, body > h4:first-child, body > h5:first-child, body > h6:first-child { + margin-top: 0; + padding-top: 0; } + +a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 { + margin-top: 0; + padding-top: 0; } + +h1 p, h2 p, h3 p, h4 p, h5 p, h6 p { + margin-top: 0; } + +li p.first { + display: inline-block; } + +ul, ol { + padding-left: 30px; } + +ul :first-child, ol :first-child { + margin-top: 0; } + +ul :last-child, ol :last-child { + margin-bottom: 0; } + +dl { + padding: 0; } + dl dt { + font-size: 14px; + font-weight: bold; + font-style: italic; + padding: 0; + margin: 15px 0 5px; } + dl dt:first-child { + padding: 0; } + dl dt > :first-child { + margin-top: 0; } + dl dt > :last-child { + margin-bottom: 0; } + dl dd { + margin: 0 0 15px; + padding: 0 15px; } + dl dd > :first-child { + margin-top: 0; } + dl dd > :last-child { + margin-bottom: 0; } + +blockquote { + border-left: 4px solid #dddddd; + padding: 0 15px; + color: #777777; } + blockquote > :first-child { + margin-top: 0; } + blockquote > :last-child { + margin-bottom: 0; } + +table { + padding: 0; } + table tr { + border-top: 1px solid #cccccc; + background-color: white; + margin: 0; + padding: 0; } + table tr:nth-child(2n) { + background-color: #f8f8f8; } + table tr th { + font-weight: bold; + border: 1px solid #cccccc; + text-align: left; + margin: 0; + padding: 6px 13px; } + table tr td { + border: 1px solid #cccccc; + text-align: left; + margin: 0; + padding: 6px 13px; } + table tr th :first-child, table tr td :first-child { + margin-top: 0; } + table tr th :last-child, table tr td :last-child { + margin-bottom: 0; } + +img { + max-width: 100%; } + +span.frame { + display: block; + overflow: hidden; } + span.frame > span { + border: 1px solid #dddddd; + display: block; + float: left; + overflow: hidden; + margin: 13px 0 0; + padding: 7px; + width: auto; } + span.frame span img { + display: block; + float: left; } + span.frame span span { + clear: both; + color: #333333; + display: block; + padding: 5px 0 0; } +span.align-center { + display: block; + overflow: hidden; + clear: both; } + span.align-center > span { + display: block; + overflow: hidden; + margin: 13px auto 0; + text-align: center; } + span.align-center span img { + margin: 0 auto; + text-align: center; } +span.align-right { + display: block; + overflow: hidden; + clear: both; } + span.align-right > span { + display: block; + overflow: hidden; + margin: 13px 0 0; + text-align: right; } + span.align-right span img { + margin: 0; + text-align: right; } +span.float-left { + display: block; + margin-right: 13px; + overflow: hidden; + float: left; } + span.float-left span { + margin: 13px 0 0; } +span.float-right { + display: block; + margin-left: 13px; + overflow: hidden; + float: right; } + span.float-right > span { + display: block; + overflow: hidden; + margin: 13px auto 0; + text-align: right; } + +code, tt { + margin: 0 2px; + padding: 0 5px; + white-space: nowrap; + border: 1px solid #eaeaea; + background-color: #f8f8f8; + border-radius: 3px; } + +pre code { + margin: 0; + padding: 0; + white-space: pre; + border: none; + background: transparent; } + +.highlight pre { + background-color: #f8f8f8; + border: 1px solid #cccccc; + font-size: 13px; + line-height: 19px; + overflow: auto; + padding: 6px 10px; + border-radius: 3px; } + +pre { + background-color: #f8f8f8; + border: 1px solid #cccccc; + font-size: 13px; + line-height: 19px; + overflow: auto; + padding: 6px 10px; + border-radius: 3px; } + pre code, pre tt { + background-color: transparent; + border: none; } diff --git a/doc/md/images/bookmarklet.png b/doc/md/images/bookmarklet.png new file mode 100644 index 0000000000000000000000000000000000000000..0262578e467d9e356d49cccc1b4917d276844712 GIT binary patch literal 53346 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 z zW)^D_3fpqZ>1QP;8JuUGAj#6lFN}rGIBEsh96RUwYLtNi=3@avib}t??in*^LhE~H zD>o!i25mLB!Ffgu%*QhudV8L98+V)5_x01HsvNPSbm-G6hE2>BRS7u`m3YM_#SJG| z<-R{_PC=H*WY)X}=E?w#M}Uh5LM2kAs`3GJJkL@3yvtH3m>v_Rnd@T)efl~OTZlm z*}wQ;1uBO0sroCX0WkZQW>O=ZD-8B<&>t4l+pthdfW%+~=tH@NU8Wqtm_*!!C1$kD zqQKT%rLnd|XONsr5^}3}PD4=JlZw=tAx0rB{l$vKt9?Yd!2rfFnX*ob^d%CSR#cp* z)*ynx21`+J6bKNA5lzVBAC4z&@($L0ST1`)VU!x>3&0O__yO*GMsm4JjrpRCnknSD(pmdUR*fDB<7W!vOLGY=)UW?N;( zT}O=7o@auA=oG`8csm#yW;d$M(ZXJ(6KF-KVz5gUqF6&HIav>?(v=FnUslt37Igj$ zQR`ecWDRMJsTo@>EL20rn&8CPkFuf|g8tBA+=$x5YMEJi21KX>EkY4hR^R{m%0AGd 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 literal 0 HcmV?d00001 diff --git a/doc/md/images/doc-logo.png b/doc/md/images/doc-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..3d8d1787a7326816d5ff6d8cb5921088e4c3bbe7 GIT binary patch literal 19543 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 literal 0 HcmV?d00001 diff --git a/doc/md/images/doc-logo.svg b/doc/md/images/doc-logo.svg new file mode 100644 index 0000000000000000000000000000000000000000..37fc665859ed8e9f9d42eca26736b877bcacbfef GIT binary patch literal 69439 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 Ar~m)} literal 0 HcmV?d00001 diff --git a/doc/md/images/firefoxshare.png b/doc/md/images/firefoxshare.png new file mode 100644 index 0000000000000000000000000000000000000000..98c2fdd3b6072be14049bb0f075976dd80bb0e58 GIT binary patch literal 757 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

    tvT1mlaG3bX8 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 ZD=;xSFfict5#Im+002ovPDHLkV1o8P4nhC` literal 0 HcmV?d00001 diff --git a/doc/md/images/rss-filter-2.png b/doc/md/images/rss-filter-2.png new file mode 100644 index 0000000000000000000000000000000000000000..538b126ee4b0a4c92567674b14ce1354e6802c7e GIT binary patch literal 15604 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 QuK@rF5n18NpL%}(1@*7;J^%m! literal 0 HcmV?d00001 diff --git a/doc/Home.md b/doc/md/index.md similarity index 89% rename from doc/Home.md rename to doc/md/index.md index 38413f24..37a9c1fc 100644 --- a/doc/Home.md +++ b/doc/md/index.md @@ -1,14 +1,11 @@ -#Home -# Shaarli wiki - -Welcome to the [Shaarli](https://github.com/shaarli/Shaarli/) wiki![](.html) +Welcome to the [Shaarli](https://github.com/shaarli/Shaarli/) wiki! Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli. -For general info, read the [README](https://github.com/shaarli/Shaarli/blob/master/README.md).[](.html) +For general info, read the [README](https://github.com/shaarli/Shaarli/blob/master/README.md). -If you have any questions or ideas, please join the [chat](https://gitter.im/shaarli/Shaarli) (also reachable via [IRC](https://irc.gitter.im/)), post them in our [general discussion](https://github.com/shaarli/Shaarli/issues/308) ([archive](https://github.com/shaarli/Shaarli/issues/44)) or read the current [issues](https://github.com/shaarli/Shaarli/issues). If you've found a bug, please create a [new issue](https://github.com/shaarli/Shaarli/issues/new).[](.html) +If you have any questions or ideas, please join the [chat](https://gitter.im/shaarli/Shaarli) (also reachable via [IRC](https://irc.gitter.im/)), post them in our [general discussion](https://github.com/shaarli/Shaarli/issues/308) ([archive](https://github.com/shaarli/Shaarli/issues/44)) or read the current [issues](https://github.com/shaarli/Shaarli/issues). If you've found a bug, please create a [new issue](https://github.com/shaarli/Shaarli/issues/new). -If you would like a feature added to Shaarli, check the issues labeled [`feature`](https://github.com/shaarli/Shaarli/labels/feature), [`enhancement`](https://github.com/shaarli/Shaarli/labels/enhancement), and [`plugin`](https://github.com/shaarli/Shaarli/labels/plugin).[](.html) +If you would like a feature added to Shaarli, check the issues labeled [`feature`](https://github.com/shaarli/Shaarli/labels/feature), [`enhancement`](https://github.com/shaarli/Shaarli/labels/enhancement), and [`plugin`](https://github.com/shaarli/Shaarli/labels/plugin). _Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the `doc/` directory of your Shaarli installation._ diff --git a/doc/sidebar.html b/doc/sidebar.html deleted file mode 100644 index 478840d1..00000000 --- a/doc/sidebar.html +++ /dev/null @@ -1,52 +0,0 @@ -

    diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 00000000..f9648a7e --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,53 @@ +site_name: Shaarli Documentation +repo_url: https://github.com/shaarli/Shaarli +site_description: The personal, minimalist, super-fast, database free, bookmarking service +theme: readthedocs +docs_dir: doc/md +site_dir: doc/html + +pages: +- Home: index.md +- Setup: + - Download and Installation: Download-and-Installation.md + - Upgrade and migration: Upgrade-and-migration.md + - Server requirements: Server-requirements.md + - Server configuration: Server-configuration.md + - Server security: Server-security.md + - Shaarli configuration: Shaarli-configuration.md + - Plugins: Plugins.md +- Docker: + - Docker 101: Docker-101.md + - Shaarli images: Shaarli-images.md + - Reverse proxy configuration: Reverse-proxy-configuration.md + - Docker resources: Docker-resources.md +- Usage: + - Features: Features.md + - Bookmarklet: Bookmarklet.md + - Browsing and searching: Browsing-and-searching.md + - Firefox share: Firefox-share.md + - RSS feeds: RSS-feeds.md + - REST API: REST-API.md +- How To: + - Backup, restore, import and export: Backup,-restore,-import-and-export.md + - Copy an existing installation over SSH and serve it locally: Copy-an-existing-installation-over-SSH-and-serve-it-locally.md + - Create and serve multiple Shaarlis (farm): Create-and-serve-multiple-Shaarlis-(farm).md + - Download CSS styles from an OPML list: Download-CSS-styles-from-an-OPML-list.md + - Datastore hacks: Datastore-hacks.md +- Troubleshooting: Troubleshooting.md +- Development: + - Development guidelines: Development-guidelines.md + - Continuous integration tools: Continuous-integration-tools.md + - GnuPG signature: GnuPG-signature.md + - Coding guidelines: Coding-guidelines.md + - Directory structure: Directory-structure.md + - 3rd party libraries: 3rd-party-libraries.md + - Plugin System: Plugin-System.md + - Release Shaarli: Release-Shaarli.md + - Versioning and Branches: Versioning-and-Branches.md + - Security: Security.md + - Static analysis: Static-analysis.md + - Theming: Theming.md + - Unit tests: Unit-tests.md +- About: + - FAQ: FAQ.md + - Community & Related software: Community-&-Related-software.md diff --git a/tpl/default/page.footer.html b/tpl/default/page.footer.html index 02fc7642..84f13612 100644 --- a/tpl/default/page.footer.html +++ b/tpl/default/page.footer.html @@ -1,3 +1,13 @@ +<<<<<<< HEAD +======= +
    From 460ce50115e5f5a1183c3c410fd76636ee5c4716 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Sun, 18 Jun 2017 06:29:15 +0200 Subject: [PATCH 27/67] doc: rename "datastore hacks" -> "various hacks", move example scripts to gist.github.com, remove obsolete GH wiki _Sidebar.md --- ...tallation-over-SSH-and-serve-it-locally.md | 66 ------ ...eate-and-serve-multiple-Shaarlis-(farm).md | 57 ------ .../Download-CSS-styles-from-an-OPML-list.md | 154 -------------- ...ple-patch---add-new-via-field-for-links.md | 189 ------------------ .../{Datastore-hacks.md => Various-hacks.md} | 10 +- doc/md/_Sidebar.md | 45 ----- mkdocs.yml | 5 +- 7 files changed, 10 insertions(+), 516 deletions(-) delete mode 100644 doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md delete mode 100644 doc/md/Create-and-serve-multiple-Shaarlis-(farm).md delete mode 100644 doc/md/Download-CSS-styles-from-an-OPML-list.md delete mode 100644 doc/md/Example-patch---add-new-via-field-for-links.md rename doc/md/{Datastore-hacks.md => Various-hacks.md} (65%) delete mode 100644 doc/md/_Sidebar.md diff --git a/doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md b/doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md deleted file mode 100644 index 7583c9ea..00000000 --- a/doc/md/Copy-an-existing-installation-over-SSH-and-serve-it-locally.md +++ /dev/null @@ -1,66 +0,0 @@ -Example bash script: - -```bash -#!/bin/bash -#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli -#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally. -#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli -#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed -#Usage: ./local-shaarli.sh -#Author: nodiscc (nodiscc@gmail.com) -#License: MIT (http://opensource.org/licenses/MIT) -set -o errexit -set -o nounset - -##### CONFIG ################# -#The port used by php's local server -php_local_port=7431 - -#Name of the SSH server and path where Shaarli is installed -#TODO: pass these as command-line arguments -remotehost="my.ssh.server" -remote_shaarli_dir="/var/www/shaarli" - - -###### FUNCTIONS ############# -_main() { - _CBSyncShaarli - _CBServeShaarli -} - -_CBSyncShaarli() { - remote_temp_dir=$(ssh $remotehost mktemp -d) - remote_ssh_user=$(ssh $remotehost whoami) - ssh -t "$remotehost" sudo cp -r "$remote_shaarli_dir" "$remote_temp_dir" - ssh -t "$remotehost" sudo chown -R "$remote_ssh_user":"$remote_ssh_user" "$remote_temp_dir" - scp -rq "$remotehost":"$remote_temp_dir" local-shaarli - ssh "$remotehost" rm -r "$remote_temp_dir" -} - -_CBServeShaarli() { - #TODO: allow serving a previously downloaded Shaarli - #TODO: ask before overwriting local copy, if it exists - cd local-shaarli/ - php -S localhost:${php_local_port} - echo "Please go to http://localhost:${php_local_port}" -} - - -##### MAIN ################# - -_main -``` - -This outputs: - -```bash -$ ./local-shaarli.sh -PHP 5.6.0RC4 Development Server started at Mon Sep 1 21:56:19 2014 -Listening on http://localhost:7431 -Document root is /home/user/local-shaarli/shaarli -Press Ctrl-C to quit. - -[Mon Sep 1 21:56:27 2014] ::1:57868 [200]: / -[Mon Sep 1 21:56:27 2014] ::1:57869 [200]: /index.html -[Mon Sep 1 21:56:37 2014] ::1:57881 [200]: /... -``` diff --git a/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md deleted file mode 100644 index d0d812a3..00000000 --- a/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md +++ /dev/null @@ -1,57 +0,0 @@ -Example bash script (creates multiple shaarli instances and generates an HTML index of them) - -```bash -#!/bin/bash -set -o errexit -set -o nounset - -#config -shaarli_base_dir='/var/www/shaarli' -accounts='bob john whatever username' -shaarli_repo_url='https://github.com/shaarli/Shaarli' -ref="master" - -#clone multiple shaarli instances -if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi - -for account in $accounts; do - if [ -d "$shaarli_base_dir/$account" ]; - then echo "[info] account $account already exists, skipping"; - else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi -done - -#generate html index of shaarlis -htmlhead=' - - - - - My Shaarli farm - - - -
    -

    My Shaarli farm

    -
      ' - -accountlinks='' - -htmlfooter=' -
    -
    - -' - - - -for account in $accounts; do accountlinks="$accountlinks\n
  • $account
    • "; done -if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi -echo "[info] generating new index of shaarlis" -echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html" -echo '[info] done.' -echo "[info] list of accounts: $accounts" -echo "[info] contents of $shaarli_base_dir:" -tree -a -L 1 "$shaarli_base_dir" -``` - -This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/) \ No newline at end of file diff --git a/doc/md/Download-CSS-styles-from-an-OPML-list.md b/doc/md/Download-CSS-styles-from-an-OPML-list.md deleted file mode 100644 index 26b7fb3e..00000000 --- a/doc/md/Download-CSS-styles-from-an-OPML-list.md +++ /dev/null @@ -1,154 +0,0 @@ -###Download CSS styles for shaarlis listed in an opml file -Example php script: - -```php - - - - -/** - * Source: https://github.com/Riduidel - * Download css styles for shaarlis listed in an opml file - */ -define("SHAARLI_RSS_OPML", "https://www.ecirtam.net/shaarlirss/custom/people.opml"); - -define("THEMES_TEMP_FOLDER", "new_themes"); - -if(!file_exists(THEMES_TEMP_FOLDER)) { - mkdir(THEMES_TEMP_FOLDER); -} - -function siteUrl($pathInSite) { - $indexPos = strpos($pathInSite, "index.php"); - if(!$indexPos) { - return $pathInSite; - } else { - return substr($pathInSite, 0, $indexPos); - } -} - -function createShaarliHashFromOPMLL($opmlFile) { - $result = array(); - $opml = file_get_contents($opmlFile); - $opmlXml = simplexml_load_string($opml); - $outlineElements = $opmlXml->xpath("body/outline"); - foreach($outlineElements as $site) { - $siteUrl = siteUrl((string) $site['htmlUrl']); - $result[$siteUrl]=((string) $site['text']); - } - return $result; -} - -function getSiteFolder($url) { - $domain = parse_url($url, PHP_URL_HOST); - return THEMES_TEMP_FOLDER."/".str_replace(".", "_", $domain); -} - -function get_http_response_code($theURL) { - $headers = get_headers($theURL); - return substr($headers[0], 9, 3); -} - -/** - * This makes the code PHP-5 only (particularly the call to "get_headers") - */ -function copyUserStyleFrom($url, $name, $knownStyles) { - $userStyle = $url."inc/user.css"; - if(in_array($url, $knownStyles)) { - // TODO add log message - } else { - $statusCode = get_http_response_code($userStyle); - if(intval($statusCode)<300) { - $styleSheet = file_get_contents($userStyle); - $siteFolder = getSiteFolder($url); - if(!file_exists($siteFolder)) { - mkdir($siteFolder); - } - if(!file_exists($siteFolder.'/user.css')) { - // Copy stylesheet - file_put_contents($siteFolder.'/user.css', $styleSheet); - } - if(!file_exists($siteFolder.'/README.md')) { - // Then write a readme.md file - file_put_contents($siteFolder.'/README.md', - "User style from ".$name."\n" - ."=============================" - ."\n\n" - ."This stylesheet was downloaded from ".$userStyle." on ".date(DATE_RFC822) - ); - } - if(!file_exists($siteFolder.'/config.ini')) { - // Write a config file containing useful informations - file_put_contents($siteFolder.'/config.ini', - "site_url=".$url."\n" - ."site_name=".$name."\n" - ); - } - if(!file_exists($siteFolder.'/home.png')) { - // And finally copy generated thumbnail - $homeThumb = $siteFolder.'/home.png'; - file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url))); - } - echo 'Theme have been downloaded from '.$url.' into '.$siteFolder - .'. It looks like
    '; - } - } -} - -function getThumbnailUrl($url) { - return 'http://api.webthumbnail.org/?url='.$url; -} - -function copyUserStylesFrom($urlToNames, $knownStyles) { - foreach($urlToNames as $url => $name) { - copyUserStyleFrom($url, $name, $knownStyles); - } -} - -/** - * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/ - * @param directory the directory we want to list files of - * @return a simple array containing the list of absolute file paths. Notice that current file (".") and parent one("..") - * are not listed here - */ -function getDirectoryList ($directory) { - $realPath = realpath($directory); - // create an array to hold directory list - $results = array(); - // create a handler for the directory - $handler = opendir($directory); - // open directory and walk through the filenames - while ($file = readdir($handler)) { - // if file isn't this directory or its parent, add it to the results - if ($file != "." && $file != "..") { - $results[] = realpath($realPath . "/" . $file); - } - } - // tidy up: close the handler - closedir($handler); - // done! - return $results; -} - -/** - * Start in themes folder and look in all subfolders for config.ini files. - * These config.ini files allow us not to download styles again and again - */ -function findKnownStyles() { - $result = array(); - $subFolders = getDirectoryList("themes"); - foreach($subFolders as $folder) { - $configFile = $folder."/config.ini"; - if(file_exists($configFile)) { - $iniParameters = parse_ini_file($configFile); - array_push($result, $iniParameters['site_url']); - } - } - return $result; -} - -$knownStyles = findKnownStyles(); -copyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles); - - -``` \ No newline at end of file diff --git a/doc/md/Example-patch---add-new-via-field-for-links.md b/doc/md/Example-patch---add-new-via-field-for-links.md deleted file mode 100644 index d84ef25a..00000000 --- a/doc/md/Example-patch---add-new-via-field-for-links.md +++ /dev/null @@ -1,189 +0,0 @@ -Example patch to add a new field ("via") for links, an input field to set the "via" property from the "edit link" dialog, and display the "via" field in the link list display. **Untested, use at your own risk** - -Thanks to @Knah-Tsaeb in https://github.com/sebsauvage/Shaarli/pull/158 - -``` -From e0f363c18e8fe67990ed2bb1a08652e24e70bbcb Mon Sep 17 00:00:00 2001 -From: Knah Tsaeb -Date: Fri, 11 Oct 2013 15:18:37 +0200 -Subject: [PATCH] Add a "via"/origin property for links, add new input in "edit link" dialog -Thanks to: -* https://github.com/Knah-Tsaeb/Shaarli/commit/040eb18ec8cdabd5ea855e108f81f97fbf0478c4 -* https://github.com/Knah-Tsaeb/Shaarli/commit/4123658eae44d7564d1128ce52ddd5689efee813 -* https://github.com/Knah-Tsaeb/Shaarli/commit/f1a8ca9cc8fe49b119d51b2d8382cc1a34542f96 - ---- - index.php | 43 ++++++++++++++++++++++++++++++++----------- - tpl/editlink.html | 1 + - tpl/linklist.html | 1 + - 3 files changed, 34 insertions(+), 11 deletions(-) - -diff --git a/index.php b/index.php -index 6fae2f8..53f798e 100644 ---- a/index.php -+++ b/index.php -@@ -436,6 +436,12 @@ if (isset($_POST['login'])) - // ------------------------------------------------------------------------------------------ - // Misc utility functions: - -+// Try to get just domain for @via -+function getJustDomain($url){ -+ $parts = parse_url($url); -+ return trim($parts['host']); -+ } -+ - // Returns the server URL (including port and http/https), without path. - // e.g. "http://myserver.com:8080" - // You can append $_SERVER['SCRIPT_NAME'] to get the current script URL. -@@ -799,7 +805,8 @@ class linkdb implements Iterator, Countable, ArrayAccess - $found= (strpos(strtolower($l['title']),$s)!==false) - || (strpos(strtolower($l['description']),$s)!==false) - || (strpos(strtolower($l['url']),$s)!==false) -- || (strpos(strtolower($l['tags']),$s)!==false); -+ || (strpos(strtolower($l['tags']),$s)!==false) -+ || (!empty($l['via']) && (strpos(strtolower($l['via']),$s)!==false)); - if ($found) $filtered[$l['linkdate']] = $l; - } - krsort($filtered); -@@ -814,7 +821,7 @@ class linkdb implements Iterator, Countable, ArrayAccess - $t = str_replace(',',' ',($casesensitive?$tags:strtolower($tags))); - $searchtags=explode(' ',$t); - $filtered=array(); -- foreach($this->links as $l) -+ foreach($this-> links as $l) - { - $linktags = explode(' ',($casesensitive?$l['tags']:strtolower($l['tags']))); - if (count(array_intersect($linktags,$searchtags)) == count($searchtags)) -@@ -905,7 +912,7 @@ function showRSS() - else $linksToDisplay = $LINKSDB; - $nblinksToDisplay = 50; // Number of links to display. - if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links. -- { -+ { - $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ; - } - -@@ -944,7 +951,12 @@ function showRSS() - // If user wants permalinks first, put the final link in description - if ($usepermalinks===true) $descriptionlink = '(Link)'; - if (strlen($link['description'])>0) $descriptionlink = '
    '.$descriptionlink; -- echo ''."\n\n"; -+ if(!empty($link['via'])){ -+ $via = '
    Origine => '.htmlspecialchars(getJustDomain($link['via'])).''; -+ } else { -+ $via = ''; -+ } -+ echo ''."\n\n"; - $i++; - } - echo ''; -@@ -980,7 +992,7 @@ function showATOM() - else $linksToDisplay = $LINKSDB; - $nblinksToDisplay = 50; // Number of links to display. - if (!empty($_GET['nb'])) // In URL, you can specificy the number of links. Example: nb=200 or nb=all for all links. -- { -+ { - $nblinksToDisplay = $_GET['nb']=='all' ? count($linksToDisplay) : max($_GET['nb']+0,1) ; - } - -@@ -1006,11 +1018,16 @@ function showATOM() - - // Add permalink in description - $descriptionlink = htmlspecialchars('(Permalink)'); -+ if(isset($link['via']) && !empty($link['via'])){ -+ $via = htmlspecialchars('
    Origine => '.getJustDomain($link['via']).''); -+ } else { -+ $via = ''; -+ } - // If user wants permalinks first, put the final link in description - if ($usepermalinks===true) $descriptionlink = htmlspecialchars('(Link)'); - if (strlen($link['description'])>0) $descriptionlink = '<br>'.$descriptionlink; - -- $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink."\n"; -+ $entries.=''.htmlspecialchars(nl2br(keepMultipleSpaces(text2clickable(htmlspecialchars($link['description']))))).$descriptionlink.$via."\n"; - if ($link['tags']!='') // Adding tags to each ATOM entry (as mentioned in ATOM specification) - { - foreach(explode(' ',$link['tags']) as $tag) -@@ -1478,7 +1495,7 @@ function renderPage() - if (!startsWith($url,'http:') && !startsWith($url,'https:') && !startsWith($url,'ftp:') && !startsWith($url,'magnet:') && !startsWith($url,'?')) - $url = 'http://'.$url; - $link = array('title'=>trim($_POST['lf_title']),'url'=>$url,'description'=>trim($_POST['lf_description']),'private'=>(isset($_POST['lf_private']) ? 1 : 0), -- 'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags)); -+ 'linkdate'=>$linkdate,'tags'=>str_replace(',',' ',$tags), 'via'=>trim($_POST['lf_via'])); - if ($link['title']=='') $link['title']=$link['url']; // If title is empty, use the URL as title. - $LINKSDB[$linkdate] = $link; - $LINKSDB->savedb(); // Save to disk. -@@ -1556,7 +1573,8 @@ function renderPage() - $title = (empty($_GET['title']) ? '' : $_GET['title'] ); // Get title if it was provided in URL (by the bookmarklet). - $description = (empty($_GET['description']) ? '' : $_GET['description']); // Get description if it was provided in URL (by the bookmarklet). [Bronco added that] - $tags = (empty($_GET['tags']) ? '' : $_GET['tags'] ); // Get tags if it was provided in URL -- $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL -+ $via = (empty($_GET['via']) ? '' : $_GET['via'] ); -+ $private = (!empty($_GET['private']) && $_GET['private'] === "1" ? 1 : 0); // Get private if it was provided in URL - if (($url!='') && parse_url($url,PHP_URL_SCHEME)=='') $url = 'http://'.$url; - // If this is an HTTP link, we try go get the page to extract the title (otherwise we will to straight to the edit form.) - if (empty($title) && parse_url($url,PHP_URL_SCHEME)=='http') -@@ -1567,7 +1585,7 @@ function renderPage() - { - // Look for charset in html header. - preg_match('##Usi', $data, $meta); -- -+ - // If found, extract encoding. - if (!empty($meta[0])) - { -@@ -1577,7 +1595,7 @@ function renderPage() - $html_charset = (!empty($enc[1])) ? strtolower($enc[1]) : 'utf-8'; - } - else { $html_charset = 'utf-8'; } -- -+ - // Extract title - $title = html_extract_title($data); - if (!empty($title)) -@@ -1592,7 +1610,7 @@ function renderPage() - $url='?'.smallHash($linkdate); - $title='Note: '; - } -- $link = array('linkdate'=>$linkdate,'title'=>$title,'url'=>$url,'description'=>$description,'tags'=>$tags,'private'=>$private); -+ $link = array('linkdate'=>$linkdate,'title'=>$title,'url'=>$url,'description'=>$description,'tags'=>$tags,'via' => $via,'private'=>$private); - } - - $PAGE = new pageBuilder; -@@ -1842,6 +1860,9 @@ function buildLinkList($PAGE,$LINKSDB) - $taglist = explode(' ',$link['tags']); - uasort($taglist, 'strcasecmp'); - $link['taglist']=$taglist; -+ if(!empty($link['via'])){ -+ $link['via']=htmlspecialchars($link['via']); -+ } - $linkDisp[$keys[$i]] = $link; - $i++; - } -diff --git a/tpl/editlink.html b/tpl/editlink.html -index 4a2c30c..14d4f9c 100644 ---- a/tpl/editlink.html -+++ b/tpl/editlink.html -@@ -16,6 +16,7 @@ - Title

    - Description

    - Tags

    -+ Origine

    - {if condition="($link_is_new && $GLOBALS['privateLinkByDefault']==true) || $link.private == true"} - -  
    -diff --git a/tpl/linklist.html b/tpl/linklist.html -index ddc38cb..0a8475f 100644 ---- a/tpl/linklist.html -+++ b/tpl/linklist.html -@@ -43,6 +43,7 @@ - {$value.title|htmlspecialchars} -
    - {if="$value.description"}
    {$value.description}
    {/if} -+ {if condition="isset($value.via) && !empty($value.via)"}{/if} - {if="!$GLOBALS['config']['HIDE_TIMESTAMPS'] || isLoggedIn()"} - {$value.localdate|htmlspecialchars} - permalink - - {else} --- -2.1.1 -``` \ No newline at end of file diff --git a/doc/md/Datastore-hacks.md b/doc/md/Various-hacks.md similarity index 65% rename from doc/md/Datastore-hacks.md rename to doc/md/Various-hacks.md index 78baa005..a4ae81f4 100644 --- a/doc/md/Datastore-hacks.md +++ b/doc/md/Various-hacks.md @@ -17,9 +17,17 @@ Alternatively, you can transform to JSON format (and pretty-print if you have `j php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace("!.*/\* (.+) \*/.*!", "$1", file_get_contents("data/datastore.php")))))));' | jq . ``` -### Changing the timestamp for a link +### Changing the timestamp for a shaare * Look for `` in `tpl/editlink.tpl` (line 14) * Replace `type="hidden"` with `type="text"` from this line * A new date/time field becomes available in the edit/new link dialog. * You can set the timestamp manually by entering it in the format `YYYMMDD_HHMMS`. + + +### See also + + * [Add a new custom field to shaares (example patch)](https://gist.github.com/nodiscc/8b0194921f059d7b9ad89a581ecd482c) + * [Download CSS styles for shaarlis listed in an opml file](https://gist.github.com/nodiscc/dede231c92cab22c3ad2cc24d5035012) + * [Copy an existing Shaarli installation over SSH, and serve it locally](https://gist.github.com/nodiscc/ed161c66e5b028b5299b0a3733d01c77) + * [Create multiple Shaarli instances, generate an HTML index of them](https://gist.github.com/nodiscc/52e711cda3bc47717c16065231cf6b20) \ No newline at end of file diff --git a/doc/md/_Sidebar.md b/doc/md/_Sidebar.md deleted file mode 100644 index fe0e4229..00000000 --- a/doc/md/_Sidebar.md +++ /dev/null @@ -1,45 +0,0 @@ -- [[Home]] -- Setup - - [[Download and Installation]] - - [[Upgrade and migration]] - - [[Server requirements]] - - [[Server configuration]] - - [[Server security]] - - [[Shaarli configuration]] - - [[Plugins]] -- Docker - - [[Docker 101]] - - [[Shaarli images]] - - [[Reverse proxy configuration]] - - [[Docker resources]] -- Usage - - [[Features]] - - [[Bookmarklet]] - - [[Browsing and Searching]] - - [[Firefox share]] - - [[RSS feeds]] - - [[REST API]] -- How To - - [[Backup, restore, import and export]] - - [[Copy an existing installation over SSH and serve it locally]] - - [[Create and serve multiple Shaarlis (farm)]] - - [[Download CSS styles from an OPML list]] - - [[Datastore hacks]] -- [[Troubleshooting]] -- Development: - - [[Development guidelines]] - - [[Continuous integration tools]] - - [[GnuPG signature]] - - [[Coding guidelines]] - - [[Directory structure]] - - [[3rd party libraries]] - - [[Plugin System]] - - [[Release Shaarli]] - - [[Versioning and Branches]] - - [[Security]] - - [[Static analysis]] - - [[Theming]] - - [[Unit tests]] -- About - - [[FAQ]] - - [[Community & Related software]] diff --git a/mkdocs.yml b/mkdocs.yml index f9648a7e..d6dd3fc2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -29,10 +29,7 @@ pages: - REST API: REST-API.md - How To: - Backup, restore, import and export: Backup,-restore,-import-and-export.md - - Copy an existing installation over SSH and serve it locally: Copy-an-existing-installation-over-SSH-and-serve-it-locally.md - - Create and serve multiple Shaarlis (farm): Create-and-serve-multiple-Shaarlis-(farm).md - - Download CSS styles from an OPML list: Download-CSS-styles-from-an-OPML-list.md - - Datastore hacks: Datastore-hacks.md + - Various hacks: Various-hacks.md - Troubleshooting: Troubleshooting.md - Development: - Development guidelines: Development-guidelines.md From 0433c688b9be6097b85a8fec31b3dacd0ab81677 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Sun, 18 Jun 2017 06:32:30 +0200 Subject: [PATCH 28/67] make htmlpages --- doc/html/3rd-party-libraries/index.html | 14 +- .../index.html | 18 +- doc/html/Bookmarklet/index.html | 14 +- doc/html/Browsing-and-searching/index.html | 14 +- doc/html/Coding-guidelines/index.html | 14 +- .../Community-&-Related-software/index.html | 14 +- .../Continuous-integration-tools/index.html | 14 +- .../index.html | 403 -------------- .../index.html | 396 -------------- doc/html/Development-guidelines/index.html | 14 +- doc/html/Directory-structure/index.html | 14 +- doc/html/Docker-101/index.html | 14 +- doc/html/Docker-resources/index.html | 14 +- .../index.html | 496 ------------------ doc/html/Download-and-Installation/index.html | 14 +- doc/html/FAQ/index.html | 14 +- doc/html/Features/index.html | 14 +- doc/html/Firefox-share/index.html | 14 +- doc/html/GnuPG-signature/index.html | 14 +- doc/html/Plugin-System/index.html | 14 +- doc/html/Plugins/index.html | 14 +- doc/html/REST-API/index.html | 14 +- doc/html/RSS-feeds/index.html | 14 +- doc/html/Release-Shaarli/index.html | 14 +- .../Reverse-proxy-configuration/index.html | 14 +- doc/html/Security/index.html | 14 +- doc/html/Server-configuration/index.html | 14 +- doc/html/Server-requirements/index.html | 14 +- doc/html/Server-security/index.html | 14 +- doc/html/Shaarli-configuration/index.html | 14 +- doc/html/Shaarli-images/index.html | 14 +- doc/html/Static-analysis/index.html | 14 +- doc/html/Theming/index.html | 14 +- doc/html/Troubleshooting/index.html | 18 +- doc/html/Unit-tests/index.html | 14 +- doc/html/Upgrade-and-migration/index.html | 14 +- .../index.html | 44 +- doc/html/Versioning-and-Branches/index.html | 14 +- doc/html/index.html | 16 +- doc/html/mkdocs/search_index.json | 37 +- doc/html/search.html | 14 +- doc/html/sitemap.xml | 20 +- doc/md/Browsing-and-searching.md | 2 +- doc/md/Community-&-Related-software.md | 2 +- doc/md/Continuous-integration-tools.md | 8 +- doc/md/Development-guidelines.md | 6 +- doc/md/Firefox-share.md | 2 +- doc/md/GnuPG-signature.md | 2 +- doc/md/Theming.md | 4 +- doc/md/Upgrade-and-migration.md | 10 +- 50 files changed, 92 insertions(+), 1854 deletions(-) delete mode 100644 doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html delete mode 100644 doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html delete mode 100644 doc/html/Download-CSS-styles-from-an-OPML-list/index.html rename doc/html/{Datastore-hacks => Various-hacks}/index.html (88%) diff --git a/doc/html/3rd-party-libraries/index.html b/doc/html/3rd-party-libraries/index.html index c54c45f5..0d62007d 100644 --- a/doc/html/3rd-party-libraries/index.html +++ b/doc/html/3rd-party-libraries/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Backup,-restore,-import-and-export/index.html b/doc/html/Backup,-restore,-import-and-export/index.html index ceb80170..33ec9124 100644 --- a/doc/html/Backup,-restore,-import-and-export/index.html +++ b/doc/html/Backup,-restore,-import-and-export/index.html @@ -179,19 +179,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • @@ -367,7 +355,7 @@ diff --git a/doc/html/Bookmarklet/index.html b/doc/html/Bookmarklet/index.html index e7a370b6..325d305a 100644 --- a/doc/html/Bookmarklet/index.html +++ b/doc/html/Bookmarklet/index.html @@ -164,19 +164,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Browsing-and-searching/index.html b/doc/html/Browsing-and-searching/index.html index 459f07c7..c8b7386e 100644 --- a/doc/html/Browsing-and-searching/index.html +++ b/doc/html/Browsing-and-searching/index.html @@ -164,19 +164,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Coding-guidelines/index.html b/doc/html/Coding-guidelines/index.html index be2bf7e8..dfcdd45c 100644 --- a/doc/html/Coding-guidelines/index.html +++ b/doc/html/Coding-guidelines/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Community-&-Related-software/index.html b/doc/html/Community-&-Related-software/index.html index 1de704a3..2497433c 100644 --- a/doc/html/Community-&-Related-software/index.html +++ b/doc/html/Community-&-Related-software/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Continuous-integration-tools/index.html b/doc/html/Continuous-integration-tools/index.html index c889a963..339f37ac 100644 --- a/doc/html/Continuous-integration-tools/index.html +++ b/doc/html/Continuous-integration-tools/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html b/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html deleted file mode 100644 index 4aea480d..00000000 --- a/doc/html/Copy-an-existing-installation-over-SSH-and-serve-it-locally/index.html +++ /dev/null @@ -1,403 +0,0 @@ - - - - - - - - - - - Copy an existing installation over SSH and serve it locally - Shaarli Documentation - - - - - - - - - - - - - - - - - -
    - - - - -
    - - - - - -
    -
    -
    -
      -
    • Docs »
      • - - - -
    • How To »
      • - - - -
    • Copy an existing installation over SSH and serve it locally
      • -
    • - - Edit on GitHub - -
      • -
    -
    -
    -
    -
    - -

    Example bash script:

    -
    #!/bin/bash
-#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli
-#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally.
-#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli
-#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed
-#Usage: ./local-shaarli.sh
-#Author: nodiscc (nodiscc@gmail.com)
-#License: MIT (http://opensource.org/licenses/MIT)
-set -o errexit
-set -o nounset
-
-##### CONFIG #################
-#The port used by php's local server
-php_local_port=7431
-
-#Name of the SSH server and path where Shaarli is installed
-#TODO: pass these as command-line arguments
-remotehost="my.ssh.server"
-remote_shaarli_dir="/var/www/shaarli"
-
-
-###### FUNCTIONS #############
-_main() {
-    _CBSyncShaarli
-    _CBServeShaarli
-}
-
-_CBSyncShaarli() {
-    remote_temp_dir=$(ssh $remotehost mktemp -d)
-    remote_ssh_user=$(ssh $remotehost whoami)
-    ssh -t "$remotehost" sudo cp -r "$remote_shaarli_dir" "$remote_temp_dir"
-    ssh -t "$remotehost" sudo chown -R "$remote_ssh_user":"$remote_ssh_user" "$remote_temp_dir"
-    scp -rq "$remotehost":"$remote_temp_dir" local-shaarli
-    ssh "$remotehost" rm -r "$remote_temp_dir"
-}
-
-_CBServeShaarli() {
-    #TODO: allow serving a previously downloaded Shaarli
-    #TODO: ask before overwriting local copy, if it exists
-    cd local-shaarli/
-    php -S localhost:${php_local_port}
-    echo "Please go to http://localhost:${php_local_port}"
-}
-
-
-##### MAIN #################
-
-_main
-
    - -

    This outputs:

    -
    $ ./local-shaarli.sh
-PHP 5.6.0RC4 Development Server started at Mon Sep  1 21:56:19 2014
-Listening on http://localhost:7431
-Document root is /home/user/local-shaarli/shaarli
-Press Ctrl-C to quit.
-
-[Mon Sep  1 21:56:27 2014] ::1:57868 [200]: /
-[Mon Sep  1 21:56:27 2014] ::1:57869 [200]: /index.html
-[Mon Sep  1 21:56:37 2014] ::1:57881 [200]: /...
-
    - -
    -
    - - -
    -
    - -
    - -
    - -
    - - - GitHub - - - « Previous - - - Next » - - -
    - - - - diff --git a/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html b/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html deleted file mode 100644 index 98d8992e..00000000 --- a/doc/html/Create-and-serve-multiple-Shaarlis-(farm)/index.html +++ /dev/null @@ -1,396 +0,0 @@ - - - - - - - - - - - Create and serve multiple Shaarlis (farm) - Shaarli Documentation - - - - - - - - - - - - - - - - - -
    - - - - -
    - - - - - -
    -
    -
    -
      -
    • Docs »
      • - - - -
    • How To »
      • - - - -
    • Create and serve multiple Shaarlis (farm)
      • -
    • - - Edit on GitHub - -
      • -
    -
    -
    -
    -
    - -

    Example bash script (creates multiple shaarli instances and generates an HTML index of them)

    -
    #!/bin/bash
-set -o errexit
-set -o nounset
-
-#config
-shaarli_base_dir='/var/www/shaarli'
-accounts='bob john whatever username'
-shaarli_repo_url='https://github.com/shaarli/Shaarli'
-ref="master"
-
-#clone multiple shaarli instances
-if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi
-
-for account in $accounts; do
-    if [ -d "$shaarli_base_dir/$account" ];
-    then echo "[info] account $account already exists, skipping";
-    else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi
-done
-
-#generate html index of shaarlis
-htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
-<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
-<html lang="en">
-    <head>
-        <meta http-equiv="content-type" content="text/html; charset=utf-8">
-        <title>My Shaarli farm</title>
-        <style>body {font-family: "Open Sans"}</style>
-    </head>
-    <body>
-    <div>
-    <h1>My Shaarli farm</h1>
-    <ul style="list-style-type: none;">'
-
-accountlinks=''
-
-htmlfooter='
-    </ul>
-    </div>
-    </body>
-</html>'    
-
-
-
-for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
-if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi
-echo "[info] generating new index of shaarlis"
-echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
-echo '[info] done.'
-echo "[info] list of accounts: $accounts"
-echo "[info] contents of $shaarli_base_dir:"
-tree -a -L 1 "$shaarli_base_dir"
-
    - -

    This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like Ansible

    - -
    -
    - - -
    -
    - -
    - -
    - -
    - - - GitHub - - - « Previous - - - Next » - - -
    - - - - diff --git a/doc/html/Development-guidelines/index.html b/doc/html/Development-guidelines/index.html index 747d53a8..e75c911b 100644 --- a/doc/html/Development-guidelines/index.html +++ b/doc/html/Development-guidelines/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Directory-structure/index.html b/doc/html/Directory-structure/index.html index 82979774..ff075ec5 100644 --- a/doc/html/Directory-structure/index.html +++ b/doc/html/Directory-structure/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Docker-101/index.html b/doc/html/Docker-101/index.html index 5b4f645c..31e57b59 100644 --- a/doc/html/Docker-101/index.html +++ b/doc/html/Docker-101/index.html @@ -168,19 +168,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Docker-resources/index.html b/doc/html/Docker-resources/index.html index 7bd7067d..169a0297 100644 --- a/doc/html/Docker-resources/index.html +++ b/doc/html/Docker-resources/index.html @@ -164,19 +164,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Download-CSS-styles-from-an-OPML-list/index.html b/doc/html/Download-CSS-styles-from-an-OPML-list/index.html deleted file mode 100644 index e697b39d..00000000 --- a/doc/html/Download-CSS-styles-from-an-OPML-list/index.html +++ /dev/null @@ -1,496 +0,0 @@ - - - - - - - - - - - Download CSS styles from an OPML list - Shaarli Documentation - - - - - - - - - - - - - - - - - -
    - - - - -
    - - - - - -
    -
    -
    -
      -
    • Docs »
      • - - - -
    • How To »
      • - - - -
    • Download CSS styles from an OPML list
      • -
    • - - Edit on GitHub - -
      • -
    -
    -
    -
    -
    - -

    Download CSS styles for shaarlis listed in an opml file

    -

    Example php script:

    -
    <!---- ?php -->
-<!---- Copyright (c) 2014 Nicolas Delsaux (https://github.com/Riduidel) -->
-<!---- License: zlib (http://www.gzip.org/zlib/zlib_license.html) -->
-
-/**
- * Source: https://github.com/Riduidel
- * Download css styles for shaarlis listed in an opml file
- */
-define("SHAARLI_RSS_OPML", "https://www.ecirtam.net/shaarlirss/custom/people.opml");
-
-define("THEMES_TEMP_FOLDER", "new_themes");
-
-if(!file_exists(THEMES_TEMP_FOLDER)) {
-    mkdir(THEMES_TEMP_FOLDER);
-}
-
-function siteUrl($pathInSite) {
-    $indexPos = strpos($pathInSite, "index.php");
-    if(!$indexPos) {
-        return $pathInSite;
-    } else {
-        return substr($pathInSite, 0, $indexPos);
-    }
-}
-
-function createShaarliHashFromOPMLL($opmlFile) {
-    $result = array();
-    $opml = file_get_contents($opmlFile);
-    $opmlXml = simplexml_load_string($opml);
-    $outlineElements = $opmlXml->xpath("body/outline");
-    foreach($outlineElements as $site) {
-        $siteUrl = siteUrl((string) $site['htmlUrl']);
-        $result[$siteUrl]=((string) $site['text']);
-    }
-    return $result;
-}
-
-function getSiteFolder($url) {
-    $domain = parse_url($url,  PHP_URL_HOST);
-    return THEMES_TEMP_FOLDER."/".str_replace(".", "_", $domain);
-}
-
-function get_http_response_code($theURL) {
-     $headers = get_headers($theURL);
-     return substr($headers[0], 9, 3);
-}
-
-/**
- * This makes the code PHP-5 only (particularly the call to "get_headers")
- */
-function copyUserStyleFrom($url, $name, $knownStyles) {
-    $userStyle = $url."inc/user.css";
-    if(in_array($url, $knownStyles)) {
-        // TODO add log message
-    } else {
-        $statusCode = get_http_response_code($userStyle);
-        if(intval($statusCode)<300) {
-            $styleSheet = file_get_contents($userStyle);
-            $siteFolder = getSiteFolder($url);
-            if(!file_exists($siteFolder)) {
-                mkdir($siteFolder);
-            }
-            if(!file_exists($siteFolder.'/user.css')) {
-                // Copy stylesheet
-                file_put_contents($siteFolder.'/user.css', $styleSheet);
-            }
-            if(!file_exists($siteFolder.'/README.md')) {
-                // Then write a readme.md file
-                file_put_contents($siteFolder.'/README.md', 
-                    "User style from ".$name."\n"
-                    ."============================="
-                    ."\n\n"
-                    ."This stylesheet was downloaded from ".$userStyle." on ".date(DATE_RFC822)
-                    );
-            }
-            if(!file_exists($siteFolder.'/config.ini')) {
-                // Write a config file containing useful informations
-                file_put_contents($siteFolder.'/config.ini', 
-                    "site_url=".$url."\n"
-                    ."site_name=".$name."\n"
-                    );
-            }
-            if(!file_exists($siteFolder.'/home.png')) {
-                // And finally copy generated thumbnail
-                $homeThumb = $siteFolder.'/home.png';
-                file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));
-            }
-            echo 'Theme have been downloaded from  <a href="'.$url.'">'.$url.'</a> into '.$siteFolder
-                .'. It looks like <img src="'.$homeThumb.'"><br/>';
-        }
-    }
-}
-
-function getThumbnailUrl($url) {
-    return 'http://api.webthumbnail.org/?url='.$url;
-}
-
-function copyUserStylesFrom($urlToNames, $knownStyles) {
-    foreach($urlToNames as $url => $name) {
-        copyUserStyleFrom($url, $name, $knownStyles);
-    }
-}
-
-/**
- * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/
- * @param directory the directory we want to list files of
- * @return a simple array containing the list of absolute file paths. Notice that current file (".") and parent one("..")
- * are not listed here
- */
-function getDirectoryList ($directory)  {
-    $realPath = realpath($directory);
-    // create an array to hold directory list
-    $results = array();
-    // create a handler for the directory
-    $handler = opendir($directory);
-    // open directory and walk through the filenames
-    while ($file = readdir($handler)) {
-        // if file isn't this directory or its parent, add it to the results
-        if ($file != "." && $file != "..") {
-            $results[] = realpath($realPath . "/" . $file);
-        }
-    }
-    // tidy up: close the handler
-    closedir($handler);
-    // done!
-    return $results;
-}
-
-/**
- * Start in themes folder and look in all subfolders for config.ini files. 
- * These config.ini files allow us not to download styles again and again
- */
-function findKnownStyles() {
-    $result = array();
-    $subFolders = getDirectoryList("themes");
-    foreach($subFolders as $folder) {
-        $configFile = $folder."/config.ini";
-        if(file_exists($configFile)) {
-            $iniParameters = parse_ini_file($configFile);
-            array_push($result, $iniParameters['site_url']);
-        }
-    }
-    return $result;
-}
-
-$knownStyles = findKnownStyles();
-copyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);
-
-<!--- ? ---->
-
    - -
    -
    - - -
    -
    - -
    - -
    - -
    - - - GitHub - - - « Previous - - - Next » - - -
    - - - - diff --git a/doc/html/Download-and-Installation/index.html b/doc/html/Download-and-Installation/index.html index 1ede1d68..92342681 100644 --- a/doc/html/Download-and-Installation/index.html +++ b/doc/html/Download-and-Installation/index.html @@ -186,19 +186,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/FAQ/index.html b/doc/html/FAQ/index.html index c48e11f8..f8ced260 100644 --- a/doc/html/FAQ/index.html +++ b/doc/html/FAQ/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Features/index.html b/doc/html/Features/index.html index 453f189a..e847c546 100644 --- a/doc/html/Features/index.html +++ b/doc/html/Features/index.html @@ -161,19 +161,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Firefox-share/index.html b/doc/html/Firefox-share/index.html index c0aaf4bd..9c028ffc 100644 --- a/doc/html/Firefox-share/index.html +++ b/doc/html/Firefox-share/index.html @@ -161,19 +161,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/GnuPG-signature/index.html b/doc/html/GnuPG-signature/index.html index 781ccd2d..0b2d842a 100644 --- a/doc/html/GnuPG-signature/index.html +++ b/doc/html/GnuPG-signature/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Plugin-System/index.html b/doc/html/Plugin-System/index.html index 5ee0f6c1..dbed5908 100644 --- a/doc/html/Plugin-System/index.html +++ b/doc/html/Plugin-System/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Plugins/index.html b/doc/html/Plugins/index.html index 3a30e93c..4b63681e 100644 --- a/doc/html/Plugins/index.html +++ b/doc/html/Plugins/index.html @@ -173,19 +173,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/REST-API/index.html b/doc/html/REST-API/index.html index 2c244bca..6e2c9518 100644 --- a/doc/html/REST-API/index.html +++ b/doc/html/REST-API/index.html @@ -169,19 +169,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/RSS-feeds/index.html b/doc/html/RSS-feeds/index.html index bb6e412c..a4b7339f 100644 --- a/doc/html/RSS-feeds/index.html +++ b/doc/html/RSS-feeds/index.html @@ -161,19 +161,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Release-Shaarli/index.html b/doc/html/Release-Shaarli/index.html index cf5fcee8..92433203 100644 --- a/doc/html/Release-Shaarli/index.html +++ b/doc/html/Release-Shaarli/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Reverse-proxy-configuration/index.html b/doc/html/Reverse-proxy-configuration/index.html index bebd663f..f573c5cd 100644 --- a/doc/html/Reverse-proxy-configuration/index.html +++ b/doc/html/Reverse-proxy-configuration/index.html @@ -161,19 +161,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Security/index.html b/doc/html/Security/index.html index 19b569e6..c7aec584 100644 --- a/doc/html/Security/index.html +++ b/doc/html/Security/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Server-configuration/index.html b/doc/html/Server-configuration/index.html index beb8cd08..6e798b4b 100644 --- a/doc/html/Server-configuration/index.html +++ b/doc/html/Server-configuration/index.html @@ -207,19 +207,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Server-requirements/index.html b/doc/html/Server-requirements/index.html index ab1b0d35..f3bfa185 100644 --- a/doc/html/Server-requirements/index.html +++ b/doc/html/Server-requirements/index.html @@ -170,19 +170,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Server-security/index.html b/doc/html/Server-security/index.html index dbe99515..6d9f25c0 100644 --- a/doc/html/Server-security/index.html +++ b/doc/html/Server-security/index.html @@ -176,19 +176,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Shaarli-configuration/index.html b/doc/html/Shaarli-configuration/index.html index 95a487d0..4e556061 100644 --- a/doc/html/Shaarli-configuration/index.html +++ b/doc/html/Shaarli-configuration/index.html @@ -192,19 +192,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Shaarli-images/index.html b/doc/html/Shaarli-images/index.html index 0fa93ca3..4a1cf66b 100644 --- a/doc/html/Shaarli-images/index.html +++ b/doc/html/Shaarli-images/index.html @@ -172,19 +172,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Static-analysis/index.html b/doc/html/Static-analysis/index.html index 0dfb5519..ddd81f86 100644 --- a/doc/html/Static-analysis/index.html +++ b/doc/html/Static-analysis/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Theming/index.html b/doc/html/Theming/index.html index 70a36dd4..670dbb80 100644 --- a/doc/html/Theming/index.html +++ b/doc/html/Theming/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Troubleshooting/index.html b/doc/html/Troubleshooting/index.html index ed1c433d..f1564362 100644 --- a/doc/html/Troubleshooting/index.html +++ b/doc/html/Troubleshooting/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • @@ -400,7 +388,7 @@

    pubsubhubbub support

    Next - Previous + Previous
    @@ -428,7 +416,7 @@

    pubsubhubbub support

    GitHub - « Previous + « Previous Next » diff --git a/doc/html/Unit-tests/index.html b/doc/html/Unit-tests/index.html index 84580db4..ce90ed10 100644 --- a/doc/html/Unit-tests/index.html +++ b/doc/html/Unit-tests/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Upgrade-and-migration/index.html b/doc/html/Upgrade-and-migration/index.html index 642942bf..3319fa72 100644 --- a/doc/html/Upgrade-and-migration/index.html +++ b/doc/html/Upgrade-and-migration/index.html @@ -191,19 +191,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/Datastore-hacks/index.html b/doc/html/Various-hacks/index.html similarity index 88% rename from doc/html/Datastore-hacks/index.html rename to doc/html/Various-hacks/index.html index b3d8d97e..b06207ae 100644 --- a/doc/html/Datastore-hacks/index.html +++ b/doc/html/Various-hacks/index.html @@ -8,7 +8,7 @@ - Datastore hacks - Shaarli Documentation + Various hacks - Shaarli Documentation @@ -18,9 +18,9 @@ @@ -149,28 +149,19 @@
  • Backup, restore, import and export -
    • -
  • - - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list
  • - Datastore hacks + Various hacks @@ -283,10 +274,10 @@ -
  • Datastore hacks
    • +
  • Various hacks
  • - Edit on GitHub
    • @@ -311,12 +302,19 @@

    Decode datastore content

    php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace("!.*/\* (.+) \*/.*!", "$1", file_get_contents("data/datastore.php")))))));' | jq .
    - +

    Changing the timestamp for a shaare

    • Look for <input type="hidden" name="lf_linkdate" value="{$link.linkdate}"> in tpl/editlink.tpl (line 14)
    • Replace type="hidden" with type="text" from this line
    • A new date/time field becomes available in the edit/new link dialog.
    • You can set the timestamp manually by entering it in the format YYYMMDD_HHMMS.
      • +
    +

    See also

    +
    @@ -328,7 +326,7 @@ Next - Previous + Previous
    @@ -356,7 +354,7 @@ GitHub - « Previous + « Previous Next » diff --git a/doc/html/Versioning-and-Branches/index.html b/doc/html/Versioning-and-Branches/index.html index 406ad7f9..97bdb47e 100644 --- a/doc/html/Versioning-and-Branches/index.html +++ b/doc/html/Versioning-and-Branches/index.html @@ -152,19 +152,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/index.html b/doc/html/index.html index a9b0c7b9..e6d4ef78 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -155,19 +155,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • @@ -340,5 +328,5 @@ diff --git a/doc/html/mkdocs/search_index.json b/doc/html/mkdocs/search_index.json index 2222a95b..7ef1837c 100644 --- a/doc/html/mkdocs/search_index.json +++ b/doc/html/mkdocs/search_index.json @@ -691,39 +691,24 @@ "title": "Import Shaarli links to Firefox" }, { - "location": "/Copy-an-existing-installation-over-SSH-and-serve-it-locally/", - "text": "Example bash script:\n\n\n#!/bin/bash\n#Description: Copy a Shaarli installation over SSH/SCP, serve it locally with php-cli\n#Will create a local-shaarli/ directory when you run it, backup your Shaarli there, and serve it locally.\n#Will NOT download linked pages. It's just a directly usable backup/copy/mirror of your Shaarli\n#Requires: ssh, scp and a working SSH access to the server where your Shaarli is installed\n#Usage: ./local-shaarli.sh\n#Author: nodiscc (nodiscc@gmail.com)\n#License: MIT (http://opensource.org/licenses/MIT)\nset -o errexit\nset -o nounset\n\n##### CONFIG #################\n#The port used by php's local server\nphp_local_port=7431\n\n#Name of the SSH server and path where Shaarli is installed\n#TODO: pass these as command-line arguments\nremotehost=\"my.ssh.server\"\nremote_shaarli_dir=\"/var/www/shaarli\"\n\n\n###### FUNCTIONS #############\n_main() {\n _CBSyncShaarli\n _CBServeShaarli\n}\n\n_CBSyncShaarli() {\n remote_temp_dir=$(ssh $remotehost mktemp -d)\n remote_ssh_user=$(ssh $remotehost whoami)\n ssh -t \"$remotehost\" sudo cp -r \"$remote_shaarli_dir\" \"$remote_temp_dir\"\n ssh -t \"$remotehost\" sudo chown -R \"$remote_ssh_user\":\"$remote_ssh_user\" \"$remote_temp_dir\"\n scp -rq \"$remotehost\":\"$remote_temp_dir\" local-shaarli\n ssh \"$remotehost\" rm -r \"$remote_temp_dir\"\n}\n\n_CBServeShaarli() {\n #TODO: allow serving a previously downloaded Shaarli\n #TODO: ask before overwriting local copy, if it exists\n cd local-shaarli/\n php -S localhost:${php_local_port}\n echo \"Please go to http://localhost:${php_local_port}\"\n}\n\n\n##### MAIN #################\n\n_main\n\n\n\n\nThis outputs:\n\n\n$ ./local-shaarli.sh\nPHP 5.6.0RC4 Development Server started at Mon Sep 1 21:56:19 2014\nListening on http://localhost:7431\nDocument root is /home/user/local-shaarli/shaarli\nPress Ctrl-C to quit.\n\n[Mon Sep 1 21:56:27 2014] ::1:57868 [200]: /\n[Mon Sep 1 21:56:27 2014] ::1:57869 [200]: /index.html\n[Mon Sep 1 21:56:37 2014] ::1:57881 [200]: /...", - "title": "Copy an existing installation over SSH and serve it locally" + "location": "/Various-hacks/", + "text": "Decode datastore content\n\n\nTo display the array representing the data saved in \ndata/datastore.php\n, use the following snippet:\n\n\n$data = \"tZNdb9MwFIb... \";\n$out = unserialize(gzinflate(base64_decode($data)));\necho \"
    \"; // Pretty printing is love, pretty printing is life\nprint_r($out);\necho \"
    \";\nexit;\n\n\n\n\nThis will output the internal representation of the datastore, \"unobfuscated\" (if this can really be considered obfuscation).\n\n\nAlternatively, you can transform to JSON format (and pretty-print if you have \njq\n installed):\n\n\nphp -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace(\"!.*/\\* (.+) \\*/.*!\", \"$1\", file_get_contents(\"data/datastore.php\")))))));' | jq .\n\n\n\n\nChanging the timestamp for a shaare\n\n\n\n\nLook for \n\n in \ntpl/editlink.tpl\n (line 14)\n\n\nReplace \ntype=\"hidden\"\n with \ntype=\"text\"\n from this line\n\n\nA new date/time field becomes available in the edit/new link dialog.\n\n\nYou can set the timestamp manually by entering it in the format \nYYYMMDD_HHMMS\n.\n\n\n\n\nSee also\n\n\n\n\nAdd a new custom field to shaares (example patch)\n\n\nDownload CSS styles for shaarlis listed in an opml file\n\n\nCopy an existing Shaarli installation over SSH, and serve it locally\n\n\nCreate multiple Shaarli instances, generate an HTML index of them", + "title": "Various hacks" }, { - "location": "/Create-and-serve-multiple-Shaarlis-(farm)/", - "text": "Example bash script (creates multiple shaarli instances and generates an HTML index of them)\n\n\n#!/bin/bash\nset -o errexit\nset -o nounset\n\n#config\nshaarli_base_dir='/var/www/shaarli'\naccounts='bob john whatever username'\nshaarli_repo_url='https://github.com/shaarli/Shaarli'\nref=\"master\"\n\n#clone multiple shaarli instances\nif [ ! -d \"$shaarli_base_dir\" ]; then mkdir \"$shaarli_base_dir\"; fi\n\nfor account in $accounts; do\n if [ -d \"$shaarli_base_dir/$account\" ];\n then echo \"[info] account $account already exists, skipping\";\n else echo \"[info] creating new account $account ...\"; git clone --quiet \"$shaarli_repo_url\" -b \"$ref\" \"$shaarli_base_dir/$account\"; fi\ndone\n\n#generate html index of shaarlis\nhtmlhead='\n\n\n \n \n My Shaarli farm\n \n \n \n
    \n

    My Shaarli farm

    \n
      '\n\naccountlinks=''\n\nhtmlfooter='\n
    \n
    \n \n' \n\n\n\nfor account in $accounts; do accountlinks=\"$accountlinks\\n
  • $account
    • \"; done\nif [ -d \"$shaarli_base_dir/index.html\" ]; then echo \"[removing old index.html]\"; rm \"$shaarli_base_dir/index.html\" ]; fi\necho \"[info] generating new index of shaarlis\"\necho -e \"$htmlhead $accountlinks $htmlfooter\" > \"$shaarli_base_dir/index.html\"\necho '[info] done.'\necho \"[info] list of accounts: $accounts\"\necho \"[info] contents of $shaarli_base_dir:\"\ntree -a -L 1 \"$shaarli_base_dir\"\n\n\n\n\nThis script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like \nAnsible", - "title": "Create and serve multiple Shaarlis (farm)" - }, - { - "location": "/Download-CSS-styles-from-an-OPML-list/", - "text": "Download CSS styles for shaarlis listed in an opml file\n\n\nExample php script:\n\n\n\n\n\n\n/**\n * Source: https://github.com/Riduidel\n * Download css styles for shaarlis listed in an opml file\n */\ndefine(\"SHAARLI_RSS_OPML\", \"https://www.ecirtam.net/shaarlirss/custom/people.opml\");\n\ndefine(\"THEMES_TEMP_FOLDER\", \"new_themes\");\n\nif(!file_exists(THEMES_TEMP_FOLDER)) {\n mkdir(THEMES_TEMP_FOLDER);\n}\n\nfunction siteUrl($pathInSite) {\n $indexPos = strpos($pathInSite, \"index.php\");\n if(!$indexPos) {\n return $pathInSite;\n } else {\n return substr($pathInSite, 0, $indexPos);\n }\n}\n\nfunction createShaarliHashFromOPMLL($opmlFile) {\n $result = array();\n $opml = file_get_contents($opmlFile);\n $opmlXml = simplexml_load_string($opml);\n $outlineElements = $opmlXml->xpath(\"body/outline\");\n foreach($outlineElements as $site) {\n $siteUrl = siteUrl((string) $site['htmlUrl']);\n $result[$siteUrl]=((string) $site['text']);\n }\n return $result;\n}\n\nfunction getSiteFolder($url) {\n $domain = parse_url($url, PHP_URL_HOST);\n return THEMES_TEMP_FOLDER.\"/\".str_replace(\".\", \"_\", $domain);\n}\n\nfunction get_http_response_code($theURL) {\n $headers = get_headers($theURL);\n return substr($headers[0], 9, 3);\n}\n\n/**\n * This makes the code PHP-5 only (particularly the call to \"get_headers\")\n */\nfunction copyUserStyleFrom($url, $name, $knownStyles) {\n $userStyle = $url.\"inc/user.css\";\n if(in_array($url, $knownStyles)) {\n // TODO add log message\n } else {\n $statusCode = get_http_response_code($userStyle);\n if(intval($statusCode)<300) {\n $styleSheet = file_get_contents($userStyle);\n $siteFolder = getSiteFolder($url);\n if(!file_exists($siteFolder)) {\n mkdir($siteFolder);\n }\n if(!file_exists($siteFolder.'/user.css')) {\n // Copy stylesheet\n file_put_contents($siteFolder.'/user.css', $styleSheet);\n }\n if(!file_exists($siteFolder.'/README.md')) {\n // Then write a readme.md file\n file_put_contents($siteFolder.'/README.md', \n \"User style from \".$name.\"\\n\"\n .\"=============================\"\n .\"\\n\\n\"\n .\"This stylesheet was downloaded from \".$userStyle.\" on \".date(DATE_RFC822)\n );\n }\n if(!file_exists($siteFolder.'/config.ini')) {\n // Write a config file containing useful informations\n file_put_contents($siteFolder.'/config.ini', \n \"site_url=\".$url.\"\\n\"\n .\"site_name=\".$name.\"\\n\"\n );\n }\n if(!file_exists($siteFolder.'/home.png')) {\n // And finally copy generated thumbnail\n $homeThumb = $siteFolder.'/home.png';\n file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));\n }\n echo 'Theme have been downloaded from '.$url.' into '.$siteFolder\n .'. It looks like
    ';\n }\n }\n}\n\nfunction getThumbnailUrl($url) {\n return 'http://api.webthumbnail.org/?url='.$url;\n}\n\nfunction copyUserStylesFrom($urlToNames, $knownStyles) {\n foreach($urlToNames as $url => $name) {\n copyUserStyleFrom($url, $name, $knownStyles);\n }\n}\n\n/**\n * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/\n * @param directory the directory we want to list files of\n * @return a simple array containing the list of absolute file paths. Notice that current file (\".\") and parent one(\"..\")\n * are not listed here\n */\nfunction getDirectoryList ($directory) {\n $realPath = realpath($directory);\n // create an array to hold directory list\n $results = array();\n // create a handler for the directory\n $handler = opendir($directory);\n // open directory and walk through the filenames\n while ($file = readdir($handler)) {\n // if file isn't this directory or its parent, add it to the results\n if ($file != \".\" && $file != \"..\") {\n $results[] = realpath($realPath . \"/\" . $file);\n }\n }\n // tidy up: close the handler\n closedir($handler);\n // done!\n return $results;\n}\n\n/**\n * Start in themes folder and look in all subfolders for config.ini files. \n * These config.ini files allow us not to download styles again and again\n */\nfunction findKnownStyles() {\n $result = array();\n $subFolders = getDirectoryList(\"themes\");\n foreach($subFolders as $folder) {\n $configFile = $folder.\"/config.ini\";\n if(file_exists($configFile)) {\n $iniParameters = parse_ini_file($configFile);\n array_push($result, $iniParameters['site_url']);\n }\n }\n return $result;\n}\n\n$knownStyles = findKnownStyles();\ncopyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);\n\n", - "title": "Download CSS styles from an OPML list" - }, - { - "location": "/Download-CSS-styles-from-an-OPML-list/#download-css-styles-for-shaarlis-listed-in-an-opml-file", - "text": "Example php script: \n\n\n\n/**\n * Source: https://github.com/Riduidel\n * Download css styles for shaarlis listed in an opml file\n */\ndefine(\"SHAARLI_RSS_OPML\", \"https://www.ecirtam.net/shaarlirss/custom/people.opml\");\n\ndefine(\"THEMES_TEMP_FOLDER\", \"new_themes\");\n\nif(!file_exists(THEMES_TEMP_FOLDER)) {\n mkdir(THEMES_TEMP_FOLDER);\n}\n\nfunction siteUrl($pathInSite) {\n $indexPos = strpos($pathInSite, \"index.php\");\n if(!$indexPos) {\n return $pathInSite;\n } else {\n return substr($pathInSite, 0, $indexPos);\n }\n}\n\nfunction createShaarliHashFromOPMLL($opmlFile) {\n $result = array();\n $opml = file_get_contents($opmlFile);\n $opmlXml = simplexml_load_string($opml);\n $outlineElements = $opmlXml->xpath(\"body/outline\");\n foreach($outlineElements as $site) {\n $siteUrl = siteUrl((string) $site['htmlUrl']);\n $result[$siteUrl]=((string) $site['text']);\n }\n return $result;\n}\n\nfunction getSiteFolder($url) {\n $domain = parse_url($url, PHP_URL_HOST);\n return THEMES_TEMP_FOLDER.\"/\".str_replace(\".\", \"_\", $domain);\n}\n\nfunction get_http_response_code($theURL) {\n $headers = get_headers($theURL);\n return substr($headers[0], 9, 3);\n}\n\n/**\n * This makes the code PHP-5 only (particularly the call to \"get_headers\")\n */\nfunction copyUserStyleFrom($url, $name, $knownStyles) {\n $userStyle = $url.\"inc/user.css\";\n if(in_array($url, $knownStyles)) {\n // TODO add log message\n } else {\n $statusCode = get_http_response_code($userStyle);\n if(intval($statusCode)<300) {\n $styleSheet = file_get_contents($userStyle);\n $siteFolder = getSiteFolder($url);\n if(!file_exists($siteFolder)) {\n mkdir($siteFolder);\n }\n if(!file_exists($siteFolder.'/user.css')) {\n // Copy stylesheet\n file_put_contents($siteFolder.'/user.css', $styleSheet);\n }\n if(!file_exists($siteFolder.'/README.md')) {\n // Then write a readme.md file\n file_put_contents($siteFolder.'/README.md', \n \"User style from \".$name.\"\\n\"\n .\"=============================\"\n .\"\\n\\n\"\n .\"This stylesheet was downloaded from \".$userStyle.\" on \".date(DATE_RFC822)\n );\n }\n if(!file_exists($siteFolder.'/config.ini')) {\n // Write a config file containing useful informations\n file_put_contents($siteFolder.'/config.ini', \n \"site_url=\".$url.\"\\n\"\n .\"site_name=\".$name.\"\\n\"\n );\n }\n if(!file_exists($siteFolder.'/home.png')) {\n // And finally copy generated thumbnail\n $homeThumb = $siteFolder.'/home.png';\n file_put_contents($siteFolder.'/home.png', file_get_contents(getThumbnailUrl($url)));\n }\n echo 'Theme have been downloaded from '.$url.' into '.$siteFolder\n .'. It looks like
    ';\n }\n }\n}\n\nfunction getThumbnailUrl($url) {\n return 'http://api.webthumbnail.org/?url='.$url;\n}\n\nfunction copyUserStylesFrom($urlToNames, $knownStyles) {\n foreach($urlToNames as $url => $name) {\n copyUserStyleFrom($url, $name, $knownStyles);\n }\n}\n\n/**\n * Reading directory list, courtesy of http://www.laughing-buddha.net/php/dirlist/\n * @param directory the directory we want to list files of\n * @return a simple array containing the list of absolute file paths. Notice that current file (\".\") and parent one(\"..\")\n * are not listed here\n */\nfunction getDirectoryList ($directory) {\n $realPath = realpath($directory);\n // create an array to hold directory list\n $results = array();\n // create a handler for the directory\n $handler = opendir($directory);\n // open directory and walk through the filenames\n while ($file = readdir($handler)) {\n // if file isn't this directory or its parent, add it to the results\n if ($file != \".\" && $file != \"..\") {\n $results[] = realpath($realPath . \"/\" . $file);\n }\n }\n // tidy up: close the handler\n closedir($handler);\n // done!\n return $results;\n}\n\n/**\n * Start in themes folder and look in all subfolders for config.ini files. \n * These config.ini files allow us not to download styles again and again\n */\nfunction findKnownStyles() {\n $result = array();\n $subFolders = getDirectoryList(\"themes\");\n foreach($subFolders as $folder) {\n $configFile = $folder.\"/config.ini\";\n if(file_exists($configFile)) {\n $iniParameters = parse_ini_file($configFile);\n array_push($result, $iniParameters['site_url']);\n }\n }\n return $result;\n}\n\n$knownStyles = findKnownStyles();\ncopyUserStylesFrom(createShaarliHashFromOPMLL(SHAARLI_RSS_OPML), $knownStyles);\n\n", - "title": "Download CSS styles for shaarlis listed in an opml file" - }, - { - "location": "/Datastore-hacks/", - "text": "Decode datastore content\n\n\nTo display the array representing the data saved in \ndata/datastore.php\n, use the following snippet:\n\n\n$data = \"tZNdb9MwFIb... \";\n$out = unserialize(gzinflate(base64_decode($data)));\necho \"
    \"; // Pretty printing is love, pretty printing is life\nprint_r($out);\necho \"
    \";\nexit;\n\n\n\n\nThis will output the internal representation of the datastore, \"unobfuscated\" (if this can really be considered obfuscation).\n\n\nAlternatively, you can transform to JSON format (and pretty-print if you have \njq\n installed):\n\n\nphp -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace(\"!.*/\\* (.+) \\*/.*!\", \"$1\", file_get_contents(\"data/datastore.php\")))))));' | jq .\n\n\n\n\nChanging the timestamp for a link\n\n\n\n\nLook for \n\n in \ntpl/editlink.tpl\n (line 14)\n\n\nReplace \ntype=\"hidden\"\n with \ntype=\"text\"\n from this line\n\n\nA new date/time field becomes available in the edit/new link dialog.\n\n\nYou can set the timestamp manually by entering it in the format \nYYYMMDD_HHMMS\n.", - "title": "Datastore hacks" - }, - { - "location": "/Datastore-hacks/#decode-datastore-content", + "location": "/Various-hacks/#decode-datastore-content", "text": "To display the array representing the data saved in data/datastore.php , use the following snippet: $data = \"tZNdb9MwFIb... \";\n$out = unserialize(gzinflate(base64_decode($data)));\necho \"
    \"; // Pretty printing is love, pretty printing is life\nprint_r($out);\necho \"
    \";\nexit; This will output the internal representation of the datastore, \"unobfuscated\" (if this can really be considered obfuscation). Alternatively, you can transform to JSON format (and pretty-print if you have jq installed): php -r 'print(json_encode(unserialize(gzinflate(base64_decode(preg_replace(\"!.*/\\* (.+) \\*/.*!\", \"$1\", file_get_contents(\"data/datastore.php\")))))));' | jq .", "title": "Decode datastore content" }, { - "location": "/Datastore-hacks/#changing-the-timestamp-for-a-link", + "location": "/Various-hacks/#changing-the-timestamp-for-a-shaare", "text": "Look for in tpl/editlink.tpl (line 14) Replace type=\"hidden\" with type=\"text\" from this line A new date/time field becomes available in the edit/new link dialog. You can set the timestamp manually by entering it in the format YYYMMDD_HHMMS .", - "title": "Changing the timestamp for a link" + "title": "Changing the timestamp for a shaare" + }, + { + "location": "/Various-hacks/#see-also", + "text": "Add a new custom field to shaares (example patch) Download CSS styles for shaarlis listed in an opml file Copy an existing Shaarli installation over SSH, and serve it locally Create multiple Shaarli instances, generate an HTML index of them", + "title": "See also" }, { "location": "/Troubleshooting/", diff --git a/doc/html/search.html b/doc/html/search.html index b492b8bd..49541cda 100644 --- a/doc/html/search.html +++ b/doc/html/search.html @@ -148,19 +148,7 @@
  • - Copy an existing installation over SSH and serve it locally -
    • -
  • - - Create and serve multiple Shaarlis (farm) -
    • -
  • - - Download CSS styles from an OPML list -
    • -
  • - - Datastore hacks + Various hacks
    • diff --git a/doc/html/sitemap.xml b/doc/html/sitemap.xml index 534f02b5..2a1b009e 100644 --- a/doc/html/sitemap.xml +++ b/doc/html/sitemap.xml @@ -132,25 +132,7 @@ - /Copy-an-existing-installation-over-SSH-and-serve-it-locally/ - 2017-06-18 - daily - - - - /Create-and-serve-multiple-Shaarlis-(farm)/ - 2017-06-18 - daily - - - - /Download-CSS-styles-from-an-OPML-list/ - 2017-06-18 - daily - - - - /Datastore-hacks/ + /Various-hacks/ 2017-06-18 daily diff --git a/doc/md/Browsing-and-searching.md b/doc/md/Browsing-and-searching.md index ad62c2f0..35707482 100644 --- a/doc/md/Browsing-and-searching.md +++ b/doc/md/Browsing-and-searching.md @@ -20,4 +20,4 @@ To search for links that are not tagged, enter `""` in the tag search field. ## Filtering RSS feeds/Picture wall -RSS feeds can also be restricted to only return items matching a text/tag search: see [[RSS feeds]]. +RSS feeds can also be restricted to only return items matching a text/tag search: see [RSS feeds](RSS feeds). diff --git a/doc/md/Community-&-Related-software.md b/doc/md/Community-&-Related-software.md index 6ff7ed45..b8b7cccd 100644 --- a/doc/md/Community-&-Related-software.md +++ b/doc/md/Community-&-Related-software.md @@ -34,7 +34,7 @@ _TODO: contact repos owners to see if they'd like to standardize their work with ### Themes -See [[Theming]] for the list of community-contributed themes, and an installation guide. +See [Theming](Theming) for the list of community-contributed themes, and an installation guide. ### Server apps - [shaarchiver](https://github.com/nodiscc/shaarchiver) - Archive your Shaarli bookmarks and their content diff --git a/doc/md/Continuous-integration-tools.md b/doc/md/Continuous-integration-tools.md index 30dc474d..849257f7 100644 --- a/doc/md/Continuous-integration-tools.md +++ b/doc/md/Continuous-integration-tools.md @@ -1,20 +1,20 @@ ## Local development A [`Makefile`](https://github.com/shaarli/Shaarli/blob/master/Makefile) is available to perform project-related operations: - Documentation - generate a local HTML copy of the GitHub wiki -- [[Static analysis]] - check that the code is compliant to PHP conventions -- [[Unit tests]] - ensure there are no regressions introduced by new commits +- [Static analysis](Static analysis) - check that the code is compliant to PHP conventions +- [Unit tests](Unit tests) - ensure there are no regressions introduced by new commits ## Automatic builds [Travis CI](http://docs.travis-ci.com/) is a Continuous Integration build server, that runs a build: - each time a commit is merged to the mainline (`master` branch) - each time a Pull Request is submitted or updated -A build is composed of several jobs: one for each supported PHP version (see [[Server requirements]]). +A build is composed of several jobs: one for each supported PHP version (see [Server requirements](Server requirements)). Each build job: - updates Composer - installs 3rd-party test dependencies with Composer -- runs [[Unit tests]] +- runs [Unit tests](Unit tests) After all jobs have finished, Travis returns the results to GitHub: - a status icon represents the result for the `master` branch: [![](https://api.travis-ci.org/shaarli/Shaarli.svg)](https://travis-ci.org/shaarli/Shaarli) diff --git a/doc/md/Development-guidelines.md b/doc/md/Development-guidelines.md index 1480ec89..3a248767 100644 --- a/doc/md/Development-guidelines.md +++ b/doc/md/Development-guidelines.md @@ -2,8 +2,8 @@ Please have a look at the following pages: - [Contributing to Shaarli](https://github.com/shaarli/Shaarli/tree/master/CONTRIBUTING.md) -- [[Static analysis]] - patches should try to stick to the [PHP Standard Recommendations](http://www.php-fig.org/psr/) (PSR), especially: +- [Static analysis](Static analysis) - patches should try to stick to the [PHP Standard Recommendations](http://www.php-fig.org/psr/) (PSR), especially: - [PSR-1](http://www.php-fig.org/psr/psr-1/) - Basic Coding Standard - [PSR-2](http://www.php-fig.org/psr/psr-2/) - Coding Style Guide -- [[Unit tests]] -- [[GnuPG signature]] for tags/releases +- [Unit tests](Unit tests) +- [GnuPG signature](GnuPG signature) for tags/releases diff --git a/doc/md/Firefox-share.md b/doc/md/Firefox-share.md index 9ba57b04..595b9400 100644 --- a/doc/md/Firefox-share.md +++ b/doc/md/Firefox-share.md @@ -8,7 +8,7 @@ ### Sharing links using Firefox share * Add the sharing service as described above - * When you are visiting a webpage you would like to share with Shaarli, click the Firefox _Share_ button [[images/firefoxshare.png]] + * When you are visiting a webpage you would like to share with Shaarli, click the Firefox _Share_ button [images/firefoxshare.png](images/firefoxshare.png) * You can edit your link before and after saving, just like the bookmarklet above. |  | Your Shaarli instance must be hosted on an HTTPS (SSL/TLS secure connection) enabled server for Firefox Share to work. Firefox Share will not work over plain HTTP connections. | diff --git a/doc/md/GnuPG-signature.md b/doc/md/GnuPG-signature.md index 1fb3b42f..62a17d33 100644 --- a/doc/md/GnuPG-signature.md +++ b/doc/md/GnuPG-signature.md @@ -73,4 +73,4 @@ gpg: sending key A9D53A3E to hkp server pgp.mit.edu ## Create and push a GPG-signed tag -See [[Release Shaarli]]. +See [Release Shaarli](Release Shaarli). diff --git a/doc/md/Theming.md b/doc/md/Theming.md index ae68db38..d72c2ffd 100644 --- a/doc/md/Theming.md +++ b/doc/md/Theming.md @@ -15,7 +15,7 @@ This file allows overriding rules defined in the template CSS files (only add ch **Note**: Do not edit `tpl/default/css/shaarli.css`! Your changes would be overridden when updating Shaarli. -See also [[Download CSS styles from an OPML list]] +See also [Download CSS styles from an OPML list](Download CSS styles from an OPML list) ## Themes @@ -77,7 +77,7 @@ Get config written: - fill the install form - log in to Shaarli -Edit Shaarli's [[configuration|Shaarli configuration]]: +Edit Shaarli's [configuration|Shaarli configuration](configuration|Shaarli configuration): ```bash # the file should be owned by Apache, thus not writeable => sudo $ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php diff --git a/doc/md/Upgrade-and-migration.md b/doc/md/Upgrade-and-migration.md index 7348891f..2002a4e2 100644 --- a/doc/md/Upgrade-and-migration.md +++ b/doc/md/Upgrade-and-migration.md @@ -13,7 +13,7 @@ Shaarli stores all user data under the `data` directory: - `data/ipbans.php` - banned IP addresses - `data/updates.txt` - contains all automatic update to the configuration and datastore files already run -See [[Shaarli configuration]] for more information about Shaarli resources. +See [Shaarli configuration](Shaarli configuration) for more information about Shaarli resources. It is recommended to backup this repository _before_ starting updating/upgrading Shaarli: - users with SSH access: copy or archive the directory to a temporary location @@ -25,7 +25,7 @@ As all user data is kept under `data`, this is the only directory you need to wo - backup the `data` directory - install or update Shaarli: - - fresh installation - see [[Download and installation]] + - fresh installation - see [Download and installation](Download and installation) - update - see the following sections - check or restore the `data` directory @@ -33,11 +33,11 @@ As all user data is kept under `data`, this is the only directory you need to wo All tagged revisions can be downloaded as tarballs or ZIP archives from the [releases](https://github.com/shaarli/Shaarli/releases) page. -We recommend that you use the latest release tarball with the `-full` suffix. It contains the dependencies, please read [[Download and installation]] for `git` complete instructions. +We recommend that you use the latest release tarball with the `-full` suffix. It contains the dependencies, please read [Download and installation](Download and installation) for `git` complete instructions. Once downloaded, extract the archive locally and update your remote installation (e.g. via FTP) -be sure you keep the content of the `data` directory! -After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to `data/config.json.php` (see [[Shaarli configuration]] for more details). +After upgrading, access your fresh Shaarli installation from a web browser; the configuration and data store will then be automatically updated, and new settings added to `data/config.json.php` (see [Shaarli configuration](Shaarli configuration) for more details). ## Upgrading with Git @@ -170,7 +170,7 @@ Total 3317 (delta 2050), reused 3301 (delta 2034)to #### Step 3: configuration -After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to `data/config.php` (see [[Shaarli configuration]] for more details). +After migrating, access your fresh Shaarli installation from a web browser; the configuration will then be automatically updated, and new settings added to `data/config.php` (see [Shaarli configuration](Shaarli configuration) for more details). ## Troubleshooting From 12e1877917dc6c29cd93bce7781e26c9f4415c16 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Sun, 18 Jun 2017 22:15:50 +0200 Subject: [PATCH 29/67] move README contents to doc/md/index.md --- README.md | 99 +++---------------------------------------- doc/md/index.md | 109 ++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 111 insertions(+), 97 deletions(-) diff --git a/README.md b/README.md index 7633b2cb..c9e83899 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ The personal, minimalist, super-fast, database free, bookmarking service. _Do you want to share the links you discover?_ -_Shaarli is a minimalist delicious clone that you can install on your own server._ +_Shaarli is a minimalist link sharing service that you can install on your own server._ _It is designed to be personal (single-user), fast and handy._ [![](https://img.shields.io/badge/stable-v0.8.4-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.8.4) @@ -20,107 +20,18 @@ _It is designed to be personal (single-user), fast and handy._ [![Docker repository](https://img.shields.io/docker/pulls/shaarli/shaarli.svg)](https://hub.docker.com/r/shaarli/shaarli/) ## Quickstart -- [Wiki/documentation](https://github.com/shaarli/Shaarli/wiki) + +- [Documentation](https://shaarli.readthedocs.io) - [Change log](CHANGELOG.md) - [Bugs/Feature requests/Discussion](https://github.com/shaarli/Shaarli/issues/) ### Demo + You can use this [public demo instance of Shaarli](https://demo.shaarli.org). It runs the latest development version of Shaarli and is updated/reset daily. Login: `demo`; Password: `demo` -### Installation & upgrade -- [Download and installation](https://github.com/shaarli/Shaarli/wiki/Download-and-Installation) -- [Upgrade and migration](https://github.com/shaarli/Shaarli/wiki/Upgrade-and-migration) -- [Server requirements](https://github.com/shaarli/Shaarli/wiki/Server-requirements) -- [Server configuration](https://github.com/shaarli/Shaarli/wiki/Server-configuration) -- [Shaarli configuration](https://github.com/shaarli/Shaarli/wiki/Shaarli-configuration) - -## Features -### Interface -- minimalist design (simple is beautiful) -- FAST -- ATOM and RSS feeds -- views: - - paginated link list - - tag cloud - - picture wall: image and video thumbnails - - daily: newspaper-like daily digest - - daily RSS feed -- permalinks for easy reference -- links can be public or private -- extensible through [plugins](https://github.com/shaarli/Shaarli/wiki/Plugins#plugin-usage) - -### Tag, view and search your links! -- add a custom title and description to archived links -- add tags to classify and search links - - features tag autocompletion, renaming, merging and deletion -- full-text and tag search - -### Easy setup -- dead-simple installation: drop the files, open the page -- links are stored in a file - - compact storage - - no database required - - easy backup: simply copy the datastore file -- import and export links as Netscape bookmarks - -### Accessibility -- Firefox bookmarlet to share links in one click -- support for mobile browsers -- works with Javascript disabled -- easy page customization through HTML/CSS/RainTPL - -### Security -- bruteforce-proof login form -- protected against [XSRF](http://en.wikipedia.org/wiki/Cross-site_request_forgery) -and session cookie hijacking - -### Goodies -- thumbnail generation for images and video services: -dailymotion, flickr, imageshack, imgur, vimeo, xkcd, youtube... - - lazy-loading with [bLazy](http://dinbror.dk/blazy/) -- [PubSubHubbub](https://code.google.com/p/pubsubhubbub/) protocol support -- URL cleanup: automatic removal of `?utm_source=...`, `fb=...` -- discreet pop-up notification when a new release is available - -### REST API - -Easily extensible by any client using the REST API exposed by Shaarli. - -See the [API documentation](http://shaarli.github.io/api-documentation/). - -### Other usages -Though Shaarli is primarily a bookmarking application, it can serve other purposes -(see [usage examples](https://github.com/shaarli/Shaarli/wiki#usage-examples)): -- micro-blogging -- pastebin -- online notepad -- snippet archive - -## About -### Shaarli community fork -This friendly fork is maintained by the Shaarli community at https://github.com/shaarli/Shaarli - -This is a community fork of the original [Shaarli](https://github.com/sebsauvage/Shaarli/) project by [Sébastien Sauvage](http://sebsauvage.net/). - -The original project is currently unmaintained, and the developer [has informed us](https://github.com/sebsauvage/Shaarli/issues/191) -that he would have no time to work on Shaarli in the near future. -The Shaarli community has carried on the work to provide -[many patches](https://github.com/shaarli/Shaarli/compare/sebsauvage:master...master) -for [bug fixes and enhancements](https://github.com/shaarli/Shaarli/issues?q=is%3Aclosed+) -in this repository, and will keep maintaining the project for the foreseeable future, while keeping Shaarli simple and efficient. - -### Contributing -If you'd like to help, please: -- have a look at the open [issues](https://github.com/shaarli/Shaarli/issues) -and [pull requests](https://github.com/shaarli/Shaarli/pulls) -- feel free to report bugs (feedback is much appreciated) -- suggest new features and improvements to both code and [documentation](https://github.com/shaarli/Shaarli/wiki) -- propose solutions to existing problems -- submit pull requests :-) - - ### License + Shaarli is [Free Software](http://en.wikipedia.org/wiki/Free_software). See [COPYING](COPYING) for a detail of the contributors and licenses for each individual component. diff --git a/doc/md/index.md b/doc/md/index.md index 37a9c1fc..1106334b 100644 --- a/doc/md/index.md +++ b/doc/md/index.md @@ -1,11 +1,114 @@ -Welcome to the [Shaarli](https://github.com/shaarli/Shaarli/) wiki! +# [Shaarli](https://github.com/shaarli/Shaarli/) documentation Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli. For general info, read the [README](https://github.com/shaarli/Shaarli/blob/master/README.md). -If you have any questions or ideas, please join the [chat](https://gitter.im/shaarli/Shaarli) (also reachable via [IRC](https://irc.gitter.im/)), post them in our [general discussion](https://github.com/shaarli/Shaarli/issues/308) ([archive](https://github.com/shaarli/Shaarli/issues/44)) or read the current [issues](https://github.com/shaarli/Shaarli/issues). If you've found a bug, please create a [new issue](https://github.com/shaarli/Shaarli/issues/new). +If you have any questions or ideas, please join the [chat](https://gitter.im/shaarli/Shaarli) (also reachable via [IRC](https://irc.gitter.im/)), post them in our [general discussion](https://github.com/shaarli/Shaarli/issues/308) or read the current [issues](https://github.com/shaarli/Shaarli/issues). +If you've found a bug, please create a [new issue](https://github.com/shaarli/Shaarli/issues/new). If you would like a feature added to Shaarli, check the issues labeled [`feature`](https://github.com/shaarli/Shaarli/labels/feature), [`enhancement`](https://github.com/shaarli/Shaarli/labels/enhancement), and [`plugin`](https://github.com/shaarli/Shaarli/labels/plugin). -_Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the `doc/` directory of your Shaarli installation._ +_Note: This documentation is available online at https://shaarli.readthedocs.io/, and locally in the `doc/html/` directory of your Shaarli installation._ + +[![Join the chat at https://gitter.im/shaarli/Shaarli](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/shaarli/Shaarli) +[![Bountysource](https://www.bountysource.com/badge/team?team_id=19583&style=bounties_received)](https://www.bountysource.com/teams/shaarli/issues) +[![Docker repository](https://img.shields.io/docker/pulls/shaarli/shaarli.svg)](https://hub.docker.com/r/shaarli/shaarli/) + +### Demo + +You can use this [public demo instance of Shaarli](https://demo.shaarli.org). +It runs the latest development version of Shaarli and is updated/reset daily. + +Login: `demo`; Password: `demo` + + +## Features + +### Interface +- minimalist design (simple is beautiful) +- FAST +- ATOM and RSS feeds +- views: + - paginated link list + - tag cloud + - picture wall: image and video thumbnails + - daily: newspaper-like daily digest + - daily RSS feed +- permalinks for easy reference +- links can be public or private +- extensible through [plugins](https://github.com/shaarli/Shaarli/wiki/Plugins#plugin-usage) + +### Tag, view and search your links! +- add a custom title and description to archived links +- add tags to classify and search links + - features tag autocompletion, renaming, merging and deletion +- full-text and tag search + +### Easy setup +- dead-simple installation: drop the files, open the page +- links are stored in a file + - compact storage + - no database required + - easy backup: simply copy the datastore file +- import and export links as Netscape bookmarks + +### Accessibility +- Firefox bookmarlet to share links in one click +- support for mobile browsers +- works with Javascript disabled +- easy page customization through HTML/CSS/RainTPL + +### Security +- bruteforce-proof login form +- protected against [XSRF](http://en.wikipedia.org/wiki/Cross-site_request_forgery) +and session cookie hijacking + +### Goodies +- thumbnail generation for images and video services: +dailymotion, flickr, imageshack, imgur, vimeo, xkcd, youtube... + - lazy-loading with [bLazy](http://dinbror.dk/blazy/) +- [PubSubHubbub](https://code.google.com/p/pubsubhubbub/) protocol support +- URL cleanup: automatic removal of `?utm_source=...`, `fb=...` +- discreet pop-up notification when a new release is available + +### REST API + +Easily extensible by any client using the REST API exposed by Shaarli. + +See the [API documentation](http://shaarli.github.io/api-documentation/). + +### Other usages +Though Shaarli is primarily a bookmarking application, it can serve other purposes +(see [usage examples](https://github.com/shaarli/Shaarli/wiki#usage-examples)): +- micro-blogging +- pastebin +- online notepad +- snippet archive + +## About +### Shaarli community fork +This friendly fork is maintained by the Shaarli community at https://github.com/shaarli/Shaarli + +This is a community fork of the original [Shaarli](https://github.com/sebsauvage/Shaarli/) project by [Sébastien Sauvage](http://sebsauvage.net/). + +The original project is currently unmaintained, and the developer [has informed us](https://github.com/sebsauvage/Shaarli/issues/191) +that he would have no time to work on Shaarli in the near future. +The Shaarli community has carried on the work to provide +[many patches](https://github.com/shaarli/Shaarli/compare/sebsauvage:master...master) +for [bug fixes and enhancements](https://github.com/shaarli/Shaarli/issues?q=is%3Aclosed+) +in this repository, and will keep maintaining the project for the foreseeable future, while keeping Shaarli simple and efficient. + +### Contributing +If you'd like to help, please: +- have a look at the open [issues](https://github.com/shaarli/Shaarli/issues) +and [pull requests](https://github.com/shaarli/Shaarli/pulls) +- feel free to report bugs (feedback is much appreciated) +- suggest new features and improvements to both code and [documentation](https://github.com/shaarli/Shaarli/wiki) +- propose solutions to existing problems +- submit pull requests :-) + + +### License +Shaarli is [Free Software](http://en.wikipedia.org/wiki/Free_software). See [COPYING](COPYING) for a detail of the contributors and licenses for each individual component. + From 081a73486ff6eb73191294a047c51ea15e2b312a Mon Sep 17 00:00:00 2001 From: nodiscc Date: Sun, 18 Jun 2017 22:22:34 +0200 Subject: [PATCH 30/67] doc: replace pandoc requirement with python3-venv --- doc/md/Release-Shaarli.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/md/Release-Shaarli.md b/doc/md/Release-Shaarli.md index cce5e209..59175352 100644 --- a/doc/md/Release-Shaarli.md +++ b/doc/md/Release-Shaarli.md @@ -12,7 +12,8 @@ This guide assumes that you have: - maintainer permissions on the main Shaarli repository, to: - push the signed tag - create a new release -- [Composer](https://getcomposer.org/) and [Pandoc](http://pandoc.org/) need to be installed +- [Composer](https://getcomposer.org/) needs to be installed +- The [venv](https://docs.python.org/3/library/venv.html) Python 3 module needs to be installed for HTML documentation generation. ## GitHub release draft and `CHANGELOG.md` See http://keepachangelog.com/en/0.3.0/ for changelog formatting. From a6192bdd52dea0eec40d1046dee49e80c6b6b62c Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:24:44 +0200 Subject: [PATCH 31/67] CONTRIBUTING.md: define new workflow for documentation edition and contributions --- CONTRIBUTING.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b1be656a..3646408f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -17,14 +17,10 @@ Check the [milestones](https://github.com/shaarli/Shaarli/milestones) to see wha * You can also join instant discussion at https://gitter.im/shaarli/Shaarli, or via IRC as described [here](https://github.com/shaarli/Shaarli/issues/44#issuecomment-77745105) ### Documentation -**the [wiki](https://github.com/shaarli/Shaarli/wiki) is world-writable** - anyone can edit or add chapters and pages. - * Large changes should preferably be discussed in [General discussion](https://github.com/shaarli/Shaarli/issues/44) beforehand (you can post a draft there and edit it). - * If you create a new page, please link it from the new page (eg from the [Other links](https://github.com/shaarli/Shaarli/wiki#other-links) section. - * The wiki is a general documentation about Shaarli: usage, development, hacks, usage tricks, related links, projects. Try to keep it organized. - * The wiki will be synced to Shaarli's `doc/` directory on each release. Keep that in mind when reviewing the quality of your edits. +The [official documentation](http://shaarli.readthedocs.io/en/rtfd/) https://github.com/shaarli/Shaarli/wiki) is generated from [Markdown](https://daringfireball.net/projects/markdown/syntax) documents in the `doc/md/` directory. HTML documentation is generated using [Mkdocs](http://www.mkdocs.org/). [Read the Docs](https://readthedocs.org/) provides hosting for the online documentation. -You can make the project known by publishing blog posts/articles/videos about it and adding them to the links section in the wiki. +To edit the documentation, please edit the appropriate `doc/md/*.md` files (and optionally `make htmlpages` to preview changes to HTML files). Then submit your changes as a Pull Request. Have a look at the MkDocs documentation and configuration file `mkdocs.yml` if you need to add/remove/rename/reorder pages. ### Translations Currently Shaarli has no translation/internationalization/localization system available and is single-language. You can help by proposing an i18n system (issue https://github.com/shaarli/Shaarli/issues/121) From 2f9c1ecf8853d513ec86427b20e0d006b5296c9c Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:26:01 +0200 Subject: [PATCH 32/67] doc: release: update doc generation instructions --- doc/md/Release-Shaarli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/md/Release-Shaarli.md b/doc/md/Release-Shaarli.md index 59175352..0e445272 100644 --- a/doc/md/Release-Shaarli.md +++ b/doc/md/Release-Shaarli.md @@ -52,8 +52,8 @@ $ cd /path/to/shaarli $ git fetch upstream $ git checkout upstream/master -b v0.5.0 -# rebuild the documentation from the wiki -$ make htmldoc +# rebuild the HTML documentation from Markdown +$ make htmlpages # commit the changes $ git add doc From f47aa40c12ec63a60d2edc959314a0a05f6fe610 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:26:27 +0200 Subject: [PATCH 33/67] makefile: remove obsolete 'doc' target official documentation can now be found in doc/md/ --- Makefile | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/Makefile b/Makefile index 1ddd60f8..2064303a 100644 --- a/Makefile +++ b/Makefile @@ -192,13 +192,6 @@ doxygen: clean @rm -rf doxygen @( cat Doxyfile ; echo "PROJECT_NUMBER=`git describe`" ) | doxygen - -### update the local copy of the documentation -doc: clean - @rm -rf doc/md/ - @git clone https://github.com/shaarli/Shaarli.wiki.git doc/md - mv doc/md/Home.md doc/md/index.md - @rm -rf doc/md/.git - ### Convert local markdown documentation to HTML # # For all pages: @@ -218,4 +211,5 @@ htmlpages: find doc/html/ -type f -exec chmod a-x '{}' \; rm -r venv -doc_html: authors doc htmlpages +doc_html: authors htmlpages + From 366247c84cdb0bb0457552468103814d4d31ce5c Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:30:31 +0200 Subject: [PATCH 34/67] make htmlpages --- doc/html/Release-Shaarli/index.html | 7 +- doc/html/index.html | 121 +++++++++++++++++++++++++++- doc/html/mkdocs/search_index.json | 83 ++++++++++++++++++- doc/html/sitemap.xml | 72 ++++++++--------- 4 files changed, 236 insertions(+), 47 deletions(-) diff --git a/doc/html/Release-Shaarli/index.html b/doc/html/Release-Shaarli/index.html index 92433203..5857a52f 100644 --- a/doc/html/Release-Shaarli/index.html +++ b/doc/html/Release-Shaarli/index.html @@ -337,7 +337,8 @@

    Prerequisites

    - maintainer permissions on the main Shaarli repository, to: - push the signed tag - create a new release -- Composer and Pandoc need to be installed

    +- Composer needs to be installed +- The venv Python 3 module needs to be installed for HTML documentation generation.

    GitHub release draft and CHANGELOG.md

    See http://keepachangelog.com/en/0.3.0/ for changelog formatting.

    GitHub release draft

    @@ -368,8 +369,8 @@

    Generate documentation

    $ git fetch upstream $ git checkout upstream/master -b v0.5.0 -# rebuild the documentation from the wiki -$ make htmldoc +# rebuild the HTML documentation from Markdown +$ make htmlpages # commit the changes $ git add doc diff --git a/doc/html/index.html b/doc/html/index.html index e6d4ef78..93f4ba5d 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -53,6 +53,19 @@ Home @@ -274,12 +287,112 @@
    -

    Welcome to the Shaarli wiki!

    +

    Shaarli documentation

    Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli.

    For general info, read the README.

    -

    If you have any questions or ideas, please join the chat (also reachable via IRC), post them in our general discussion (archive) or read the current issues. If you've found a bug, please create a new issue.

    +

    If you have any questions or ideas, please join the chat (also reachable via IRC), post them in our general discussion or read the current issues. +If you've found a bug, please create a new issue.

    If you would like a feature added to Shaarli, check the issues labeled feature, enhancement, and plugin.

    -

    Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the doc/ directory of your Shaarli installation.

    +

    Note: This documentation is available online at https://shaarli.readthedocs.io/, and locally in the doc/html/ directory of your Shaarli installation.

    +

    Join the chat at https://gitter.im/shaarli/Shaarli +Bountysource +Docker repository

    +

    Demo

    +

    You can use this public demo instance of Shaarli. +It runs the latest development version of Shaarli and is updated/reset daily.

    +

    Login: demo; Password: demo

    +

    Features

    +

    Interface

    +
      +
    • minimalist design (simple is beautiful)
      • +
    • FAST
      • +
    • ATOM and RSS feeds
      • +
    • views:
        +
      • paginated link list
        • +
      • tag cloud
        • +
      • picture wall: image and video thumbnails
        • +
      • daily: newspaper-like daily digest
        • +
      • daily RSS feed
        • +
      +
      • +
    • permalinks for easy reference
      • +
    • links can be public or private
      • +
    • extensible through plugins
      • +
    + +
      +
    • add a custom title and description to archived links
      • +
    • add tags to classify and search links
        +
      • features tag autocompletion, renaming, merging and deletion
        • +
      +
      • +
    • full-text and tag search
      • +
    +

    Easy setup

    +
      +
    • dead-simple installation: drop the files, open the page
      • +
    • links are stored in a file
        +
      • compact storage
        • +
      • no database required
        • +
      • easy backup: simply copy the datastore file
        • +
      +
      • +
    • import and export links as Netscape bookmarks
      • +
    +

    Accessibility

    +
      +
    • Firefox bookmarlet to share links in one click
      • +
    • support for mobile browsers
      • +
    • works with Javascript disabled
      • +
    • easy page customization through HTML/CSS/RainTPL
      • +
    +

    Security

    +
      +
    • bruteforce-proof login form
      • +
    • protected against XSRF +and session cookie hijacking
      • +
    +

    Goodies

    +
      +
    • thumbnail generation for images and video services: +dailymotion, flickr, imageshack, imgur, vimeo, xkcd, youtube...
        +
      • lazy-loading with bLazy
        • +
      +
      • +
    • PubSubHubbub protocol support
      • +
    • URL cleanup: automatic removal of ?utm_source=..., fb=...
      • +
    • discreet pop-up notification when a new release is available
      • +
    +

    REST API

    +

    Easily extensible by any client using the REST API exposed by Shaarli.

    +

    See the API documentation.

    +

    Other usages

    +

    Though Shaarli is primarily a bookmarking application, it can serve other purposes +(see usage examples): +- micro-blogging +- pastebin +- online notepad +- snippet archive

    +

    About

    +

    Shaarli community fork

    +

    This friendly fork is maintained by the Shaarli community at https://github.com/shaarli/Shaarli

    +

    This is a community fork of the original Shaarli project by Sébastien Sauvage.

    +

    The original project is currently unmaintained, and the developer has informed us +that he would have no time to work on Shaarli in the near future. +The Shaarli community has carried on the work to provide +many patches +for bug fixes and enhancements +in this repository, and will keep maintaining the project for the foreseeable future, while keeping Shaarli simple and efficient.

    +

    Contributing

    +

    If you'd like to help, please: +- have a look at the open issues +and pull requests +- feel free to report bugs (feedback is much appreciated) +- suggest new features and improvements to both code and documentation +- propose solutions to existing problems +- submit pull requests :-)

    +

    License

    +

    Shaarli is Free Software. See COPYING for a detail of the contributors and licenses for each individual component.

    @@ -328,5 +441,5 @@ diff --git a/doc/html/mkdocs/search_index.json b/doc/html/mkdocs/search_index.json index 7ef1837c..71bc2bcf 100644 --- a/doc/html/mkdocs/search_index.json +++ b/doc/html/mkdocs/search_index.json @@ -2,9 +2,84 @@ "docs": [ { "location": "/", - "text": "Welcome to the \nShaarli\n wiki!\n\n\nHere you can find some info on how to use, configure, tweak and solve problems with your Shaarli.\n\n\nFor general info, read the \nREADME\n.\n\n\nIf you have any questions or ideas, please join the \nchat\n (also reachable via \nIRC\n), post them in our \ngeneral discussion\n (\narchive\n) or read the current \nissues\n. If you've found a bug, please create a \nnew issue\n.\n\n\nIf you would like a feature added to Shaarli, check the issues labeled \nfeature\n, \nenhancement\n, and \nplugin\n.\n\n\nNote: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the \ndoc/\n directory of your Shaarli installation.", + "text": "Shaarli\n documentation\n\n\nHere you can find some info on how to use, configure, tweak and solve problems with your Shaarli.\n\n\nFor general info, read the \nREADME\n.\n\n\nIf you have any questions or ideas, please join the \nchat\n (also reachable via \nIRC\n), post them in our \ngeneral discussion\n or read the current \nissues\n.\nIf you've found a bug, please create a \nnew issue\n.\n\n\nIf you would like a feature added to Shaarli, check the issues labeled \nfeature\n, \nenhancement\n, and \nplugin\n.\n\n\nNote: This documentation is available online at https://shaarli.readthedocs.io/, and locally in the \ndoc/html/\n directory of your Shaarli installation.\n\n\n\n\n\n\n\n\nDemo\n\n\nYou can use this \npublic demo instance of Shaarli\n.\nIt runs the latest development version of Shaarli and is updated/reset daily.\n\n\nLogin: \ndemo\n; Password: \ndemo\n\n\nFeatures\n\n\nInterface\n\n\n\n\nminimalist design (simple is beautiful)\n\n\nFAST\n\n\nATOM and RSS feeds\n\n\nviews:\n\n\npaginated link list\n\n\ntag cloud\n\n\npicture wall: image and video thumbnails\n\n\ndaily: newspaper-like daily digest\n\n\ndaily RSS feed\n\n\n\n\n\n\npermalinks for easy reference\n\n\nlinks can be public or private\n\n\nextensible through \nplugins\n\n\n\n\nTag, view and search your links!\n\n\n\n\nadd a custom title and description to archived links\n\n\nadd tags to classify and search links\n\n\nfeatures tag autocompletion, renaming, merging and deletion\n\n\n\n\n\n\nfull-text and tag search\n\n\n\n\nEasy setup\n\n\n\n\ndead-simple installation: drop the files, open the page\n\n\nlinks are stored in a file\n\n\ncompact storage\n\n\nno database required\n\n\neasy backup: simply copy the datastore file\n\n\n\n\n\n\nimport and export links as Netscape bookmarks\n\n\n\n\nAccessibility\n\n\n\n\nFirefox bookmarlet to share links in one click\n\n\nsupport for mobile browsers\n\n\nworks with Javascript disabled\n\n\neasy page customization through HTML/CSS/RainTPL\n\n\n\n\nSecurity\n\n\n\n\nbruteforce-proof login form\n\n\nprotected against \nXSRF\n\nand session cookie hijacking\n\n\n\n\nGoodies\n\n\n\n\nthumbnail generation for images and video services:\ndailymotion, flickr, imageshack, imgur, vimeo, xkcd, youtube...\n\n\nlazy-loading with \nbLazy\n\n\n\n\n\n\nPubSubHubbub\n protocol support\n\n\nURL cleanup: automatic removal of \n?utm_source=...\n, \nfb=...\n\n\ndiscreet pop-up notification when a new release is available\n\n\n\n\nREST API\n\n\nEasily extensible by any client using the REST API exposed by Shaarli.\n\n\nSee the \nAPI documentation\n.\n\n\nOther usages\n\n\nThough Shaarli is primarily a bookmarking application, it can serve other purposes\n(see \nusage examples\n):\n- micro-blogging\n- pastebin\n- online notepad\n- snippet archive\n\n\nAbout\n\n\nShaarli community fork\n\n\nThis friendly fork is maintained by the Shaarli community at https://github.com/shaarli/Shaarli\n\n\nThis is a community fork of the original \nShaarli\n project by \nS\u00e9bastien Sauvage\n.\n\n\nThe original project is currently unmaintained, and the developer \nhas informed us\n\nthat he would have no time to work on Shaarli in the near future.\nThe Shaarli community has carried on the work to provide\n\nmany patches\n\nfor \nbug fixes and enhancements\n\nin this repository, and will keep maintaining the project for the foreseeable future, while keeping Shaarli simple and efficient.\n\n\nContributing\n\n\nIf you'd like to help, please:\n- have a look at the open \nissues\n\nand \npull requests\n\n- feel free to report bugs (feedback is much appreciated)\n- suggest new features and improvements to both code and \ndocumentation\n\n- propose solutions to existing problems\n- submit pull requests :-)\n\n\nLicense\n\n\nShaarli is \nFree Software\n. See \nCOPYING\n for a detail of the contributors and licenses for each individual component.", "title": "Home" }, + { + "location": "/#shaarli-documentation", + "text": "Here you can find some info on how to use, configure, tweak and solve problems with your Shaarli. For general info, read the README . If you have any questions or ideas, please join the chat (also reachable via IRC ), post them in our general discussion or read the current issues .\nIf you've found a bug, please create a new issue . If you would like a feature added to Shaarli, check the issues labeled feature , enhancement , and plugin . Note: This documentation is available online at https://shaarli.readthedocs.io/, and locally in the doc/html/ directory of your Shaarli installation.", + "title": "Shaarli documentation" + }, + { + "location": "/#demo", + "text": "You can use this public demo instance of Shaarli .\nIt runs the latest development version of Shaarli and is updated/reset daily. Login: demo ; Password: demo", + "title": "Demo" + }, + { + "location": "/#features", + "text": "", + "title": "Features" + }, + { + "location": "/#interface", + "text": "minimalist design (simple is beautiful) FAST ATOM and RSS feeds views: paginated link list tag cloud picture wall: image and video thumbnails daily: newspaper-like daily digest daily RSS feed permalinks for easy reference links can be public or private extensible through plugins", + "title": "Interface" + }, + { + "location": "/#tag-view-and-search-your-links", + "text": "add a custom title and description to archived links add tags to classify and search links features tag autocompletion, renaming, merging and deletion full-text and tag search", + "title": "Tag, view and search your links!" + }, + { + "location": "/#easy-setup", + "text": "dead-simple installation: drop the files, open the page links are stored in a file compact storage no database required easy backup: simply copy the datastore file import and export links as Netscape bookmarks", + "title": "Easy setup" + }, + { + "location": "/#accessibility", + "text": "Firefox bookmarlet to share links in one click support for mobile browsers works with Javascript disabled easy page customization through HTML/CSS/RainTPL", + "title": "Accessibility" + }, + { + "location": "/#security", + "text": "bruteforce-proof login form protected against XSRF \nand session cookie hijacking", + "title": "Security" + }, + { + "location": "/#goodies", + "text": "thumbnail generation for images and video services:\ndailymotion, flickr, imageshack, imgur, vimeo, xkcd, youtube... lazy-loading with bLazy PubSubHubbub protocol support URL cleanup: automatic removal of ?utm_source=... , fb=... discreet pop-up notification when a new release is available", + "title": "Goodies" + }, + { + "location": "/#rest-api", + "text": "Easily extensible by any client using the REST API exposed by Shaarli. See the API documentation .", + "title": "REST API" + }, + { + "location": "/#other-usages", + "text": "Though Shaarli is primarily a bookmarking application, it can serve other purposes\n(see usage examples ):\n- micro-blogging\n- pastebin\n- online notepad\n- snippet archive", + "title": "Other usages" + }, + { + "location": "/#about", + "text": "", + "title": "About" + }, + { + "location": "/#shaarli-community-fork", + "text": "This friendly fork is maintained by the Shaarli community at https://github.com/shaarli/Shaarli This is a community fork of the original Shaarli project by S\u00e9bastien Sauvage . The original project is currently unmaintained, and the developer has informed us \nthat he would have no time to work on Shaarli in the near future.\nThe Shaarli community has carried on the work to provide many patches \nfor bug fixes and enhancements \nin this repository, and will keep maintaining the project for the foreseeable future, while keeping Shaarli simple and efficient.", + "title": "Shaarli community fork" + }, + { + "location": "/#contributing", + "text": "If you'd like to help, please:\n- have a look at the open issues \nand pull requests \n- feel free to report bugs (feedback is much appreciated)\n- suggest new features and improvements to both code and documentation \n- propose solutions to existing problems\n- submit pull requests :-)", + "title": "Contributing" + }, + { + "location": "/#license", + "text": "Shaarli is Free Software . See COPYING for a detail of the contributors and licenses for each individual component.", + "title": "License" + }, { "location": "/Download-and-Installation/", "text": "To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your \nserver\n is properly \nconfigured\n.\n\n\nSeveral releases are available:\n\n\n\n\nLatest release (recommended)\n\n\nDownload as an archive\n\n\nGet the latest released version from the \nreleases\n page.\n\n\nDownload our \nshaarli-full\n archive\n to include dependencies.\n\n\nThe current latest released version is \nv0.8.4\n\n\nOr in command lines:\n\n\n$ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip\n$ unzip shaarli-v0.8.4-full.zip\n$ mv Shaarli /path/to/shaarli/\n\n\n\n\n\n\n\n\n\n\n!\n\n\nIn most cases, download Shaarli from the \nreleases\n page. Cloning using \ngit\n or downloading Github branches as zip files requires additional steps (see below).\n\n\n\n\n\n\n\n\n\n\nUsing git\n\n\nmkdir -p /path/to/shaarli && cd /path/to/shaarli/\ngit clone -b v0.8 https://github.com/shaarli/Shaarli.git .\ncomposer install --no-dev\n\n\n\n\n\n\nStable version\n\n\nThe stable version has been experienced by Shaarli users, and will receive security updates.\n\n\nDownload as an archive\n\n\nAs a .zip archive:\n\n\n$ wget https://github.com/shaarli/Shaarli/archive/stable.zip\n$ unzip stable.zip\n$ mv Shaarli-stable /path/to/shaarli/\n\n\n\n\nAs a .tar.gz archive :\n\n\n$ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz\n$ tar xvf stable.tar.gz\n$ mv Shaarli-stable /path/to/shaarli/\n\n\n\n\nClone with Git\n\n\nComposer\n is required to build a functional Shaarli installation when pulling from git.\n\n\n$ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli/\n$ composer install --no-dev\n\n\n\n\n\n\nDevelopment version (mainline)\n\n\nUse at your own risk!\n\n\nTo get the latest changes from the \nmaster\n branch:\n\n\n# clone the repository \n$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/\n# install/update third-party dependencies\n$ cd /path/to/shaarli\n$ composer install --no-dev\n\n\n\n\n\n\nFinish Installation\n\n\nOnce Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.\n\n\n\n\nSetup your Shaarli installation, and it's ready to use!\n\n\n\n\nUpdating Shaarli\n\n\nSee \nUpgrade and Migration", @@ -1177,12 +1252,12 @@ }, { "location": "/Release-Shaarli/", - "text": "See \nGit - Maintaining a project - Tagging your \nreleases\n.\n\n\nPrerequisites\n\n\nThis guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your \n~/.gitconfig\n \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - \norigin\n pointing to your GitHub fork\n - \nupstream\n pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- \nComposer\n and \nPandoc\n need to be installed\n\n\nGitHub release draft and \nCHANGELOG.md\n\n\nSee http://keepachangelog.com/en/0.3.0/ for changelog formatting.\n\n\nGitHub release draft\n\n\nGitHub allows drafting the release note for the upcoming release, from the \nReleases\n page. This way, the release note can be drafted while contributions are merged to \nmaster\n.\n\n\nCHANGELOG.md\n\n\nThis file should contain the same information as the release note draft for the upcoming version.\n\n\nUpdate it to:\n- add new entries (additions, fixes, etc.)\n- mark the current version as released by setting its date and link\n- add a new section for the future unreleased version\n\n\n$ cd /path/to/shaarli\n\n$ nano CHANGELOG.md\n\n[...]\n## vA.B.C - UNRELEASED\nTBA\n\n## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD\n[...]\n\n\n\n\nIncrement the version code, updated docs, create and push a signed tag\n\n\nGenerate documentation\n\n\n$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the documentation from the wiki\n$ make htmldoc\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0\n\n\n\n\nCreate and merge a Pull Request\n\n\nThis one is pretty straightforward ;-)\n\n\nBump Shaarli version to v0.x branch\n\n\n$ git checkout master\n$ git fetch upstream\n$ git pull upstream master\n\n# IF the branch doesn't exists\n$ git checkout -b v0.5\n# OR if the branch already exists\n$ git checkout v0.5\n$ git rebase upstream/master\n\n# Bump shaarli version from dev to 0.5.0, **without the `v`**\n$ vim shaarli_version.php\n$ git add shaarli_version\n$ git commit -s -m \"Bump Shaarli version to v0.5.0\"\n$ git push upstream v0.5\n\n\n\n\nCreate and push a signed tag\n\n\n# update your local copy\n$ git checkout v0.5\n$ git fetch upstream\n$ git pull upstream v0.5\n\n# create a signed tag\n$ git tag -s -m \"Release v0.5.0\" v0.5.0\n\n# push it to \"upstream\"\n$ git push --tags upstream\n\n\n\n\nVerify a signed tag\n\n\nv0.5.0\n is the first GPG-signed tag pushed on the Community Shaarli.\n\n\nLet's have a look at its signature!\n\n\n$ cd /path/to/shaarli\n$ git fetch upstream\n\n# get the SHA1 reference of the tag\n$ git show-ref tags/v0.5.0\nf7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0\n\n# verify the tag signature information\n$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1\ngpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F\ngpg: Good signature from \"VirtualTam \" [ultimate]\n\n\n\n\nPublish the GitHub release\n\n\nUpdate release badges\n\n\nUpdate \nREADME.md\n so version badges display and point to the newly released Shaarli version(s), in the \nmaster\n branch.\n\n\nCreate a GitHub release from a Git tag\n\n\nFrom the previously drafted release:\n- edit the release notes (if needed)\n- specify the appropriate Git tag\n- publish the release\n- profit!\n\n\nGenerate and upload all-in-one release archives\n\n\nUsers with a shared hosting may have:\n- no SSH access\n- no possibility to install PHP packages or server extensions\n- no possibility to run scripts\n\n\nTo ease Shaarli installations, it is possible to generate and upload additional release archives,\nthat will contain Shaarli code plus all required third-party libraries.\n\n\nFrom the \nv0.5\n branch:\n\n\n$ make release_archive\n\n\n\n\nThis will create the following archives:\n- \nshaarli-vX.Y.Z-full.tar\n\n- \nshaarli-vX.Y.Z-full.zip\n\n\nThe archives need to be manually uploaded on the previously created GitHub release.\n\n\nUpdate \nstable\n and \nlatest\n branches\n\n\n$ git checkout latest\n# latest release\n$ git merge v0.5.0\n# fix eventual conflicts\n$ make test\n$ git push upstream latest\n$ git checkout stable\n# latest previous major\n$ git merge v0.4.5 \n# fix eventual conflicts\n$ make test\n$ git push upstream stable", + "text": "See \nGit - Maintaining a project - Tagging your \nreleases\n.\n\n\nPrerequisites\n\n\nThis guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your \n~/.gitconfig\n \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - \norigin\n pointing to your GitHub fork\n - \nupstream\n pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- \nComposer\n needs to be installed\n- The \nvenv\n Python 3 module needs to be installed for HTML documentation generation.\n\n\nGitHub release draft and \nCHANGELOG.md\n\n\nSee http://keepachangelog.com/en/0.3.0/ for changelog formatting.\n\n\nGitHub release draft\n\n\nGitHub allows drafting the release note for the upcoming release, from the \nReleases\n page. This way, the release note can be drafted while contributions are merged to \nmaster\n.\n\n\nCHANGELOG.md\n\n\nThis file should contain the same information as the release note draft for the upcoming version.\n\n\nUpdate it to:\n- add new entries (additions, fixes, etc.)\n- mark the current version as released by setting its date and link\n- add a new section for the future unreleased version\n\n\n$ cd /path/to/shaarli\n\n$ nano CHANGELOG.md\n\n[...]\n## vA.B.C - UNRELEASED\nTBA\n\n## [vX.Y.Z](https://github.com/shaarli/Shaarli/releases/tag/vX.Y.Z) - YYYY-MM-DD\n[...]\n\n\n\n\nIncrement the version code, updated docs, create and push a signed tag\n\n\nGenerate documentation\n\n\n$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the HTML documentation from Markdown\n$ make htmlpages\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0\n\n\n\n\nCreate and merge a Pull Request\n\n\nThis one is pretty straightforward ;-)\n\n\nBump Shaarli version to v0.x branch\n\n\n$ git checkout master\n$ git fetch upstream\n$ git pull upstream master\n\n# IF the branch doesn't exists\n$ git checkout -b v0.5\n# OR if the branch already exists\n$ git checkout v0.5\n$ git rebase upstream/master\n\n# Bump shaarli version from dev to 0.5.0, **without the `v`**\n$ vim shaarli_version.php\n$ git add shaarli_version\n$ git commit -s -m \"Bump Shaarli version to v0.5.0\"\n$ git push upstream v0.5\n\n\n\n\nCreate and push a signed tag\n\n\n# update your local copy\n$ git checkout v0.5\n$ git fetch upstream\n$ git pull upstream v0.5\n\n# create a signed tag\n$ git tag -s -m \"Release v0.5.0\" v0.5.0\n\n# push it to \"upstream\"\n$ git push --tags upstream\n\n\n\n\nVerify a signed tag\n\n\nv0.5.0\n is the first GPG-signed tag pushed on the Community Shaarli.\n\n\nLet's have a look at its signature!\n\n\n$ cd /path/to/shaarli\n$ git fetch upstream\n\n# get the SHA1 reference of the tag\n$ git show-ref tags/v0.5.0\nf7762cf803f03f5caf4b8078359a63783d0090c1 refs/tags/v0.5.0\n\n# verify the tag signature information\n$ git verify-tag f7762cf803f03f5caf4b8078359a63783d0090c1\ngpg: Signature made Thu 30 Jul 2015 11:46:34 CEST using RSA key ID 4100DF6F\ngpg: Good signature from \"VirtualTam \" [ultimate]\n\n\n\n\nPublish the GitHub release\n\n\nUpdate release badges\n\n\nUpdate \nREADME.md\n so version badges display and point to the newly released Shaarli version(s), in the \nmaster\n branch.\n\n\nCreate a GitHub release from a Git tag\n\n\nFrom the previously drafted release:\n- edit the release notes (if needed)\n- specify the appropriate Git tag\n- publish the release\n- profit!\n\n\nGenerate and upload all-in-one release archives\n\n\nUsers with a shared hosting may have:\n- no SSH access\n- no possibility to install PHP packages or server extensions\n- no possibility to run scripts\n\n\nTo ease Shaarli installations, it is possible to generate and upload additional release archives,\nthat will contain Shaarli code plus all required third-party libraries.\n\n\nFrom the \nv0.5\n branch:\n\n\n$ make release_archive\n\n\n\n\nThis will create the following archives:\n- \nshaarli-vX.Y.Z-full.tar\n\n- \nshaarli-vX.Y.Z-full.zip\n\n\nThe archives need to be manually uploaded on the previously created GitHub release.\n\n\nUpdate \nstable\n and \nlatest\n branches\n\n\n$ git checkout latest\n# latest release\n$ git merge v0.5.0\n# fix eventual conflicts\n$ make test\n$ git push upstream latest\n$ git checkout stable\n# latest previous major\n$ git merge v0.4.5 \n# fix eventual conflicts\n$ make test\n$ git push upstream stable", "title": "Release Shaarli" }, { "location": "/Release-Shaarli/#prerequisites", - "text": "This guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your ~/.gitconfig \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - origin pointing to your GitHub fork\n - upstream pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- Composer and Pandoc need to be installed", + "text": "This guide assumes that you have:\n- a GPG key matching your GitHub authentication credentials\n - i.e., the email address identified by the GPG key is the same as the one in your ~/.gitconfig \n- a GitHub fork of Shaarli\n- a local clone of your Shaarli fork, with the following remotes:\n - origin pointing to your GitHub fork\n - upstream pointing to the main Shaarli repository\n- maintainer permissions on the main Shaarli repository, to:\n - push the signed tag\n - create a new release\n- Composer needs to be installed\n- The venv Python 3 module needs to be installed for HTML documentation generation.", "title": "Prerequisites" }, { @@ -1207,7 +1282,7 @@ }, { "location": "/Release-Shaarli/#generate-documentation", - "text": "$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the documentation from the wiki\n$ make htmldoc\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0", + "text": "$ cd /path/to/shaarli\n\n# create a new branch\n$ git fetch upstream\n$ git checkout upstream/master -b v0.5.0\n\n# rebuild the HTML documentation from Markdown\n$ make htmlpages\n\n# commit the changes\n$ git add doc\n$ git commit -s -m \"Generate documentation for v0.5.0\"\n\n# push the commit on your GitHub fork\n$ git push origin v0.5.0", "title": "Generate documentation" }, { diff --git a/doc/html/sitemap.xml b/doc/html/sitemap.xml index 2a1b009e..cbf35654 100644 --- a/doc/html/sitemap.xml +++ b/doc/html/sitemap.xml @@ -4,7 +4,7 @@ / - 2017-06-18 + 2017-07-04 daily @@ -13,43 +13,43 @@ /Download-and-Installation/ - 2017-06-18 + 2017-07-04 daily /Upgrade-and-migration/ - 2017-06-18 + 2017-07-04 daily /Server-requirements/ - 2017-06-18 + 2017-07-04 daily /Server-configuration/ - 2017-06-18 + 2017-07-04 daily /Server-security/ - 2017-06-18 + 2017-07-04 daily /Shaarli-configuration/ - 2017-06-18 + 2017-07-04 daily /Plugins/ - 2017-06-18 + 2017-07-04 daily @@ -59,25 +59,25 @@ /Docker-101/ - 2017-06-18 + 2017-07-04 daily /Shaarli-images/ - 2017-06-18 + 2017-07-04 daily /Reverse-proxy-configuration/ - 2017-06-18 + 2017-07-04 daily /Docker-resources/ - 2017-06-18 + 2017-07-04 daily @@ -87,37 +87,37 @@ /Features/ - 2017-06-18 + 2017-07-04 daily /Bookmarklet/ - 2017-06-18 + 2017-07-04 daily /Browsing-and-searching/ - 2017-06-18 + 2017-07-04 daily /Firefox-share/ - 2017-06-18 + 2017-07-04 daily /RSS-feeds/ - 2017-06-18 + 2017-07-04 daily /REST-API/ - 2017-06-18 + 2017-07-04 daily @@ -127,13 +127,13 @@ /Backup,-restore,-import-and-export/ - 2017-06-18 + 2017-07-04 daily /Various-hacks/ - 2017-06-18 + 2017-07-04 daily @@ -142,7 +142,7 @@ /Troubleshooting/ - 2017-06-18 + 2017-07-04 daily @@ -151,79 +151,79 @@ /Development-guidelines/ - 2017-06-18 + 2017-07-04 daily /Continuous-integration-tools/ - 2017-06-18 + 2017-07-04 daily /GnuPG-signature/ - 2017-06-18 + 2017-07-04 daily /Coding-guidelines/ - 2017-06-18 + 2017-07-04 daily /Directory-structure/ - 2017-06-18 + 2017-07-04 daily /3rd-party-libraries/ - 2017-06-18 + 2017-07-04 daily /Plugin-System/ - 2017-06-18 + 2017-07-04 daily /Release-Shaarli/ - 2017-06-18 + 2017-07-04 daily /Versioning-and-Branches/ - 2017-06-18 + 2017-07-04 daily /Security/ - 2017-06-18 + 2017-07-04 daily /Static-analysis/ - 2017-06-18 + 2017-07-04 daily /Theming/ - 2017-06-18 + 2017-07-04 daily /Unit-tests/ - 2017-06-18 + 2017-07-04 daily @@ -233,13 +233,13 @@ /FAQ/ - 2017-06-18 + 2017-07-04 daily /Community-&-Related-software/ - 2017-06-18 + 2017-07-04 daily From 8bf94136e10c64496711c8f66a4f58f89c515360 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:30:50 +0200 Subject: [PATCH 35/67] makefile: remove [[link]] -> [link](url) conversion logic all links in documentation have been converted to standard markdown link syntax --- Makefile | 6 ------ 1 file changed, 6 deletions(-) diff --git a/Makefile b/Makefile index 2064303a..c5dee80e 100644 --- a/Makefile +++ b/Makefile @@ -198,12 +198,6 @@ doxygen: clean # - convert GitHub-flavoured relative links to standard Markdown # - generate html documentation with mkdocs htmlpages: - # Rename local [[links]] to regular links. - @for file in `find doc/md/ -maxdepth 1 -name "*.md"`; do \ - sed -e "s/\[\[\(.*\)\]\]/[\1](\1)/g" "$$file" > doc/md/tmp.md; \ - mv doc/md/tmp.md $$file; \ - done - python3 -m venv venv/ bash -c 'source venv/bin/activate; \ pip install mkdocs; \ From 70cb883547a04b3ccd3fda567d15541d124a3f41 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 4 Jul 2017 21:43:40 +0200 Subject: [PATCH 36/67] doc: contributing: remove leftover link to wiki --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3646408f..bb82951d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -18,7 +18,7 @@ Check the [milestones](https://github.com/shaarli/Shaarli/milestones) to see wha ### Documentation -The [official documentation](http://shaarli.readthedocs.io/en/rtfd/) https://github.com/shaarli/Shaarli/wiki) is generated from [Markdown](https://daringfireball.net/projects/markdown/syntax) documents in the `doc/md/` directory. HTML documentation is generated using [Mkdocs](http://www.mkdocs.org/). [Read the Docs](https://readthedocs.org/) provides hosting for the online documentation. +The [official documentation](http://shaarli.readthedocs.io/en/rtfd/) is generated from [Markdown](https://daringfireball.net/projects/markdown/syntax) documents in the `doc/md/` directory. HTML documentation is generated using [Mkdocs](http://www.mkdocs.org/). [Read the Docs](https://readthedocs.org/) provides hosting for the online documentation. To edit the documentation, please edit the appropriate `doc/md/*.md` files (and optionally `make htmlpages` to preview changes to HTML files). Then submit your changes as a Pull Request. Have a look at the MkDocs documentation and configuration file `mkdocs.yml` if you need to add/remove/rename/reorder pages. From b80315e2384a92e7a7ea8c3a6d4b38957851061b Mon Sep 17 00:00:00 2001 From: Stephen Muth Date: Sat, 8 Jul 2017 00:01:03 +0000 Subject: [PATCH 37/67] Respect HTTP_X_FORWARDED_HOST alongside _PORT and _PROTO Fixes #879 --- application/HttpUtils.php | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/application/HttpUtils.php b/application/HttpUtils.php index a81f9056..88a1efdb 100644 --- a/application/HttpUtils.php +++ b/application/HttpUtils.php @@ -311,7 +311,19 @@ function server_url($server) } } - return $scheme.'://'.$server['SERVER_NAME'].$port; + if (isset($server['HTTP_X_FORWARDED_HOST'])) { + // Keep forwarded host + if (strpos($server['HTTP_X_FORWARDED_HOST'], ',') !== false) { + $hosts = explode(',', $server['HTTP_X_FORWARDED_HOST']); + $host = trim($hosts[0]); + } else { + $host = $server['HTTP_X_FORWARDED_HOST']; + } + } else { + $host = $server['SERVER_NAME']; + } + + return $scheme.'://'.$host.$port; } // SSL detection From a5fbc689f8989ffd1181af4530a932dd0f1ed76b Mon Sep 17 00:00:00 2001 From: nodiscc Date: Tue, 11 Jul 2017 14:30:14 +0200 Subject: [PATCH 38/67] Remove merge conflict leftover Fixes #900 --- tpl/default/page.footer.html | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/tpl/default/page.footer.html b/tpl/default/page.footer.html index 84f13612..94f771a2 100644 --- a/tpl/default/page.footer.html +++ b/tpl/default/page.footer.html @@ -1,13 +1,3 @@ -<<<<<<< HEAD -======= -
    @@ -19,7 +9,7 @@ {/if} · The personal, minimalist, super-fast, database free, bookmarking service by the Shaarli community · - Documentation + Documentation {loop="$plugins_footer.text"} {$value} {/loop} From 0b51ea72517efa8731348cfaed410c71cb2bfd91 Mon Sep 17 00:00:00 2001 From: Stephen Muth Date: Wed, 12 Jul 2017 17:57:47 +0000 Subject: [PATCH 39/67] Add tests to cover new server_url behavior --- tests/HttpUtils/ServerUrlTest.php | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/tests/HttpUtils/ServerUrlTest.php b/tests/HttpUtils/ServerUrlTest.php index 7fdad659..dac02b3e 100644 --- a/tests/HttpUtils/ServerUrlTest.php +++ b/tests/HttpUtils/ServerUrlTest.php @@ -38,6 +38,34 @@ public function testHttpsScheme() ); } + /** + * Detect a Proxy that sets Forwarded-Host + */ + public function testHttpsProxyForwardedHost() + { + $this->assertEquals( + 'https://host.tld:8080', + server_url( + array( + 'HTTP_X_FORWARDED_PROTO' => 'https', + 'HTTP_X_FORWARDED_PORT' => '8080', + 'HTTP_X_FORWARDED_HOST' => 'host.tld' + ) + ) + ); + + $this->assertEquals( + 'https://host.tld:4974', + server_url( + array( + 'HTTP_X_FORWARDED_PROTO' => 'https, https', + 'HTTP_X_FORWARDED_PORT' => '4974, 80', + 'HTTP_X_FORWARDED_HOST' => 'host.tld, example.com' + ) + ) + ); + } + /** * Detect a Proxy with SSL enabled */ From 6d074b4c908d6ba10e0397302ed55ed07742313a Mon Sep 17 00:00:00 2001 From: nodiscc Date: Thu, 20 Jul 2017 19:52:39 +0200 Subject: [PATCH 40/67] doc: fix bullet list formatting https://shaarli.readthedocs.io/en/master/Shaarli-configuration/ --- doc/md/Shaarli-configuration.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/md/Shaarli-configuration.md b/doc/md/Shaarli-configuration.md index 933f5245..0c605459 100644 --- a/doc/md/Shaarli-configuration.md +++ b/doc/md/Shaarli-configuration.md @@ -11,6 +11,7 @@ Once your Shaarli instance is installed, the file `data/config.json.php` is gene ## File and directory permissions The server process running Shaarli must have: + - `read` access to the following resources: - PHP scripts: `index.php`, `application/*.php`, `plugins/*.php` - 3rd party PHP and Javascript libraries: `inc/*.php`, `inc/*.js` @@ -25,6 +26,7 @@ The server process running Shaarli must have: - `tmp` - RainTPL page cache On a Linux distribution: + - the web server user will likely be `www` or `http` (for Apache2) - it will be a member of a group of the same name: `www:www`, `http:http` - to give it access to Shaarli, either: From 84d0632a2df1cf833610bc8dd45d4808e4a8dc0e Mon Sep 17 00:00:00 2001 From: VirtualTam Date: Sat, 29 Jul 2017 15:26:27 +0200 Subject: [PATCH 41/67] docker: remove `dev` image, update documentation Relates to https://github.com/shaarli/Shaarli/issues/843 Changed: - Update Docker image list - Update Docker documentation structure Removed: - Delete Dockerfile and resources for the `dev` image - Cleanup `doc/` resources Signed-off-by: VirtualTam --- doc/Docker.md | 158 ------------------ doc/REST-API.md | 105 ------------ doc/Versioning-and-Branches.md | 76 --------- doc/_Sidebar.md | 39 ----- .../{Docker-101.md => docker/docker-101.md} | 0 .../resources.md} | 0 .../reverse-proxy-configuration.md} | 0 .../shaarli-images.md} | 1 - docker/development/Dockerfile | 38 ----- docker/development/IMAGE.md | 10 -- docker/development/nginx.conf | 80 --------- docker/development/supervised.conf | 13 -- mkdocs.yml | 8 +- 13 files changed, 4 insertions(+), 524 deletions(-) delete mode 100644 doc/Docker.md delete mode 100644 doc/REST-API.md delete mode 100644 doc/Versioning-and-Branches.md delete mode 100644 doc/_Sidebar.md rename doc/md/{Docker-101.md => docker/docker-101.md} (100%) rename doc/md/{Docker-resources.md => docker/resources.md} (100%) rename doc/md/{Reverse-proxy-configuration.md => docker/reverse-proxy-configuration.md} (100%) rename doc/md/{Shaarli-images.md => docker/shaarli-images.md} (98%) delete mode 100644 docker/development/Dockerfile delete mode 100644 docker/development/IMAGE.md delete mode 100644 docker/development/nginx.conf delete mode 100644 docker/development/supervised.conf diff --git a/doc/Docker.md b/doc/Docker.md deleted file mode 100644 index a7d2efb5..00000000 --- a/doc/Docker.md +++ /dev/null @@ -1,158 +0,0 @@ -#Docker -- [Docker usage](#docker-usage)[](.html) -- [Get and run a Shaarli image](#get-and-run-a-shaarli-image)[](.html) -- [Resources](#resources)[](.html) - -## Docker usage -### Basics -Install [Docker](https://www.docker.com/), by following the instructions relevant[](.html) -to your OS / distribution, and start the service. - -#### Search an image on [DockerHub](https://hub.docker.com/)[](.html) - -```bash -$ docker search debian - -NAME DESCRIPTION STARS OFFICIAL AUTOMATED -ubuntu Ubuntu is a Debian-based Linux operating s... 2065 [OK][](.html) -debian Debian is a Linux distribution that's comp... 603 [OK][](.html) -google/debian 47 [OK][](.html) -``` - -#### Show available tags for a repository -```bash -$ curl https://index.docker.io/v1/repositories/debian/tags | python -m json.tool - -% Total % Received % Xferd Average Speed Time Time Time Current -Dload Upload Total Spent Left Speed -100 1283 0 1283 0 0 433 0 --:--:-- 0:00:02 --:--:-- 433 -``` - -Sample output: -```json -[[](.html) - { - "layer": "85a02782", - "name": "stretch" - }, - { - "layer": "59abecbc", - "name": "testing" - }, - { - "layer": "bf0fd686", - "name": "unstable" - }, - { - "layer": "60c52dbe", - "name": "wheezy" - }, - { - "layer": "c5b806fe", - "name": "wheezy-backports" - } -] - -``` - -#### Pull an image from DockerHub -```bash -$ docker pull repository[:tag][](.html) - -$ docker pull debian:wheezy -wheezy: Pulling from debian -4c8cbfd2973e: Pull complete -60c52dbe9d91: Pull complete -Digest: sha256:c584131da2ac1948aa3e66468a4424b6aea2f33acba7cec0b631bdb56254c4fe -Status: Downloaded newer image for debian:wheezy -``` - -## Get and run a Shaarli image -### DockerHub repository -The images can be found in the [`shaarli/shaarli`](https://hub.docker.com/r/shaarli/shaarli/)[](.html) -repository. - -### Available image tags -- `latest`: master branch (tarball release) -- `stable`: stable branch (tarball release) -- `dev`: master branch (Git clone) - -All images rely on: -- [Debian 8 Jessie](https://hub.docker.com/_/debian/)[](.html) -- [PHP5-FPM](http://php-fpm.org/)[](.html) -- [Nginx](http://nginx.org/)[](.html) - -### Download from DockerHub -```bash -$ docker pull shaarli/shaarli -latest: Pulling from shaarli/shaarli -32716d9fcddb: Pull complete -84899d045435: Pull complete -4b6ad7444763: Pull complete -e0345ef7a3e0: Pull complete -5c1dd344094f: Pull complete -6422305a200b: Pull complete -7d63f861dbef: Pull complete -3eb97210645c: Pull complete -869319d746ff: Already exists -869319d746ff: Pulling fs layer -902b87aaaec9: Already exists -Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98 -Status: Downloaded newer image for shaarli/shaarli:latest -``` - -### Create and start a new container from the image -```bash -# map the host's :8000 port to the container's :80 port -$ docker create -p 8000:80 shaarli/shaarli -d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 - -# launch the container in the background -$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 -d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101 - -# list active containers -$ docker ps -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo -``` - -### Stop and destroy a container -```bash -$ docker stop backstabbing_galileo # those docker guys are really rude to physicists! -backstabbing_galileo - -# check the container is stopped -$ docker ps -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - -# list ALL containers -$ docker ps -a -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo - -# destroy the container -$ docker rm backstabbing_galileo # let's put an end to these barbarian practices -backstabbing_galileo - -$ docker ps -a -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -``` - -## Resources -### Docker -- [Interactive Docker training portal](https://www.katacoda.com/courses/docker/) on [Katakoda](https://www.katacoda.com/)[](.html) -- [Where are Docker images stored?](http://blog.thoward37.me/articles/where-are-docker-images-stored/)[](.html) -- [Dockerfile reference](https://docs.docker.com/reference/builder/)[](.html) -- [Dockerfile best practices](https://docs.docker.com/articles/dockerfile_best-practices/)[](.html) -- [Volumes](https://docs.docker.com/userguide/dockervolumes/)[](.html) - -### DockerHub -- [Repositories](https://docs.docker.com/userguide/dockerrepos/)[](.html) -- [Teams and organizations](https://docs.docker.com/docker-hub/orgs/)[](.html) -- [GitHub automated build](https://docs.docker.com/docker-hub/github/)[](.html) - -### Service management -- [Using supervisord](https://docs.docker.com/articles/using_supervisord/)[](.html) -- [Nginx in the foreground](http://nginx.org/en/docs/ngx_core_module.html#daemon)[](.html) -- [supervisord](http://supervisord.org/)[](.html) diff --git a/doc/REST-API.md b/doc/REST-API.md deleted file mode 100644 index d7909978..00000000 --- a/doc/REST-API.md +++ /dev/null @@ -1,105 +0,0 @@ -#REST API -## Usage - -See the [REST API documentation](http://shaarli.github.io/api-documentation/).[](.html) - -## Authentication - -All requests to Shaarli's API must include a JWT token to verify their authenticity. - -This token has to be included as an HTTP header called `Authentication: Bearer `. - -JWT resources : - - * [jwt.io](https://jwt.io) (including a list of client per language).[](.html) - * RFC : https://tools.ietf.org/html/rfc7519 - * https://float-middle.com/json-web-tokens-jwt-vs-sessions/ - * HackerNews thread: https://news.ycombinator.com/item?id=11929267 - - -### Shaarli JWT Token - -JWT tokens are composed by three parts, separated by a dot `.` and encoded in base64: - -``` -[header].[payload].[signature][](.html) -``` - -#### Header - -Shaarli only allow one hash algorithm, so the header will always be the same: - -```json -{ - "typ": "JWT", - "alg": "HS512" -} -``` - -Encoded in base64, it gives: - -``` -ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ== -``` - -#### Payload - -**Validity duration** - -To avoid infinite token validity, JWT tokens must include their creation date in UNIX timestamp format (timezone independant - UTC) under the key `iat` (issued at). This token will be accepted during 9 minutes. - -```json -{ - "iat": 1468663519 -} -``` - -See [RFC reference](https://tools.ietf.org/html/rfc7519#section-4.1.6).[](.html) - - -#### Signature - -The signature authenticate the token validity. It contains the base64 of the header and the body, separated by a dot `.`, hashed in SHA512 with the API secret available in Shaarli administration page. - -Signature example with PHP: - -```php -$content = base64_encode($header) . '.' . base64_encode($payload); -$signature = hash_hmac('sha512', $content, $secret); -``` - - -### Complete example - -#### PHP - -```php -function generateToken($secret) { - $header = base64_encode('{ - "typ": "JWT", - "alg": "HS512" - }'); - $payload = base64_encode('{ - "iat": '. time() .' - }'); - $signature = hash_hmac('sha512', $header .'.'. $payload , $secret); - return $header .'.'. $payload .'.'. $signature; -} - -$secret = 'mysecret'; -$token = generateToken($secret); -echo $token; -``` - -> `ewogICAgICAgICJ0eXAiOiAiSldUIiwKICAgICAgICAiYWxnIjogIkhTNTEyIgogICAgfQ==.ewogICAgICAgICJpYXQiOiAxNDY4NjY3MDQ3CiAgICB9.1d2c54fa947daf594fdbf7591796195652c8bc63bffad7f6a6db2a41c313f495a542cbfb595acade79e83f3810d709b4251d7b940bbc10b531a6e6134af63a68` - -```php -$options = [[](.html) - 'http' => [[](.html) - 'method' => 'GET', - 'jwt' => $token, - ], -]; -$context = stream_context_create($options); -file_get_contents($apiEndpoint, false, $context); -``` diff --git a/doc/Versioning-and-Branches.md b/doc/Versioning-and-Branches.md deleted file mode 100644 index bbc7719e..00000000 --- a/doc/Versioning-and-Branches.md +++ /dev/null @@ -1,76 +0,0 @@ -#Versioning and Branches -[**WORK IN PROGRESS**][](.html) - -It's important to understand how Shaarli branches work, especially if you're maintaining a 3rd party tools for Shaarli (theme, plugin, etc.), to be sure stay compatible. - -## `master` branch - -The `master` branch is the development branch. Any new change MUST go through this branch using Pull Requests. - -Remarks: - - * This branch shouldn't be used for production as it isn't necessary stable. - * 3rd party aren't required to be compatible with the latest changes. - * Official plugins, themes and libraries (contained within Shaarli organization repos) must be compatible with the master branch. - * The version in this branch is always `dev`. - -## `v0.x` branch - -This `v0.x` branch, points to the latest `v0.x.y` release. - -Explanation: - -When a new version is released, it might contains a major bug which isn't detected right away. For example, a new PHP version is released, containing backward compatibility issue which doesn't work with Shaarli. - -In this case, the issue is fixed in the `master` branch, and the fix is backported the to the `v0.x` branch. Then a new release is made from the `v0.x` branch. - -This workflow allow us to fix any major bug detected, without having to release bleeding edge feature too soon. - -## `latest` branch - -This branch point the latest release. It recommended to use it to get the latest tested changes. - -## `stable` branch - -The `stable` branch doesn't contain any major bug, and is one major digit version behind the latest release. - -For example, the current latest release is `v0.8.3`, the stable branch is an alias to the latest `v0.7.x` release. When the `v0.9.0` version will be released, the stable will move to the latest `v0.8.x` release. - -Remarks: - - * Shaarli release pace isn't fast, and the stable branch might be a few months behind the latest release. - -## Releases - -Releases are always made from the latest `v0.x` branch. - -Note that for every release, we manually generate a tarball which contains all Shaarli dependencies, making Shaarli's installation only one step. - -## Advices on 3rd party git repos workflow - -### Versioning - -Any time a new Shaarli release is published, you should publish a new release of your repo if the changes affected you since the latest release (take a look at the [changelog](https://github.com/shaarli/Shaarli/releases) (*Draft* means not released yet) and the commit log (like [`tpl` folder](https://github.com/shaarli/Shaarli/commits/master/tpl/default) for themes)). You can either:[](.html) - - - use the Shaarli version number, with your repo version. For example, if Shaarli `v0.8.3` is released, publish a `v0.8.3-1` release, where `v0.8.3` states Shaarli compatibility and `-1` is your own version digit for the current Shaarli version. - - use your own versioning scheme, and state Shaarli compatibility in the release description. - -Using this, any user will be able to pick the release matching his own Shaarli version. - -### Major bugfix backport releases - -To be able to support backported fixes, it recommended to use our workflow: - -```bash -# In master, fix the major bug -git commit -m "Katastrophe" -git push origin master -# Get your commit hash -git log --format="%H" -n 1 -# Create a new branch from your latest release, let's say v0.8.2-1 (the tag name) -git checkout -b katastrophe v0.8.2-1 -# Backport the fix commit to your brand new branch -git cherry-pick -git push origin katastrophe -# Then you just have to make a new release from the `katastrophe` branch tagged `v0.8.3-1` -``` diff --git a/doc/_Sidebar.md b/doc/_Sidebar.md deleted file mode 100644 index 8df2e565..00000000 --- a/doc/_Sidebar.md +++ /dev/null @@ -1,39 +0,0 @@ -#_Sidebar -- [Home](Home.html) -- Setup - - [Download and Installation](Download-and-Installation.html) - - [Upgrade and migration](Upgrade-and-migration.html) - - [Server requirements](Server-requirements.html) - - [Server configuration](Server-configuration.html) - - [Server security](Server-security.html) - - [Shaarli configuration](Shaarli-configuration.html) - - [Plugins](Plugins.html) -- [Docker](Docker.html) -- [Usage](Usage.html) - - [Sharing button](Sharing-button.html) (bookmarklet) - - [Browsing and Searching](Browsing-and-Searching.html) - - [Firefox share](Firefox-share.html) - - [RSS feeds](RSS-feeds.html) - - [REST API](REST-API.html) -- How To - - [Backup, restore, import and export](Backup,-restore,-import-and-export.html) - - [Copy an existing installation over SSH and serve it locally](Copy-an-existing-installation-over-SSH-and-serve-it-locally.html) - - [Create and serve multiple Shaarlis (farm)](Create-and-serve-multiple-Shaarlis-(farm).html) - - [Download CSS styles from an OPML list](Download-CSS-styles-from-an-OPML-list.html) - - [Datastore hacks](Datastore-hacks.html) -- [Troubleshooting](Troubleshooting.html) -- [Development](Development.html) - - [GnuPG signature](GnuPG-signature.html) - - [Coding guidelines](Coding-guidelines.html) - - [Directory structure](Directory-structure.html) - - [3rd party libraries](3rd-party-libraries.html) - - [Plugin System](Plugin-System.html) - - [Release Shaarli](Release-Shaarli.html) - - [Versioning and Branches](Versioning-and-Branches.html) - - [Security](Security.html) - - [Static analysis](Static-analysis.html) - - [Theming](Theming.html) - - [Unit tests](Unit-tests.html) -- About - - [FAQ](FAQ.html) - - [Community & Related software](Community-&-Related-software.html) diff --git a/doc/md/Docker-101.md b/doc/md/docker/docker-101.md similarity index 100% rename from doc/md/Docker-101.md rename to doc/md/docker/docker-101.md diff --git a/doc/md/Docker-resources.md b/doc/md/docker/resources.md similarity index 100% rename from doc/md/Docker-resources.md rename to doc/md/docker/resources.md diff --git a/doc/md/Reverse-proxy-configuration.md b/doc/md/docker/reverse-proxy-configuration.md similarity index 100% rename from doc/md/Reverse-proxy-configuration.md rename to doc/md/docker/reverse-proxy-configuration.md diff --git a/doc/md/Shaarli-images.md b/doc/md/docker/shaarli-images.md similarity index 98% rename from doc/md/Shaarli-images.md rename to doc/md/docker/shaarli-images.md index 25f6cfdd..6d108d21 100644 --- a/doc/md/Shaarli-images.md +++ b/doc/md/docker/shaarli-images.md @@ -7,7 +7,6 @@ repository. ### Available image tags - `latest`: master branch (tarball release) - `stable`: stable branch (tarball release) -- `dev`: master branch (Git clone) All images rely on: - [Debian 8 Jessie](https://hub.docker.com/_/debian/) diff --git a/docker/development/Dockerfile b/docker/development/Dockerfile deleted file mode 100644 index d9ef8da7..00000000 --- a/docker/development/Dockerfile +++ /dev/null @@ -1,38 +0,0 @@ -FROM debian:jessie -MAINTAINER Shaarli Community - -ENV TERM dumb -RUN apt-get update \ - && apt-get install --no-install-recommends -y \ - ca-certificates \ - nginx-light \ - php5-curl \ - php5-fpm \ - php5-gd \ - php5-intl \ - supervisor \ - git \ - nano \ - && apt-get clean - -RUN sed -i 's/post_max_size.*/post_max_size = 10M/' /etc/php5/fpm/php.ini -RUN sed -i 's/upload_max_filesize.*/upload_max_filesize = 10M/' /etc/php5/fpm/php.ini -COPY nginx.conf /etc/nginx/nginx.conf -COPY supervised.conf /etc/supervisor/conf.d/supervised.conf - -ADD https://getcomposer.org/composer.phar /usr/local/bin/composer -RUN chmod 755 /usr/local/bin/composer - -WORKDIR /var/www -RUN git clone https://github.com/shaarli/Shaarli.git shaarli \ - && cd shaarli \ - && composer --prefer-dist install -RUN rm -rf html \ - && echo "" > index.php \ - && chown -R www-data:www-data . - -VOLUME /var/www/shaarli/data - -EXPOSE 80 - -CMD ["/usr/bin/supervisord", "-n", "-c", "/etc/supervisor/supervisord.conf"] diff --git a/docker/development/IMAGE.md b/docker/development/IMAGE.md deleted file mode 100644 index e2ff0f0e..00000000 --- a/docker/development/IMAGE.md +++ /dev/null @@ -1,10 +0,0 @@ -## shaarli:dev -- [Debian 8 Jessie](https://hub.docker.com/_/debian/) -- [PHP5-FPM](http://php-fpm.org/) -- [Nginx](http://nginx.org/) -- [Shaarli](https://github.com/shaarli/Shaarli) - -### Development tools -- [composer](https://getcomposer.org/) -- [git](http://git-scm.com/) -- [nano](http://www.nano-editor.org/) diff --git a/docker/development/nginx.conf b/docker/development/nginx.conf deleted file mode 100644 index 79c45bfe..00000000 --- a/docker/development/nginx.conf +++ /dev/null @@ -1,80 +0,0 @@ -user www-data www-data; -daemon off; -worker_processes 4; - -events { - worker_connections 768; -} - -http { - include mime.types; - default_type application/octet-stream; - keepalive_timeout 20; - - client_max_body_size 10m; - - index index.html index.php; - - server { - listen 80; - root /var/www/shaarli; - - access_log /var/log/nginx/shaarli.access.log; - error_log /var/log/nginx/shaarli.error.log; - - location /phpinfo/ { - # add a PHP info page for convenience - fastcgi_pass unix:/var/run/php5-fpm.sock; - fastcgi_index index.php; - fastcgi_param SCRIPT_FILENAME /var/www/index.php; - include fastcgi_params; - } - - location ~ /\. { - # deny access to dotfiles - access_log off; - log_not_found off; - deny all; - } - - location ~ ~$ { - # deny access to temp editor files, e.g. "script.php~" - access_log off; - log_not_found off; - deny all; - } - - location ~* \.(?:ico|css|js|gif|jpe?g|png)$ { - # cache static assets - expires max; - add_header Pragma public; - add_header Cache-Control "public, must-revalidate, proxy-revalidate"; - } - - location = /favicon.ico { - # serve the Shaarli favicon from its custom location - alias /var/www/shaarli/images/favicon.ico; - } - - location / { - # Slim - rewrite URLs - try_files $uri /index.php$is_args$args; - } - - location ~ (index)\.php$ { - # Slim - split URL path into (script_filename, path_info) - try_files $uri =404; - fastcgi_split_path_info ^(.+\.php)(/.+)$; - - # filter and proxy PHP requests to PHP-FPM - fastcgi_pass unix:/var/run/php5-fpm.sock; - fastcgi_index index.php; - include fastcgi.conf; - } - - location ~ \.php$ { - # deny access to all other PHP scripts - deny all; - } - } -} diff --git a/docker/development/supervised.conf b/docker/development/supervised.conf deleted file mode 100644 index 5acd9795..00000000 --- a/docker/development/supervised.conf +++ /dev/null @@ -1,13 +0,0 @@ -[program:php5-fpm] -command=/usr/sbin/php5-fpm -F -priority=5 -autostart=true -autorestart=true - -[program:nginx] -command=/usr/sbin/nginx -priority=10 -autostart=true -autorestart=true -stdout_events_enabled=true -stderr_events_enabled=true diff --git a/mkdocs.yml b/mkdocs.yml index d6dd3fc2..cbac149a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -16,10 +16,10 @@ pages: - Shaarli configuration: Shaarli-configuration.md - Plugins: Plugins.md - Docker: - - Docker 101: Docker-101.md - - Shaarli images: Shaarli-images.md - - Reverse proxy configuration: Reverse-proxy-configuration.md - - Docker resources: Docker-resources.md + - Docker 101: docker/docker-101.md + - Shaarli images: docker/shaarli-images.md + - Reverse proxy configuration: docker/reverse-proxy-configuration.md + - Docker resources: docker/resources.md - Usage: - Features: Features.md - Bookmarklet: Bookmarklet.md From 3a6f91a9ccbdd8f2ed8e33c88c7800f2623cfd3a Mon Sep 17 00:00:00 2001 From: VirtualTam Date: Sat, 29 Jul 2017 15:29:54 +0200 Subject: [PATCH 42/67] Generate HTML documentation Signed-off-by: VirtualTam --- AUTHORS | 12 +- doc/html/3rd-party-libraries/index.html | 8 +- .../index.html | 8 +- doc/html/Bookmarklet/index.html | 8 +- doc/html/Browsing-and-searching/index.html | 8 +- doc/html/Coding-guidelines/index.html | 8 +- .../Community-&-Related-software/index.html | 8 +- .../Continuous-integration-tools/index.html | 8 +- doc/html/Development-guidelines/index.html | 8 +- doc/html/Directory-structure/index.html | 8 +- doc/html/Download-and-Installation/index.html | 8 +- doc/html/FAQ/index.html | 8 +- doc/html/Features/index.html | 12 +- doc/html/Firefox-share/index.html | 8 +- doc/html/GnuPG-signature/index.html | 8 +- doc/html/Plugin-System/index.html | 8 +- doc/html/Plugins/index.html | 12 +- doc/html/REST-API/index.html | 8 +- doc/html/RSS-feeds/index.html | 8 +- doc/html/Release-Shaarli/index.html | 8 +- doc/html/Security/index.html | 8 +- doc/html/Server-configuration/index.html | 8 +- doc/html/Server-requirements/index.html | 8 +- doc/html/Server-security/index.html | 8 +- doc/html/Shaarli-configuration/index.html | 60 ++++++---- doc/html/Static-analysis/index.html | 8 +- doc/html/Theming/index.html | 8 +- doc/html/Troubleshooting/index.html | 8 +- doc/html/Unit-tests/index.html | 8 +- doc/html/Upgrade-and-migration/index.html | 8 +- doc/html/Various-hacks/index.html | 8 +- doc/html/Versioning-and-Branches/index.html | 8 +- .../docker-101}/index.html | 110 ++++++++--------- .../resources}/index.html | 110 ++++++++--------- .../reverse-proxy-configuration}/index.html | 110 ++++++++--------- .../shaarli-images}/index.html | 111 +++++++++--------- doc/html/index.html | 10 +- doc/html/mkdocs/search_index.json | 46 ++++---- doc/html/search.html | 8 +- doc/html/sitemap.xml | 80 ++++++------- 40 files changed, 459 insertions(+), 446 deletions(-) rename doc/html/{Docker-101 => docker/docker-101}/index.html (71%) rename doc/html/{Docker-resources => docker/resources}/index.html (68%) rename doc/html/{Reverse-proxy-configuration => docker/reverse-proxy-configuration}/index.html (64%) rename doc/html/{Shaarli-images => docker/shaarli-images}/index.html (74%) diff --git a/AUTHORS b/AUTHORS index c0e35949..9c0ca3d1 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1,6 +1,6 @@ - 472 ArthurHoaro - 201 VirtualTam - 132 nodiscc + 506 ArthurHoaro + 204 VirtualTam + 147 nodiscc 56 Sébastien Sauvage 15 Florian Eula 13 Emilien Klein @@ -8,15 +8,18 @@ 8 Christophe HENRY 4 Alexandre Alapetite 4 David Sferruzza + 3 Lucas Cimon 3 Teromene + 3 kalvn 2 Chris Kuethe 2 Knah Tsaeb 2 Mathieu Chabanon 2 Miloš Jovanović 2 Qwerty + 2 Stephen Muth 2 Timo Van Neerden 2 julienCXX - 2 kalvn + 2 philipp-r 1 Adrien Oliva 1 Alexis J 1 BoboTiG @@ -38,4 +41,3 @@ 1 Sbgodin 1 TsT 1 dimtion - 1 philipp-r diff --git a/doc/html/3rd-party-libraries/index.html b/doc/html/3rd-party-libraries/index.html index 0d62007d..d7754471 100644 --- a/doc/html/3rd-party-libraries/index.html +++ b/doc/html/3rd-party-libraries/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Backup,-restore,-import-and-export/index.html b/doc/html/Backup,-restore,-import-and-export/index.html index 33ec9124..caebb6ce 100644 --- a/doc/html/Backup,-restore,-import-and-export/index.html +++ b/doc/html/Backup,-restore,-import-and-export/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Bookmarklet/index.html b/doc/html/Bookmarklet/index.html index 325d305a..924a8710 100644 --- a/doc/html/Bookmarklet/index.html +++ b/doc/html/Bookmarklet/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Browsing-and-searching/index.html b/doc/html/Browsing-and-searching/index.html index c8b7386e..f2454103 100644 --- a/doc/html/Browsing-and-searching/index.html +++ b/doc/html/Browsing-and-searching/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Coding-guidelines/index.html b/doc/html/Coding-guidelines/index.html index dfcdd45c..3e27309b 100644 --- a/doc/html/Coding-guidelines/index.html +++ b/doc/html/Coding-guidelines/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Community-&-Related-software/index.html b/doc/html/Community-&-Related-software/index.html index 2497433c..e9c3313f 100644 --- a/doc/html/Community-&-Related-software/index.html +++ b/doc/html/Community-&-Related-software/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Continuous-integration-tools/index.html b/doc/html/Continuous-integration-tools/index.html index 339f37ac..b0599227 100644 --- a/doc/html/Continuous-integration-tools/index.html +++ b/doc/html/Continuous-integration-tools/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Development-guidelines/index.html b/doc/html/Development-guidelines/index.html index e75c911b..9e1d8ab6 100644 --- a/doc/html/Development-guidelines/index.html +++ b/doc/html/Development-guidelines/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Directory-structure/index.html b/doc/html/Directory-structure/index.html index ff075ec5..49f26ddb 100644 --- a/doc/html/Directory-structure/index.html +++ b/doc/html/Directory-structure/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Download-and-Installation/index.html b/doc/html/Download-and-Installation/index.html index 92342681..8bc9a5b9 100644 --- a/doc/html/Download-and-Installation/index.html +++ b/doc/html/Download-and-Installation/index.html @@ -128,19 +128,19 @@ diff --git a/doc/html/FAQ/index.html b/doc/html/FAQ/index.html index f8ced260..5b7900bc 100644 --- a/doc/html/FAQ/index.html +++ b/doc/html/FAQ/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Features/index.html b/doc/html/Features/index.html index e847c546..79030799 100644 --- a/doc/html/Features/index.html +++ b/doc/html/Features/index.html @@ -94,19 +94,19 @@ @@ -318,7 +318,7 @@

    Using Shaarli as a blog, notep Next - Previous + Previous

    @@ -346,7 +346,7 @@

    Using Shaarli as a blog, notep GitHub - « Previous + « Previous Next » diff --git a/doc/html/Firefox-share/index.html b/doc/html/Firefox-share/index.html index 9c028ffc..4c84a07c 100644 --- a/doc/html/Firefox-share/index.html +++ b/doc/html/Firefox-share/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/GnuPG-signature/index.html b/doc/html/GnuPG-signature/index.html index 0b2d842a..82e22070 100644 --- a/doc/html/GnuPG-signature/index.html +++ b/doc/html/GnuPG-signature/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Plugin-System/index.html b/doc/html/Plugin-System/index.html index dbed5908..11ea5ed5 100644 --- a/doc/html/Plugin-System/index.html +++ b/doc/html/Plugin-System/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Plugins/index.html b/doc/html/Plugins/index.html index 4b63681e..f87cf84c 100644 --- a/doc/html/Plugins/index.html +++ b/doc/html/Plugins/index.html @@ -115,19 +115,19 @@ @@ -358,7 +358,7 @@

    Third party plugins

    diff --git a/doc/html/REST-API/index.html b/doc/html/REST-API/index.html index 6e2c9518..dae27e5c 100644 --- a/doc/html/REST-API/index.html +++ b/doc/html/REST-API/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/RSS-feeds/index.html b/doc/html/RSS-feeds/index.html index a4b7339f..1e4ea957 100644 --- a/doc/html/RSS-feeds/index.html +++ b/doc/html/RSS-feeds/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Release-Shaarli/index.html b/doc/html/Release-Shaarli/index.html index 5857a52f..fbb06725 100644 --- a/doc/html/Release-Shaarli/index.html +++ b/doc/html/Release-Shaarli/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Security/index.html b/doc/html/Security/index.html index c7aec584..bea1ba90 100644 --- a/doc/html/Security/index.html +++ b/doc/html/Security/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Server-configuration/index.html b/doc/html/Server-configuration/index.html index 6e798b4b..91b20fda 100644 --- a/doc/html/Server-configuration/index.html +++ b/doc/html/Server-configuration/index.html @@ -149,19 +149,19 @@ diff --git a/doc/html/Server-requirements/index.html b/doc/html/Server-requirements/index.html index f3bfa185..29bb610b 100644 --- a/doc/html/Server-requirements/index.html +++ b/doc/html/Server-requirements/index.html @@ -112,19 +112,19 @@ diff --git a/doc/html/Server-security/index.html b/doc/html/Server-security/index.html index 6d9f25c0..5ec0fdb6 100644 --- a/doc/html/Server-security/index.html +++ b/doc/html/Server-security/index.html @@ -118,19 +118,19 @@ diff --git a/doc/html/Shaarli-configuration/index.html b/doc/html/Shaarli-configuration/index.html index 4e556061..cd323a32 100644 --- a/doc/html/Shaarli-configuration/index.html +++ b/doc/html/Shaarli-configuration/index.html @@ -134,19 +134,19 @@ @@ -323,26 +323,38 @@

    Foreword

    its values override those defined in index.php it is wrap in a PHP comment to prevent anyone accessing it, regardless of server configuration

    File and directory permissions

    -

    The server process running Shaarli must have: -- read access to the following resources: - - PHP scripts: index.php, application/*.php, plugins/*.php - - 3rd party PHP and Javascript libraries: inc/*.php, inc/*.js - - static assets: - - CSS stylesheets: inc/*.css - - images/* - - RainTPL templates: tpl/*.html -- read, write and execution access to the following directories: - - cache - thumbnail cache - - data - link data store, configuration options - - pagecache - Atom/RSS feed cache - - tmp - RainTPL page cache

    -

    On a Linux distribution: -- the web server user will likely be www or http (for Apache2) -- it will be a member of a group of the same name: www:www, http:http -- to give it access to Shaarli, either: - - unzip Shaarli in the default web server location (usually /var/www/) and set the web server user as the owner - - put users in the same group as the web server, and set the appropriate access rights -- if you have a domain / subdomain to serve Shaarli, configure the server accordingly

    +

    The server process running Shaarli must have:

    +
      +
    • read access to the following resources:
        +
      • PHP scripts: index.php, application/*.php, plugins/*.php
        • +
      • 3rd party PHP and Javascript libraries: inc/*.php, inc/*.js
        • +
      • static assets:
          +
        • CSS stylesheets: inc/*.css
          • +
        • images/*
          • +
        +
        • +
      • RainTPL templates: tpl/*.html
        • +
      +
      • +
    • read, write and execution access to the following directories:
        +
      • cache - thumbnail cache
        • +
      • data - link data store, configuration options
        • +
      • pagecache - Atom/RSS feed cache
        • +
      • tmp - RainTPL page cache
        • +
      +
      • +
    +

    On a Linux distribution:

    +
      +
    • the web server user will likely be www or http (for Apache2)
      • +
    • it will be a member of a group of the same name: www:www, http:http
      • +
    • to give it access to Shaarli, either:
        +
      • unzip Shaarli in the default web server location (usually /var/www/) and set the web server user as the owner
        • +
      • put users in the same group as the web server, and set the appropriate access rights
        • +
      +
      • +
    • if you have a domain / subdomain to serve Shaarli, configure the server accordingly
      • +

    Configuration

    In data/config.json.php.

    See also Plugin System.

    diff --git a/doc/html/Static-analysis/index.html b/doc/html/Static-analysis/index.html index ddd81f86..e0aff52f 100644 --- a/doc/html/Static-analysis/index.html +++ b/doc/html/Static-analysis/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Theming/index.html b/doc/html/Theming/index.html index 670dbb80..d6ecb06d 100644 --- a/doc/html/Theming/index.html +++ b/doc/html/Theming/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Troubleshooting/index.html b/doc/html/Troubleshooting/index.html index f1564362..90705ada 100644 --- a/doc/html/Troubleshooting/index.html +++ b/doc/html/Troubleshooting/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Unit-tests/index.html b/doc/html/Unit-tests/index.html index ce90ed10..ebc92beb 100644 --- a/doc/html/Unit-tests/index.html +++ b/doc/html/Unit-tests/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Upgrade-and-migration/index.html b/doc/html/Upgrade-and-migration/index.html index 3319fa72..b190ed38 100644 --- a/doc/html/Upgrade-and-migration/index.html +++ b/doc/html/Upgrade-and-migration/index.html @@ -133,19 +133,19 @@ diff --git a/doc/html/Various-hacks/index.html b/doc/html/Various-hacks/index.html index b06207ae..a10358c0 100644 --- a/doc/html/Various-hacks/index.html +++ b/doc/html/Various-hacks/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Versioning-and-Branches/index.html b/doc/html/Versioning-and-Branches/index.html index 97bdb47e..d3f61ec3 100644 --- a/doc/html/Versioning-and-Branches/index.html +++ b/doc/html/Versioning-and-Branches/index.html @@ -94,19 +94,19 @@ diff --git a/doc/html/Docker-101/index.html b/doc/html/docker/docker-101/index.html similarity index 71% rename from doc/html/Docker-101/index.html rename to doc/html/docker/docker-101/index.html index 31e57b59..67a3f8e4 100644 --- a/doc/html/Docker-101/index.html +++ b/doc/html/docker/docker-101/index.html @@ -7,25 +7,25 @@ - + Docker 101 - Shaarli Documentation - - - - + + + + - - - + + + @@ -36,9 +36,9 @@