MyShaarli/doc/md/Browsing-and-searching.md
nodiscc 53ed6d7d1e 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
2017-06-18 00:19:49 +02:00

1.2 KiB

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.