mirror of
https://github.com/docker/cli.git
synced 2026-09-26 17:30:51 -04:00
Aleksa Sarai
47775a8fa0
In order to be able to build the documentation without internet access (as is required by some distribution build systems), all of the source code needed for the build needs to be available in the source tarball. This used to be possible with the docker-cli sources but was accidentally broken with some CI changes that switched to downloading the tools (by modifying go.mod as part of the docs build script). This pattern also maked documentation builds less reproducible since the tool version used was not based on the source code version. Fixes:7dc35c03fc("validate manpages target") Fixes:a650f4ddd0("switch to cli-docs-tool for yaml docs generation") Signed-off-by: Aleksa Sarai <cyphar@cyphar.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
47 lines
2.4 KiB
Go
47 lines
2.4 KiB
Go
// Package blackfriday is a markdown processor.
|
|
//
|
|
// It translates plain text with simple formatting rules into an AST, which can
|
|
// then be further processed to HTML (provided by Blackfriday itself) or other
|
|
// formats (provided by the community).
|
|
//
|
|
// The simplest way to invoke Blackfriday is to call the Run function. It will
|
|
// take a text input and produce a text output in HTML (or other format).
|
|
//
|
|
// A slightly more sophisticated way to use Blackfriday is to create a Markdown
|
|
// processor and to call Parse, which returns a syntax tree for the input
|
|
// document. You can leverage Blackfriday's parsing for content extraction from
|
|
// markdown documents. You can assign a custom renderer and set various options
|
|
// to the Markdown processor.
|
|
//
|
|
// If you're interested in calling Blackfriday from command line, see
|
|
// https://github.com/russross/blackfriday-tool.
|
|
//
|
|
// Sanitized Anchor Names
|
|
//
|
|
// Blackfriday includes an algorithm for creating sanitized anchor names
|
|
// corresponding to a given input text. This algorithm is used to create
|
|
// anchors for headings when AutoHeadingIDs extension is enabled. The
|
|
// algorithm is specified below, so that other packages can create
|
|
// compatible anchor names and links to those anchors.
|
|
//
|
|
// The algorithm iterates over the input text, interpreted as UTF-8,
|
|
// one Unicode code point (rune) at a time. All runes that are letters (category L)
|
|
// or numbers (category N) are considered valid characters. They are mapped to
|
|
// lower case, and included in the output. All other runes are considered
|
|
// invalid characters. Invalid characters that precede the first valid character,
|
|
// as well as invalid character that follow the last valid character
|
|
// are dropped completely. All other sequences of invalid characters
|
|
// between two valid characters are replaced with a single dash character '-'.
|
|
//
|
|
// SanitizedAnchorName exposes this functionality, and can be used to
|
|
// create compatible links to the anchor names generated by blackfriday.
|
|
// This algorithm is also implemented in a small standalone package at
|
|
// github.com/shurcooL/sanitized_anchor_name. It can be useful for clients
|
|
// that want a small package and don't need full functionality of blackfriday.
|
|
package blackfriday
|
|
|
|
// NOTE: Keep Sanitized Anchor Name algorithm in sync with package
|
|
// github.com/shurcooL/sanitized_anchor_name.
|
|
// Otherwise, users of sanitized_anchor_name will get anchor names
|
|
// that are incompatible with those generated by blackfriday.
|