Standard Ebooks

https://github.com/standardebooks/tools
Admin
A collection of tools Standard Ebooks uses to produce its ebooks, including basic setup of ebooks,...
Tokens:27,972
Snippets:487
Trust Score:7.6
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install Standardebooks via pipx on macOS (Alternative)

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs Standardebooks using pipx on macOS, with manual dependency management via Homebrew. This method allows for more granular control over the installation.

```shell
# Install some pre-flight dependencies.
brew install cairo git openjdk pipx python@3.12
pipx ensurepath
sudo ln -sfn $(brew --prefix)/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

# Install the toolset.
pipx install --python "$(brew --prefix)"/bin/python3.12 standardebooks

# Optional: Bash users who have set up bash-completion via brew can install tab completion.
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/bash/se $(brew --prefix)/etc/bash_completion.d/se

# Optional: Fish users can install tab completion.
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/fish/se $HOME/.config/fish/completions/se.fish
```

--------------------------------

### Install Standard Ebooks Toolset with Pipx

Source: https://github.com/standardebooks/tools/blob/master/README.md

Install the `standardebooks` package using `pipx` after setting up dependencies and ensuring `~/.local/bin` is in your PATH.

```shell
pip install --user pipx
```

```shell
pipx install standardebooks
```

--------------------------------

### Install Standardebooks on Fedora

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs the Standardebooks toolset and its dependencies on Fedora systems using pipx. Ensure pipx is correctly configured in your PATH.

```shell
# Install some pre-flight dependencies.
sudo dnf install pipx python3-devel gcc libxslt-devel git java-25-openjdk-headless

# Ensure $PATH environment variable is correctly set up for pipx.
pipx ensurepath

# Install the toolset.
pipx install standardebooks
```

--------------------------------

### Install ZSH Shell Completions

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs ZSH shell completions for the 'se' command by creating a symbolic link.

```shell
# Install ZSH completions.
sudo ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/zsh/_se /usr/share/zsh/vendor-completions/_se && hash -rf && compinit
```

--------------------------------

### Install Standard Ebooks Packages on OpenBSD

Source: https://github.com/standardebooks/tools/blob/master/README.md

Create a package list file for `pkg_add` to install necessary dependencies. Ensure you follow linking instructions if multiple Python versions are present.

```shell
py3-pip--
py3-virtualenv--
py3-gitdb--
jdk--%11
git--
```

```shell
doas pkg_add -ivl ~/standard-ebooks-packages
```

```shell
doas ln -sf /usr/local/bin/pip3.7 /usr/local/bin/pip
```

--------------------------------

### Install Standardebooks with Homebrew on macOS

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs the Standardebooks toolset using the Homebrew package manager on macOS.

```shell
brew install standardebooks
```

--------------------------------

### Install Toolset on Ubuntu 24.04

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs necessary dependencies and the Standard Ebooks toolset using pipx on Ubuntu 24.04.

```shell
# Install some pre-flight dependencies.
sudo apt install -y default-jre git python3-dev python3-pip python3-venv pipx

# Install the toolset.
pipx install standardebooks
```

--------------------------------

### Install Bash Shell Completions

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs Bash shell completions for the 'se' command by creating a symbolic link in the user's bash-completion directory.

```shell
# Install Bash completions.
mkdir -p $HOME/.local/share/bash-completion/completions/
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/bash/se $HOME/.local/share/bash-completion/completions/se
```

--------------------------------

### Install Fish Shell Completions

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs Fish shell completions for the 'se' command by creating a symbolic link in the user's Fish configuration directory.

```shell
# Install Fish completions.
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/fish/se.fish $HOME/.config/fish/completions/
```

--------------------------------

### Editable Installation for Toolset Developers

Source: https://github.com/standardebooks/tools/blob/master/README.md

Clone the toolset repository and install it in editable mode using `pipx` to enable live source code changes.

```shell
git clone https://github.com/standardebooks/tools.git
```

```shell
pipx install --editable ./tools
```

--------------------------------

### Install Toolset on Ubuntu 20.04

