Do some documentation work, and add missing help sections

This commit is contained in:
Starbeamrainbowlabs 2019-08-24 19:56:14 +01:00
parent e773e36de5
commit da5b3a5df8
Signed by: sbrl
GPG Key ID: 1BE5172E637709C2
5 changed files with 24 additions and 8 deletions

View File

@ -6,11 +6,13 @@ This file holds the changelog for Pepperminty Wiki. This is the master list of t
### Fixed
- Fixed a bug in the search query performance metrics
- Fill out the statistics help text
### Changed
- Made `build.sh` build script more robust, especially when generating the documentation.
- Improved search index update performance - especially when rebuilding the entire index through the master control panel
- The search index is no longer sorted, but this shouldn't affect lookup performance at all
- Vastly improved search engine performance
- A new SQLite-based index format is now used, so search indexes will need to be rebuilt (migrating would probably take longer than a rebuild :-/)
- New search query syntax
## v0.19

View File

@ -9,6 +9,7 @@
- `fileinfo` (for proper mime type checking of uploaded files)
- `zip` (for compressing exports)
- `intl` (for Unicode text normalization when searching and in the id index)
- `sqlite` (for search index storage; uses [PDO](https://www.php.net/manual/en/ref.pdo-sqlite.php))
- Write access to Pepperminty Wiki's own folder (only for editing)
- Recommended: Block access to `peppermint.json`, where it stores it's settings

View File

@ -135,17 +135,17 @@
"version": "0.10",
"author": "Starbeamrainbowlabs",
"description": "Adds proper search functionality to Pepperminty Wiki using an inverted index to provide a full text search engine. If pages don't show up, then you might have hit a stop word. If not, try requesting the `invindex-rebuild` action to rebuild the inverted index from scratch.",
"lastupdate": 1566520130,
"lastupdate": 1566672916,
"optional": false,
"extra_data": []
},
{
"id": "feature-stats",
"name": "Statistics",
"version": "0.2",
"version": "0.2.1",
"author": "Starbeamrainbowlabs",
"description": "An extensible statistics calculation system. Comes with a range of built-in statistics, but can be extended by other modules too.",
"lastupdate": 1565741951,
"lastupdate": 1566671750,
"optional": false,
"extra_data": []
},
@ -165,7 +165,7 @@
"version": "0.3.3",
"author": "Starbeamrainbowlabs",
"description": "Adds a user preferences page, letting people do things like change their email address and password.",
"lastupdate": 1526035213,
"lastupdate": 1566671167,
"optional": false,
"extra_data": []
},

View File

@ -523,6 +523,18 @@ window.addEventListener("load", function(event) {
});
');
}
add_help_section("27-search", "Searching", "<p>$settings->sitename has an integrated full-text search engine, allowing you to search all of the pages on $settings->sitename and their content. To use it, simply enter your query into the page name box and press enter. If a page isn't found with the exact name of your query terms, a search will be performed instead.</p>
<p>Additionally, advanced users can take advantage of some extra query syntax that $settings->sitename supports, which is inspired by popular search engines:</p>
<table>
<tr><th style='width: 33%;'>Example</th><th style='width: 66%;'>Meaning</th></tr>
<tr><td><code>cat -dog</code></td><td>Search for pages containing \"cat\", but not \"dog\". This syntax does not make sense on it's own - other words must be present for it to take effect.</td>
<tr><td><code>+glass marble</code></td><td>Double the weighting of the word \"glass\".</td>
<tr><td><code>intitle:rocket</code></td><td>Search only page titles for \"rocket\".</td>
<tr><td><code>intags:bill</code></td><td>Search only tags for \"bill\".</td>
<tr><td><code>inbody:satellite</code></td><td>Search only the page body for \"satellite\".</td>
</table>
<p>More query syntax will be added in the future, so keep an eye on <a href='https://github.com/sbrl/Pepperminty-Wiki/releases/'>the latest releases</a> of <em>Pepperminty Wiki</em> to stay up-to-date (<a href='https://github.com/sbrl/Pepperminty-Wiki/releases.atom'>Atom / RSS feed available here</a>).</p>");
}
]);

View File

@ -1,7 +1,7 @@
<?php
register_module([
"name" => "Statistics",
"version" => "0.2",
"version" => "0.2.1",
"author" => "Starbeamrainbowlabs",
"description" => "An extensible statistics calculation system. Comes with a range of built-in statistics, but can be extended by other modules too.",
"id" => "feature-stats",
@ -133,7 +133,8 @@ register_module([
echo(file_get_contents($paths->statsindex) . "\n");
});
add_help_section("150-statistics", "Statistics", "<p></p>");
add_help_section("150-statistics", "Statistics", "<p>$settings->sitename records some statistics about itself, including the number of pages, the longest pages, the most wanted pages, the most linked-to pages, and more. They are updated roughly every " . human_time($settings->stats_update_interval) . ", though moderators may occasionally update them sooner.</p>
<p>You can see these statistics <a href='?action=stats'>here</a>.</p>");
//////////////////////////
/// Built-in Statisics ///