Commands¶
RedPen provides both a simple standalone command line tool and a server.
Command line tool¶
RedPen provides a simple command line tool called ‘redpen’ to check documents.
Usage: redpen¶
We use the redpen command as follows.
$ redpen [options] input-files
By default, input files are delimited by whitespace and then analysed. The redpen command supports the following options.
Options¶
redpen has the following options.
-
-c
<CONFIG_FILE>
,
--configuration
<CONFIG_FILE>
¶ Specify the RedPen configuration file
-
-f
<INPUT_FORMAT>
,
--input_format
<INPUT_FORMAT>
¶ Input file format. [Default: plain]
This argument specifies the input format. Currently RedPen supports the following formats.
Value Description plain Plain text format wiki Wiki (Textile) format markdown Markdown format asciidoc AsciiDoc format latex LaTeX format
Note
RedPen does not currently support every element of the wiki format, such as tables. The remaining elements will be supported in the near future.
-
-r
<RESULT_FORMAT>
,
--result_format
<RESULT_FORMAT>
¶ Result format. [Default: plain]
This argument determines the output format. Currently RedPen supports the following output formats.
Value Description plain plain text format plain2 an alternate plain text format collated by sentence xml xml format json json format json2 an alternate json format collated by sentence
-
-h
,
--help
¶
Display help.
-
--version
¶
Show the redpen version.
Sample server¶
RedPen also provides a sample server.
Usage: redpen-server¶
We can start and stop the redpen server with the following command.
$ redpen-server [start|stop]
Configuration¶
redpen-server is able to be configured with editing the variables in redpen-server file itself. The following table shows the configuration variables and the default values.
Configuration Default Value Description REDPEN_PORT 8080 Specify Port number of RedPen server. STOP_KEY redpen.stop RedPen server is able to stop with Stop key with http access. If you do not want to stop with stop key comment out the value.
The functionality of the RedPen server is described on the RedPen Server page.