Source: https://github.com/standardebooks/tools/blob/master/README.md

Installs necessary dependencies, pipx, and the Standard Ebooks toolset using pipx with a specific Python version on Ubuntu 20.04.

```shell
# Install some pre-flight dependencies.
sudo apt install -y default-jre git python3-dev python3-pip python3-venv

# Install pipx.
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Install the toolset.
pipx install --python=3.12 --fetch-missing-python standardebooks
```

--------------------------------

### Start Validator Checker Script

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Starts the validator checker Python script. Requires an internet connection for initial dependency downloads.

```bash
python ./checker.py all
```

--------------------------------

### Install Shell Completions for Standardebooks

Source: https://github.com/standardebooks/tools/blob/master/README.md

Sets up shell completions for Zsh, Bash, and Fish. This requires manual linking of completion scripts to the appropriate system directories.

```shell
# Install ZSH completions.
sudo ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/zsh/_se /usr/share/zsh/vendor-completions/_se && hash -rf && compinit

# Install Bash completions.
mkdir -p $HOME/.local/share/bash-completion/completions/
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/bash/se $HOME/.local/share/bash-completion/completions/se
# Install Fish completions.
ln -s $(pipx environment --value PIPX_LOCAL_VENVS)/standardebooks/lib/python3.*/site-packages/se/completions/fish/se $HOME/.config/fish/completions/se.fish
```

--------------------------------

### Run EPUBCheck from Command Line

Source: https://github.com/standardebooks/tools/blob/master/se/data/epubcheck/README.txt

Execute EPUBCheck as a standalone command-line tool. Ensure a Java runtime (1.7 or above) is installed. Errors are printed to standard error.

```bash
java -jar epubcheck.jar file.epub
```

--------------------------------

### Checker Script Command-Line Options

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Examples of using the checker script with different command-line options to control build, test, run, and compilation processes.

```bash
python ./checker.py --help
```

```bash
python ./checker.py build  # to build only
```

```bash
python ./checker.py build  # test to build and test
```

```bash
python ./checker.py run    # to run only
```

```bash
python ./checker.py jar    # to compile vnu.jar
```

```bash
python ./checker.py update-shallow && \
    python ./checker.py dldeps && \
    python ./checker.py jar  # compile vnu.jar faster
```

--------------------------------

### Set JAVA_HOME Environment Variable (Ubuntu/macOS)

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Sets the JAVA_HOME environment variable, required for building the validator. Examples provided for Ubuntu and macOS.

```bash
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64    <-- Ubuntu, etc.
```

```bash
export JAVA_HOME=$(/usr/libexec/java_home)            <-- MacOS
```

--------------------------------

### Deploy VNU WAR to Servlet Container

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Example log message indicating successful deployment of the vnu.war file to a servlet container like Apache Tomcat.

```log
May 7, 2014 4:42:04 PM org.apache.catalina.startup.HostConfig deployWAR
INFO: Deploying web application archive /var/lib/tomcat7/webapps/vnu.war
```

--------------------------------

### Install Nu Html Checker via Homebrew

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Install the vnu command-line tool using Homebrew on macOS. This provides a convenient way to access the checker from your terminal.

```bash
brew install vnu
```

--------------------------------

### Run VNU Checker as Standalone Server

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Start the VNU checker as a standalone service using the built-in Jetty server. Specify the port to listen on. Future releases may default to 127.0.0.1, so consider using bind-address.

```bash
java -cp ~/vnu.jar              nu.validator.servlet.Main 8888
```

```bash
vnu-runtime-image/bin/java      nu.validator.servlet.Main 8888
```

```bash
vnu-runtime-image\bin\java.exe  nu.validator.servlet.Main 8888
```

--------------------------------

### Install Nu Html Checker via npm

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Install the vnu-jar package, which provides the Nu Html Checker, using npm. This is useful for integrating HTML checking into Node.js projects.

```bash
npm install vnu-jar
```

--------------------------------

### Set Java System Properties for VNU Checker

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Configures the VNU checker with specific Java system properties using the `JAVA_TOOL_OPTIONS` environment variable. This example sets `nu.validator.client.asciiquotes` to `yes`.

