mirror of
https://github.com/sbrl/Pepperminty-Wiki.git
synced 2024-11-21 16:13:00 +00:00
Do some documentation work, and add missing help sections
This commit is contained in:
parent
e773e36de5
commit
da5b3a5df8
5 changed files with 24 additions and 8 deletions
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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": []
|
||||
},
|
||||
|
|
|
@ -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>");
|
||||
}
|
||||
]);
|
||||
|
||||
|
|
|
@ -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 ///
|
||||
|
|
Loading…
Reference in a new issue