Asciidoc

Latest version: v10.2.0

Safety actively analyzes 634709 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 15 of 16

2.2

------------------------
- The `master.conf` configuration file name has been deprecated in
favor of `asciidoc.conf`.
- The standard configuration files set is now loaded from the
`.asciidoc` folder in the users home directory (if it exists) and
then from the source document directory. Configuration files that
don't exist are silently skipped.
- Configuration files named like the source file will be automatically
loaded if they are found in the source file directory. For example
if the source file is `mydoc.asc` and the `-b html` option is used
then asciidoc(1) will look for `mydoc.conf` and `mydoc-html.conf` in
that order.
- The characters used to quote formatted text can be configured and
extended by the user (see the master.conf [quotes] section).
- Quoted text can now be escaped by prefixing a backslash character to
the leading quote.
- The double single-quote '' strong text quote has been deprecated in
favor of an asterisk * character.
- Added \{eval:expression}, \{sys:command} and \{sys2:command}
glossary reference actions.
- Trailing brace characters `}` are now allowed inside glossary
references provided they are escaped with a backslash character.
- Glossary entries can now be escaped by prefixing a backslash
character to the leading brace character (use this in preference to
placing the backslash inside the brace).
- The output macro has been deprecated (use the new include1 macro
inside a CustomBlock).
- The default document type is `article` (asciidoc no longer attempts
to guess).
- Files included within DelimitedBlocks are not searched for block
termination underlines. This ensures the entire file is part of the
DelimitedBlock.
- `include` macros can now be used in configuration files.
- Corrected \{infile} and \{outfile} glossary entry documentation.
- File inclusion is now limited to a depth of 5 to catch recursion
loops.
- Inline tags have been deprecated, they're not necessary and they
immediately make the source document backend specific. Use
CustomBlocks or Substitutions instead.

2.1

------------------------
- Added section auto numbering `{sectnum}` glossary entry
(auto-numbering function contributed by Ludovico Magnocavallo).
- asciidoc(1) now correctly returns non-zero exit status if an error
occurs.
- An AsciiDoc example website has been included in the AsciiDoc
distribution `examples/website` directory.
- NOTE: The `asciidoc` wrapper script included in the 2.0 distribution
has been dropped, if you've symlinked or aliased to `asciidoc` you'll
need to change them to point directly to `asciidoc.py` instead.
- An RCS $Id$ marker can be used as the document header revision line
(based on a patch submitted by Ludovico Magnocavallo).
- In addition to the `name=value` glossary entry format two new ones
have been introduced: `name` (the default value is set to an empty
string) and `^name` (the glossary entry is undefined).
- The `-q` command-line option has been deprecated and the `-w level`
command-line option added. +
NOTE: By default skipped substitution warnings are now suppressed.
- If a configuration file specified with the `-f` command-line option
is not found relative to the current working directory then the
search is repeated relative to the asciidoc(1) directory. This
allows global configuration files to be used.
- Added `{infile}`, `{outfile}` predefined glossary entries.
- Added `under-construction` macro to HTML article configuration
files.
- Deprecated `{asciidoc_version}` glossary entry in favor of
`{asciidoc-version}` (to it consistent with other entries).

2.0

------------------------
- The emphasized, strong and monospaced words options have been
generalized with the introduction of macro based 'special words'
lists.
- Glossary references can now appear in both the document and macro
bodies.
- All output files use `crlf` line termination (previously used UNIX
`lf` (newline) termination).
- Added [substitutions] section which implements arbitrary regular
expression based substitutions.
- An optional `master.conf` configuration file can be used for entries
that are not backend or document type specific.
- Special character definitions moved from the code to the new
[special_characters] configuration file section.
- Configuration file glossary added.
- Command-line -g glossary entry added.
- A new 'book' document type has been implemented for the 'docbook'
backend. It outputs DocBook 'book' documents.
- A major internal change has been the implementation of parametrized
user definable 'macros'. Internally most document elements are now
processed as macros.
- Configuration file macro variables can be specified with default
values (literals or other macro variables).
- An attempt has been made to tighten up the vocabulary used to
describe the AsciiDoc document syntax.
- The term abstract has been replaced by the more general term
'preface' and a new preface section introduced into article
configuration files (replacing the synopsis sections).
- Any section elements can now be put in the document preface
(previous versions only allowed paragraphs).
- AsciiDoc Blocks have been unified and their behavior can be user
defined and parametrized.
- An 'output' inclusion allows an external file to be written directly
to the backend output file.
- A new CustomBlock has been added. Default behavior is to insert the
enveloped AsciiDoc source lines directly into the output file.
- A 'line break' tag can be inserted by terminating a line with a '+'
character (only really useful for HTML backends).
- An fourth section level has been introduced.
- The SidebarBlock delimiter line characters have been changed. The
deprecated underline is still accepted.
- Levels 2 and 3 title underline characters have been changed. The
deprecated underlines are still accepted.
- Lines with backend specific inline tags can be inserted into
AsciiDoc source files.
- Single words enveloped by underscores are no longer emphasized. This
feature was deprecated as it is redundant (use single quotes
instead) and was being applied to file names with underscores.
- A `-q` quiet option has been added to suppress warning messages.
- Badge images sourced locally.
- Added 'author' and 'author-mail' meta tags to HTML configuration
files.

1.5

------------------------
- Implemented sidebar document elements.
- Explicit checks for user specified configuration files and input
file (rather than throwing exception).

1.4

------------------------
- New configuration file options 'emphasizedwords' and 'strongwords'.
These allow the definition of words that will always be emphasized
or rendered in a strong font without inline formatting.
- Document and section titles are no long subject to inline
formatting.
- Multiple configuration files can be overlaid in a single command.
- Configuration file tags and options entries can now be overridden on
an entry by entry basis (previously the entire section was
overloaded).
- Configuration file tags and options entries are now cached this has
resulted in around 37% performance improvement over version 1.3.
- Variable lists can now contain multiple terms per list item.
- Placeholder paragraph eliminated from empty sections that contain
subsections.
- Added \{asciidoc_version} substitution variable.
- More documentation additions and tidy ups.

1.3

------------------------
- A new 'strong' text formatting convention has been implemented:
Word phrases enclosed in pairs of single quote characters (acute
accents) are rendered in a strong font (usually bold).
- Paragraphs can now be followed immediately by Simple lists and
Ordered lists without an intervening blank line.
- A user specified configuration file (`asciidoc(1)` -f option)
overlays the default configuration file rather than replacing it.
Custom configuration files need only contain those sections
that have been customized.
- Comment Block delimiters have been relaxed slightly. They must start
with three forward slashes /// but the remainder can contain any
characters, this allows comments to be embedded in the delimiter line.
- Leading non-digit characters preceding revision number are now
ignored.
- Set default indentsize [option] from 2 to documented default value
of zero in HTML backend html-article.conf and html-manpage.conf
files.
- Fixed error that occurred when taking input from stdin without
explicitly specifying a document type.
- Restored file name and line number error message information.
- Changed deprecated -t option to -d in asciidoc --help and usage
command output.
- CSS styles tweaking.
- Code, configuration file and documentation tidy ups.

Page 15 of 16

© 2024 Safety CLI Cybersecurity Inc. All Rights Reserved.