```bash
docker run -it --rm \
         -e JAVA_TOOL_OPTIONS=-Dnu.validator.client.asciiquotes=yes  \
         -p 8888:8888 \
         validator/validator
```

--------------------------------

### Inject pytest into standardebooks package

Source: https://github.com/standardebooks/tools/blob/master/tests/README.md

Injects the pytest testing framework into the pipx-created virtual environment for the standardebooks package. Ensure pytest is installed in the correct version.

```shell
pipx inject standardebooks pytest==9.0.2
```

--------------------------------

### XML Glossary Entry Match Example

Source: https://github.com/standardebooks/tools/blob/master/tests/lint/metadata/m-070/golden/m-070-out.txt

This XML snippet shows a `<match>` element within a glossary configuration. Ensure that the 'value' attribute corresponds to an actual entry in the text to avoid 'Glossary entry not found' errors.

```xml
<match value="foo"/>
```

--------------------------------

### Run Validator Only

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Starts only the validator service without performing build or test operations.

```bash
python ./checker.py run
```

--------------------------------

### Install Nu Html Checker via pip

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Install the html5validator Python package, which integrates the Nu Html Checker. This is useful for automated checking in CI environments or Python projects.

```bash
pip install html5validator
```

--------------------------------

### Run VNU Checker with Java JAR

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Invoke the VNU checker using the Java JAR file. Ensure Java 8+ is installed. Replace `~/vnu.jar` with the actual path to your JAR file.

```bash
java -jar ~/vnu.jar OPTIONS FILES
```

--------------------------------

### Comment out VNU Servlet Filter

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Example of commenting out the inbound-size-limit-filter within the /WEB-INF/web.xml file of the VNU WAR archive to disable it.

```xml
<!--
  <filter>
      <filter-name>inbound-size-limit-filter</filter-name>
      <filter-class>nu.validator.servlet.InboundSizeLimitFilter</filter-class>
  </filter>
  <filter-mapping>
      <filter-name>inbound-size-limit-filter</filter-name>
      <url-pattern>/\*</url-pattern>
  </filter-mapping>
-->
```

--------------------------------

### Run VNU HTTP Client Remotely

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Check documents against a remote VNU instance by specifying the host and port using system properties. This example targets html5.validator.nu on port 80.

```java
java -cp ~/vnu.jar -Dnu.validator.client.port=80 \
        -Dnu.validator.client.host=html5.validator.nu \
        nu.validator.client.HttpClient FILE.html...
```

```java
vnu-runtime-image/bin/java -Dnu.validator.client.port=80 \
        -Dnu.validator.client.host=html5.validator.nu \
        nu.validator.client.HttpClient FILE.html...
```

--------------------------------

### Update Homebrew on macOS

Source: https://github.com/standardebooks/tools/blob/master/README.md

Updates the Homebrew package manager to the latest version. This is a prerequisite for installing tools with Homebrew.

```shell
brew update
```

--------------------------------

### XML Glossary Entry Value Example

Source: https://github.com/standardebooks/tools/blob/master/tests/lint/metadata/m-070/golden/m-070-out.txt

This XML snippet defines a `<value>` element for a glossary entry. If this 'value' is not present in the processed text, the m-070 error may occur.

```xml
<value value="pariahsss"/>
```

--------------------------------

### Display EPUBCheck Command Line Help

Source: https://github.com/standardebooks/tools/blob/master/se/data/epubcheck/README.txt

View the available command-line options and usage instructions for EPUBCheck by using the --help argument.

```bash
java -jar epubcheck.jar --help
```

--------------------------------

### Run Pylint and Pyright from Pipx Venv

Source: https://github.com/standardebooks/tools/blob/master/README.md

Execute `pylint` and `pyright` using their full paths within the `standardebooks` virtual environment created by `pipx`. Ensure `pyright` is aware of the venv path for correct library resolution.

```shell
cd /path/to/tools/repo
$HOME/.local/share/pipx/venvs/standardebooks/bin/pylint .
```

