CiteURL Frontends
CiteURL can be used in a few forms besides the command-line tool and the Python library. Here's what they are:
CiteURL Server
If you want to use CiteURL from your web browser, it's hosted here.
You can also use a set of custom citation templates to host your own instance on your local network or beyond. The simplest way to do that is to run this command:
citeurl host -st PATH_TO_YOUR_TEMPLATES.YAML
Or, if you're using a hosting provider like pythonanywhere.com, you can give it direct access to CiteURL as a Flask application:
from citeurl.web.server import App
from citeurl import Citator
APP = App(Citator())
JavaScript
Although CiteURL is primarily a Python program, you can also use it to generate a JavaScript implementation of its citation lookup functionality, including any extra citation templates you've written This allows it to be hosted on a static website (like mine, for example), or distributed as an HTML file that people can bookmark and use as a custom search engine stored on their own computers.
To make a JavaScript implementation, first make a YAML file with any custom citation templates you'd like to support. Next, open a command line and run the following command:
- Write a YAML file with one or more custom citation templates.
- Open a command line and run the following:
citeurl makejs -e -o output.html -t PATH_TO_YOUR_TEMPLATES.YAML
Alternatively, to omit CiteURL's default templates, include the -n
option in that command. For more info, run citeurl makejs -h
.
Markdown Extension
CiteURL can also be used as an extension to Python-Markdown. You can load the extension as citeurl
, and it supports the following options:
custom_templates
: A list of paths to YAML files containing custom citation templates. Defaults to none.use_defaults
: Whether CiteURL should load the default citation templates. Defaults toTrue
.attributes
: A dictionary of HTML attributes to give each hyperlink that CiteURL inserts into the text. Defaults to{'class': 'citation'}
.link_detailed_ids
: Whether to insert links for citations likeId. at 305
. Defaults toTrue
.link_plain_ids
: Whether to insert links for citations likeId.
. Defaults toFalse
.break_id_on_regex
: Anywhere this string (parsed as regex) appears in the text, chains of citations likeid.
will be interrupted. Note that this is based on the output HTML, not the original Markdown text. Defaults toL\. ?Rev\.|J\. ?Law|\. ?([Cc]ode|[Cc]onst)
GNOME Shell Search Provider
If you use the GNOME desktop environment, you can install my other project to look up citations directly from your desktop!