91a21c2729
- standardize page names, rework documentation structure, update TOC - use same example paths everywhere - level 1 titles on all pages - fix broken links - .md suffix on all page links (works both from readthedocs and github repository views) **Server:** A full and concise installation guide with examples is a frequent request. The documentation should provide such a guide for basic installation needs, while explaining alternative/advanced configuration at the end. Links to reference guides and documentation should be used more frequently to avoid recommending an outdated or excessively complex configuration. - server: move most server-related info to server-configuration.md, cleanup/shorten - server: update list of php dependencies/libraries, link to composer.json - server: installation: support 3 install methods (from release zip, from sources, using docker) - server: installation: use rsync instead of mv as mv results will change depending of taget directory already existing or not - server: add example/basic usage of certbot - server, upgrade, installation: update file permissions setup, use sudo for upgrade operations in webserver document root - server: apache: add comments to configuration, fix and factorize file permissions setup, set cache-control header, deny access to dotfiles, add missing apache config steps, add http->https redirect example - server: nginx: refactor nginx configuration, add comments, DO log access to denied/protected files - server: add links to MDN for x-forwarded-* http headers explanation, cleanup/clarify robots.txt and crawlers section - server: bump file upload size limit to 100MB we have reports of bookmark exports weighing +40MB - i have a 13MB one here - server: simplify phpinfo documentation - server: move backup and restore information to dedicated page - docker: move all docker docs to Docker.md, simplify/ docker setup, add docker-compose.yml example, replace docker-101 with docker cheatsheet - troubleshooting: move all troubleshooting documentation to troubleshooting.md **Usage:** - index: add getting started section on index page - features/usage: move all usage-related documentation to usage.md, add links from the main feature list to corresponding usage docs, clarify/reword features list - shaarli configuration: add note about configuring from web interface **Removed:** - remove obsolete/orphan images - remove obsolete shaarchiver example - remove outdated "decode datastore content" snippet **Development:** - development: move development-related docs (static analysis, CI, unit tests, 3rd party libs, link structure/directory, guidelines, security....) to dev/ directory - development: Merge several pages to development.md - **Breaking change?:** remove mentions of 'stable' branch, switch to new branch/release model (master=latest commit, release=latest tag) - **Breaking change?:** refer to base sharing unit as "Shaare" everywhere (TODO: reflect changes in the code?) doc: update featues list/link to usage.md for details - development: directory structure: add note about required file permissions - .travis-ci.yml: add comments - .htaccess: add comment
7.6 KiB
7.6 KiB
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.
Related software
REST API clients
See REST API for a list of official and community clients.
Third party plugins
- autosave by @kalvn: Automatically saves data when editing a Shaare 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.
- google analytics by @ericjuden: Adds Google Analytics tracking support
- launch - Launch Plugin is a plugin designed to enhance and customize Launch Theme for Shaarli.
- markdown-toolbar by @immanuelfodor - Easily insert markdown syntax into the Description field when editing a Shaare.
- related by @ilesinge - Show related Shaares based on the number of identical tags.
- social by @alexisju: share links to social networks.
- shaarli2twitter by @ArthurHoaro - Automatically tweet your Shaares from Shaarli
- shaarli2mastodon by @kalvn - This Shaarli plugin allows you to automatically publish links you post on your Mastodon timeline.
- shaarli-descriptor by @immanuelfodor - Customize the default height/number of rows of the Description field when editing a Shaare.
- urlextern by @trailjeep - Shaarli plugin to open external links in a new tab/window.
- favicons by @trailjeep - Shaarli plugin to add favicon/filetype icons to Shaares.
Third-party themes
See Theming for a list of community-contributed themes, and an installation guide.
Integration with other platforms
- tt-rss-shaarli - Tiny-Tiny RSS plugin that adds support for sharing articles with Shaarli
- octopress-shaarli - Octopress plugin to retrieve Shaarli Shaares on the sidebar
- Scuttle to Shaarli - Import bookmarks from Scuttle
- Shaarli app for Cloudron - Effortlessly run Shaarli with the help of Cloudron
- Shaarli_ynh - Shaarli is available as a Yunohost app
- pelican static blog generator plugin to auto-post articles on a Shaarli instance: shaarli_poster
Mobile Apps
- ShaarliOS - Apple iOS share extension.
- Shaarli for Android - Android application that adds Shaarli as a sharing provider
- Shaarlier for Android - Android application to simply add Shaares directly into your Shaarli
- Stakali for Android - Stakali is a personal bookmark manager which synchronizes with Shaarli
Desktop Apps
- Ulauncher Extension - Ulauncher is an an application launcher for Linux, this extension allows research in your Shaarli
Browser addons
- Shaarli Firefox Extension - toolbar button to share your current tab with Shaarli.
- Shaarli Chrome Extension - toolbar button to share your current tab with Shaarli.
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.
Alternatives to Shaarli
See awesome-selfhosted: bookmarks & link sharing.
Community
- 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
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.
- 2015-06-22 - Hacker News - https://news.ycombinator.com/item?id=9755366
- 2015-05-12 - Reddit - shaarli - Self hosted Bookmarking / Delicious (PHP, MySQL)