```shell
# Specify the venv path to `pyright` so that it knows where to look for libraries.
$HOME/.local/share/pipx/venvs/standardebooks/bin/pyright --venvpath=$HOME/.local/share/pipx/venvs/ .
```

--------------------------------

### Clone and Navigate to Validator Repository

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Clone the validator repository from GitHub and change into the newly created directory. This sets up the project's working directory.

```bash
git clone https://github.com/validator/validator.git
```

```bash
cd validator
```

--------------------------------

### Inject Linters into Standard Ebooks Pipx Environment

Source: https://github.com/standardebooks/tools/blob/master/README.md

Use `pipx inject` to add `pylint` and `pyright`, along with necessary type stubs, to the `standardebooks` virtual environment.

```shell
pipx inject standardebooks pylint==4.0.5 pyright==1.1.410 types-requests==2.33.0.20260518 types-setuptools==80.9.0.20250822 types-lxml==2026.2.16
```

--------------------------------

### Run Nu Html Checker (Windows)

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Execute the Nu Html Checker from the command line on Windows systems. Replace OPTIONS with desired checker flags and FILES with the paths to the documents to be validated.

```batch
vnu-runtime-image\bin\vnu.bat OPTIONS FILES
```

--------------------------------

### Run Nu Html Checker (Linux/macOS)

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Execute the Nu Html Checker from the command line on Linux or macOS systems. Replace OPTIONS with desired checker flags and FILES with the paths to the documents to be validated.

```bash
vnu-runtime-image/bin/vnu OPTIONS FILES
```

--------------------------------

### Run Nu Html Checker via Docker

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Launch an instance of the Nu Html Checker using Docker. This command pulls the latest validator image and maps port 8888 for access.

```bash
docker run -it --rm -p 8888:8888 validator/validator:latest
```

--------------------------------

### Check Directory as CSS

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents within a specified directory specifically as CSS files.

```bash
vnu --css DIRECTORY_PATH
```

--------------------------------

### Check Documents Locally with HTTP Client

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Use the VNU checker's packaged HTTP client from the command line to check documents against a locally running instance of the checker service.

```bash
java -cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
```

```bash
vnu-runtime-image/bin/java nu.validator.client.HttpClient FILE.html...
```

--------------------------------

### Check Directory with Mixed HTML and CSS

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents in a directory, treating files with a .css extension as CSS and all others as HTML.

```bash
vnu --also-check-css DIRECTORY_PATH
```

--------------------------------

### Execute pytest tests

Source: https://github.com/standardebooks/tools/blob/master/tests/README.md

Navigates to the top level of the tools repository and executes pytest using the path to the virtual environment's pytest executable. This command assumes the virtual environment is already set up.

```shell
cd /path/to/tools/repo
$HOME/.local/share/pipx/venvs/standardebooks/bin/pytest
```

--------------------------------

### Standard Ebooks Source Directory Structure

Source: https://github.com/standardebooks/tools/blob/master/README.md

This is a visual representation of the typical file and directory structure for a Standard Ebooks source project. It details the placement of images, source files, and EPUB-specific content.

```text
.
|__ images/
|   |__ cover.jpg
|   |__ cover.source.jpg
|   |__ cover.svg
|   |__ titlepage.svg
|
|__ src/
|   |__ META-INF/
|   |   |__ container.xml
|
|   |__ epub/
|   |   |__ css/
|   |   |   |__ core.css
|   |   |   |__ local.css
|   |   |   |__ se.css
|   |   |
|   |   |__ images/
|   |   |   |__ cover.svg
|   |   |   |__ logo.svg
|   |   |   |__ titlepage.svg
|   |   |
|   |   |__ text/
|   |   |   |__ colophon.xhtml
|   |   |   |__ imprint.xhtml
|   |   |   |__ titlepage.xhtml
|   |   |   |__ uncopyright.xhtml
|   |   |
|   |   |__ content.opf
|   |   |__ toc.xhtml
|
|   |__ mimetype
|
|__ LICENSE.md
```

--------------------------------

### Run Checker with Bind Address Option

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Runs the checker script with the --bind-address option to specify a particular IP address, preventing potential reachability issues in future releases.

