mirror of
https://github.com/sbrl/Pepperminty-Wiki.git
synced 2024-11-22 04:23:01 +00:00
85 lines
4.9 KiB
Markdown
85 lines
4.9 KiB
Markdown
# Features
|
|
Pepperminty Wiki has actually acquired a rather extensive feature set.
|
|
|
|
- Configurable settings
|
|
- Via `peppermint.json`
|
|
- GUI available for moderators
|
|
- First-run wizard to help with basic configuration (since v0.19)
|
|
- User login system
|
|
- Graphical user management table for moderators
|
|
- Page creation
|
|
- Subpages fully supported
|
|
- Markdown-powered syntax
|
|
- Powered by [Parsedown Extra](https://github.com/erusev/parsedown-extra/) (with [Parsedown Extreme](https://github.com/BenjaminHoegh/parsedown-extreme)), with additional extras
|
|
- Short syntax for:
|
|
- Referencing uploaded files
|
|
- Internal Links - links to non-existent pages show up in red
|
|
- Templating support
|
|
- Additional syntax for resizing and floating images (see inbuilt help page)
|
|
- File galleries
|
|
- Client-side mathematical expression parsing, courtesy of [MathJax](https://www.mathjax.org/) [optional]
|
|
- Full page revision history (comparison / manipulation coming soon)
|
|
- Optional time-delayed search indexing
|
|
- Simple edit conflict detection
|
|
- Edit previewing (since v0.14, thanks to @ikisler)
|
|
- Printable page view
|
|
- Customisable theme + theme gallery (new in v0.20!)
|
|
- ~~Basic 'search' bar~~ A full-text search engine (since v0.13), with high-performance advanced query syntax (since v0.20)!
|
|
- Dynamic server-side suggestions (since v0.13)
|
|
- Sidebar with a tree of all the current pages [optional]
|
|
- Page tags
|
|
- Page lists
|
|
- List of all pages
|
|
- List of all tags
|
|
- List of pages with a given tag
|
|
- List of recent changes
|
|
- Inbuilt help page
|
|
- Dynamic - modules can add their own sections to it
|
|
- File upload and preview
|
|
- Simple syntax for including media in a page (explanation on help page)
|
|
- Page protection
|
|
- Simple user settings page
|
|
- Set email address
|
|
- Change password
|
|
- Threaded page comments (since v0.14)
|
|
- Statistics system - can be extended by modules (since v0.15)
|
|
- Should be fully accessible (screen readers etc) - [open an issue](https://github.com/sbrl/Pepperminty-Wiki/issues/new) if you encounter any problems
|
|
- Customisable module based system
|
|
- Allows you to add or remove features at will
|
|
|
|
|
|
## Compatibility
|
|
Some users have imported existing wikis from other software. This is made possible because Pepperminty Wiki will automatically rebuild the page index from the existing files in a directory if the page index (`pageindex.json`) doesn't exist or is deleted.
|
|
|
|
Notes about the import process are detailed below.
|
|
|
|
- Pepperminty Wiki's internal and external link syntax is [compatible with vimwiki](https://github.com/sbrl/Pepperminty-Wiki/issues/new) (thanks @RyanGreenup!).
|
|
|
|
If you encounter any issues importing data from another wiki, please [open an issue](https://github.com/sbrl/Pepperminty-Wiki/issues/new). I'd love to know about it - it may be possible to automate any conversion steps to ease the import process.
|
|
|
|
|
|
## Features FAQ
|
|
A few features that users request that aren't obvious on how to use or enable are documented here.
|
|
|
|
### How do I add a "create new page" button?
|
|
Since version v0.23, Pepperminty Wiki has API support for creating a new page without knowing it's name - see issue [#194](https://github.com/sbrl/Pepperminty-Wiki/issues/194). While a create new page button isn'tin the user interface by default, one may be added as a navigation link to either the [`nav_links`](https://starbeamrainbowlabs.com/labs/peppermint/peppermint-config-info.php#config_nav_links), [`nav_links_extra`](https://starbeamrainbowlabs.com/labs/peppermint/peppermint-config-info.php#config_nav_links_extra), or [`nav_links_bottom`](https://starbeamrainbowlabs.com/labs/peppermint/peppermint-config-info.php#config_nav_links_bottom) configuration directives in `peppermint.json` (these must be edited directly - GUI support for these properties hasn't been implemented yet). An example navigation link to send a user to create a new page might look like this:
|
|
|
|
```json
|
|
[
|
|
"+",
|
|
"index.php?action=edit&unknownpagename=yes"
|
|
]
|
|
```
|
|
|
|
See the [`nav_links` documentation for more information on the wider navigation link syntax](https://starbeamrainbowlabs.com/labs/peppermint/peppermint-config-info.php#config_nav_links).
|
|
|
|
### What's this about manual setup for the sitemap?
|
|
If the `page-sitemap` module is enabled, Pepperminty Wiki will have support for generating an XML sitemap. However, since a sitemap is typically located at the root of your domain with the filename `sitemap.xml`, crawlers must be instructed as to where they can find the sitemap for your wiki. This can be done by editing (creating if it doesn't exist) a file called `robots.txt` _at the top-level root of your domain name_, and appending something like the following:
|
|
|
|
```
|
|
Sitemap: http://wiki.example.com/path/to/index.php?action=sitemap
|
|
```
|
|
|
|
This will properly instruct crawlers on where to find the sitemap.
|
|
|
|
If you know of a way to do this via a `<meta />` tag or HTTP header instead, please [open an issue](https://github.com/sbrl/Pepperminty-Wiki/issues/new) so that this extra manual step can be removed.
|