Search frontend for the documentation generated by the PureScript compiler
Go to file
Vladimir Kalnitsky 4ce20e3251
added: CLI interface; added: search REPL (#5)
* added: CLI interface
added: search REPL

* added: shebang to the executable file

* added: automatic deployments

* better heuristics for package name detection

* added: previews
2019-07-21 17:29:43 +03:00
src/Docs/Search added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
test added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
.gitignore added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
.travis.yml added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
package.json added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
packages.dhall added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
preview.png added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
README.md added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00
spago.dhall added: CLI interface; added: search REPL (#5) 2019-07-21 17:29:43 +03:00

purescript-docs-search

Build status

An app that adds search capabilities to generated documentation for purescript code.

It supports nearly-all functionality of Pursuit, including querying by type.

Installing

Run npm install purescript-docs-search.

Usage

There are two usage scenarios:

Patching static documentation

Use purescript-docs-search build-index command to patch HTML files located in generated-docs/html. You then will be able to search for declarations or types:

Preview

The user interface of the app is optimised for keyboard-only use.

S hotkey can be used to focus on the search field, Escape can be used to leave it. Pressing Escape twice will close the search results listing.

Using the CLI

Running purescript-docs-search within a project directory will open an interactive command-line session.

Note that unlike in Pursuit, most relevant results will appear last.

A quick demo:

asciicast

You may notice that the CLI offers slightly better results than the web interface. This is a performance tradeoff.