There's a lot of open issues
An asciidoctor extension that adds a list of figures, a list of tables, or a list of anything you want!
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

asciidoctor-lists

Gem Test Build Latest Release Stars

An asciidoctor extension that adds a list of figures, a list of tables, or a list of anything you want!

Pull Requests are always welcome! :)

Important
With version 1.0.6 the syntax was changed from element_list::[element=image] to list-of::image[] to make it more intuitive.

Install

gem install asciidoctor-lists

Sample

Code

...

=== List of figures
list-of::image[]

=== List of tables
list-of::table[]

=== List of code snippets
list-of::listing[]

Rendered

Sample

Parameters

element

Specifies the element to be listed

enhanced_rendering (experimental)

Allows rendering links in the caption

hide_empty_section

Removes the section when no elements are found

Docker

# Build container
docker build -t asciidoctor-lists .
# Run Docker
docker run -it --rm -v $(pwd):/work asciidoctor-lists
# Build sample
asciidoctor-pdf -r asciidoctor-lists samples/list-sample.adoc

Dev setup

Run

asciidoctor -r ./lib/asciidoctor-lists.rb samples/list-sample.adoc

Install Gem

gem build asciidoctor-lists.gemspec
gem install asciidoctor-lists-x.x.x.gem

Docker Image