```bash
python ./checker.py --bind-address=128.30.52.73 all
```

--------------------------------

### Check a Web Document

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check a document located at a specific URL. Replace `URL` with the actual web address.

```bash
vnu URL
```

```bash
vnu http://example.com/foo
```

--------------------------------

### VNU Option: --Werror

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Treat warnings as errors. The checker will exit with a non-zero status if any warnings are encountered.

```bash
java -jar ~/vnu.jar --Werror FILES
```

--------------------------------

### Check HTML Files from Command Line

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check one or more HTML files using the VNU command-line tool. You can use the direct executable or the Java JAR.

```bash
vnu-runtime-image/bin/vnu      FILE.html FILE2.html FILE3.html...
```

```bash
vnu-runtime-image\bin\vnu.bat  FILE.html FILE2.html FILE3.html...
```

```bash
java -jar ~/vnu.jar            FILE.html FILE2.html FILE3.html...
```

--------------------------------

### Check Directory Skipping Non-HTML Files

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents in a directory as HTML, but skip files that do not have .html, .htm, .xhtml, or .xht extensions.

```bash
vnu --skip-non-html DIRECTORY_PATH
```

--------------------------------

### Use EPUBCheck as a Java Library

Source: https://github.com/standardebooks/tools/blob/master/se/data/epubcheck/README.txt

Integrate EPUBCheck into your Java application by using its public interfaces. Instantiate the EPUBCheck class and call the validate() method. Implement the Report interface to handle validation results.

```java
EPUBCheck epubcheck = new EPUBCheck(new File("file.epub"));
epubcheck.validate();
```

--------------------------------

### Check All HTML Documents in a Directory

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents within a specified directory as HTML. This command assumes the VNU executable is in your system's PATH.

```bash
java -jar ~/vnu.jar            DIRECTORY_PATH
```

```bash
vnu      DIRECTORY_PATH
```

```bash
vnu-runtime-image\bin\vnu.bat  DIRECTORY_PATH
```

--------------------------------

### Parallel Execution of Corpus Commands

Source: https://github.com/standardebooks/tools/blob/master/README.md

Use GNU Parallel to run `se` commands on multiple ebook repositories concurrently for faster processing. Export `COLUMNS` to ensure correct output formatting.

```shell
# Slow: Each argument is processed in sequence.
se lint /path/to/ebook/repos/*
```

```shell
# Fast: Multiple invocations each process a single argument in parallel.
export COLUMNS; parallel --keep-order se lint ::: /path/to/ebook/repos/*
```

--------------------------------

### Check Directory with Mixed HTML and SVG

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents in a directory, treating files with a .svg extension as SVG and all others as HTML.

```bash
vnu --also-check-svg DIRECTORY_PATH
```

--------------------------------

### Bind VNU Servlet to Specific IP Address

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Configure the VNU servlet to listen on a specific IP address using the `nu.validator.servlet.bind-address` system property. Defaults to '0.0.0.0' to listen on all interfaces.

```bash
-Dnu.validator.servlet.bind-address=127.0.0.1
```

--------------------------------

### Check Standard Input

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check content piped to the VNU checker via standard input. Use '-' as the file argument.

```bash
vnu -
```

```bash
echo '<!doctype html><title>...' | vnu -
```

```bash
echo '<!doctype html><title>...' | java -jar ~/vnu.jar -
```

--------------------------------

### Compile vnu.jar

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Compiles the vnu.jar artifact for the validator.

```bash
python ./checker.py jar
```

--------------------------------

### Build and Test Validator

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Executes the build and test targets for the validator using the checker script.

```bash
python ./checker.py build
```

```bash
python ./checker.py build
```

--------------------------------

### Clone Validator Repository

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Clones the validator project repository from GitHub into the current directory.

```bash
git clone https://github.com/validator/validator.git
```

--------------------------------

### Faster vnu.jar Compilation

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Compiles vnu.jar more quickly by updating shallow files, downloading dependencies, and then compiling.

```bash
python ./checker.py update-shallow && \
  python ./checker.py dldeps && \
  python ./checker.py jar
```

--------------------------------

### Configure VNU Checker Timeouts

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Sets custom connection and socket timeouts for the VNU checker using environment variables. The default is 5 seconds.

```bash
docker run -it --rm \
         -e CONNECTION_TIMEOUT_SECONDS=15 \
         -e SOCKET_TIMEOUT_SECONDS=15 \
         -p 8888:8888 \
         validator/validator
```

--------------------------------

### Set Docker Validator Java System Properties

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Runs the validator from Docker Hub with specific Java system properties configured using the JAVA_TOOL_OPTIONS environment variable.

```bash
docker run -it --rm \
     -e JAVA_TOOL_OPTIONS=-Dnu.validator.client.asciiquotes=yes  \
     -p 8888:8888 \
     validator/validator
```

--------------------------------

### Check Directory Skipping Non-CSS Files

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents in a directory as CSS, but skip files that do not have the .css extension.

```bash
vnu --skip-non-css DIRECTORY_PATH
```

--------------------------------

### Set Docker Validator Timeouts via Environment Variables

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Runs the validator from Docker Hub with custom connection and socket timeouts set using environment variables.

```bash
docker run -it --rm \
     -e CONNECTION_TIMEOUT_SECONDS=15 \
     -e SOCKET_TIMEOUT_SECONDS=15 \
     -p 8888:8888 \
     validator/validator
```

--------------------------------

### Run Specific Docker Validator Version

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Pulls and runs a specific version of the validator from Docker Hub, using the '17.11.1' tag.

```bash
docker run -it --rm -p 8888:8888 validator/validator:17.11.1
```

--------------------------------

### VNU Option: --exit-zero-always

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Ensure the checker always exits with a zero status code, even if errors are reported.

```bash
java -jar ~/vnu.jar --exit-zero-always FILES
```

--------------------------------

### Check Documents Remotely with HTTP Client

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Send documents to a remote VNU checker instance using the command-line HTTP client. Specify the host and port of the remote service.

```bash
java -cp ~/vnu.jar -Dnu.validator.client.port=80 \
    -Dnu.validator.client.host=html5.validator.nu \
    nu.validator.client.HttpClient FILE.html...
```

```bash
vnu-runtime-image/bin/java -Dnu.validator.client.port=80 \
    -Dnu.validator.client.host=html5.validator.nu \
    nu.validator.client.HttpClient FILE.html...
```

--------------------------------

### Check Directory Skipping Non-SVG Files

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents in a directory as SVG, but skip files that do not have the .svg extension.

```bash
vnu --skip-non-svg DIRECTORY_PATH
```

--------------------------------

### VNU Option: --stdout

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Redirect error and warning messages to standard output (stdout) instead of standard error (stderr).

```bash
java -jar ~/vnu.jar --stdout FILES
```

--------------------------------

### Check Directory as SVG

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Check all documents within a specified directory specifically as SVG files.

```bash
vnu --svg DIRECTORY_PATH
```

--------------------------------

### Set VNU Client Host

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Specify the hostname for the VNU client to connect to using the `nu.validator.client.host` system property. The default is '127.0.0.1'.

--------------------------------

### Set Validator Bind Address

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Binds the validator service to a specific IP address. Default is 0.0.0.0, listening on all interfaces.

```bash
java -Dnu.validator.servlet.bind-address=127.0.0.1
```

--------------------------------

### Set Validator Connection Timeout

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Specifies the connection timeout in milliseconds. Default is 5000.

```bash
java -Dnu.validator.servlet.connection-timeout=5000
```

--------------------------------

### Set VNU Servlet Connection Timeout

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Define the connection timeout for the VNU servlet in milliseconds using the `nu.validator.servlet.connection-timeout` system property. The default is 5000.

```bash
-Dnu.validator.servlet.connection-timeout=5000
```

--------------------------------

### Docker Compose Service Definition

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Defines a 'vnu' service for use with Docker Compose, specifying the image, ports, and network mode.

```yaml
version: '2'
services:
  vnu:
    image: validator/validator
    ports:
      - "8888:8888"
    network_mode: "host" #so "localhost" refers to the host machine.
```

--------------------------------

### Adjust Stack Size for VNU Checker

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

If you encounter a StackOverflowError, adjust the thread stack size using the `-Xss` option with Java.

```bash
java -Xss512k -jar ~/vnu.jar ...
```

```bash
vnu-runtime-image/bin/java -Xss512k \
    -m vnu/nu.validator.client.SimpleCommandLineValidator ...
```

--------------------------------

### VNU Option: --asciiquotes

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Use this option to substitute ASCII quotation marks for Unicode smart quotation marks in messages.

```bash
java -jar ~/vnu.jar --asciiquotes FILES
```

--------------------------------

### Bind Docker Validator to Specific Address

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Runs the validator from Docker Hub, binding it to a specific IP address (128.30.52.73) instead of all interfaces.

```bash
docker run -it --rm -p 128.30.52.73:8888:8888 validator/validator:latest
```

--------------------------------

### Set VNU Client Port

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Specify the port for the VNU checker client to connect to. Set the 'nu.validator.client.port' system property to the desired port number.

```shell
java -Dnu.validator.client.port=8080 -jar ~/vnu.jar FILE.html
```

--------------------------------

### Set VNU Servlet Socket Timeout

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Configure the socket timeout for the VNU servlet in milliseconds via the `nu.validator.servlet.socket-timeout` system property. The default is 5000.

```bash
-Dnu.validator.servlet.socket-timeout=5000
```

--------------------------------

### Docker Compose Service for VNU Checker

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/README.md

Defines a Docker Compose service named `vnu` to run the validator image. This configuration uses `network_mode: "host"` to ensure localhost resolution.

```yaml
version: '2' services:
  vnu:
    image: validator/validator ports:
    - "8888:8888"
  network_mode: "host" #so "localhost" refers to the host machine.
```

--------------------------------

### Configure VNU Checker Bind Address

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Set the network address for the VNU checker to bind to when running as a standalone server. This is useful for controlling network accessibility.

```bash
java -cp ~/vnu.jar \
    -Dnu.validator.servlet.bind-address=128.30.52.73 \
    nu.validator.servlet.Main 8888
```

```bash
vnu-runtime-image/bin/java \
    -Dnu.validator.servlet.bind-address=128.30.52.73 \
    nu.validator.servlet.Main 8888
```

```bash
vnu-runtime-image\bin\java.exe  \
    -Dnu.validator.servlet.bind-address=128.30.52.73 \
    nu.validator.servlet.Main 8888
```

--------------------------------

### VNU Option: --errors-only

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Report only error-level messages and non-document-error messages, suppressing warnings and info messages.

```bash
java -jar ~/vnu.jar --errors-only FILES
```

--------------------------------

### Set Validator Socket Timeout

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Specifies the socket timeout in milliseconds. Default is 5000.

```bash
java -Dnu.validator.servlet.socket-timeout=5000
```

--------------------------------

### VNU Option: --filterfile

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Filter out messages that match regular expressions defined in a specified file. Each line in the file is a regex or a comment.

```bash
java -jar ~/vnu.jar --filterfile FILENAME FILES
```

--------------------------------

### Set VNU Client Message Level to Error

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Use this to suppress warning-level messages and only display error-level ones. Set the 'nu.validator.client.level' system property to 'error'.

```shell
java -Dnu.validator.client.level=error -cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
```

```shell
vnu-runtime-image/bin/java -Dnu.validator.client.level=error -cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
```

--------------------------------

### Adjust VNU Checker Thread Stack Size

Source: https://github.com/standardebooks/tools/blob/master/se/data/vnu/index.html

Increase the thread stack size for the VNU checker if you encounter StackOverflowError. This is done using the -Xss option.

```bash
java -Xss512k -cp ~/vnu.jar nu.validator.servlet.Main 8888
```

```bash
vnu-runtime-image/bin/java -Xss512k -m vnu/nu.validator.servlet.Main 8888
```
Tokens:
Raw