numbered toc and sections without dot after the last digit

[p627]

Hi, I wonder if there is an opportunity to delete the dot in the numbering after the last digit? I think this is the common convention.

I have:

I search for something like this:

Thank you in advance.

[janosvitok]

I use this snippet to remove the trailing dot (save to a file, and call asciidoctor-pdf -r filename.rb):

require 'asciidoctor-pdf' unless defined? ::Asciidoctor::Pdf

module AsciidoctorPdfSectionExtensions
  def numbered_title opts = {}
    unless (@cached_numbered_title ||= nil)
      if (slevel = (@level == 0 && @special ? 1 : @level)) == 0
        @is_numbered = false
        @cached_numbered_title = @cached_formal_numbered_title = title
      elsif @numbered && !@caption && slevel <= (@document.attr 'sectnumlevels', 3).to_i
        @is_numbered = true
        @cached_numbered_title = %(#{sectnum('.', false)} #{title}) # <----- HERE
        @cached_formal_numbered_title = if slevel == 1 && @document.doctype == 'book'
          %(#{@document.attr 'chapter-label', 'Chapter'} #{@cached_numbered_title}).lstrip
        else
          @cached_numbered_title
        end
      else
        @is_numbered = false
        @cached_numbered_title = @cached_formal_numbered_title = captioned_title
      end
    end
    opts[:formal] ? @cached_formal_numbered_title : @cached_numbered_title
  end
end

Asciidoctor::Section.prepend AsciidoctorPdfSectionExtensions

The actual change from lib/asciidoctor-pdf/asciidoctor_ext/section.rb is

-        @cached_numbered_title = %(#{sectnum} #{title})
+        @cached_numbered_title = %(#{sectnum('.', false)} #{title})

[lisa-rosenberg]

I have the same problem.

janosvitok, can you tell me how to use your snippet, please? The command you have given is leading me to this output:

rosenbeli@N0601:/mnt/d/Documents$ asciidoctor-pdf -r remove-section-trailing-dot.rb
Usage: asciidoctor [OPTION]... FILE...
Translate the AsciiDoc source FILE or FILE(s) into the backend output format (e.g., HTML 5, DocBook 4.5, etc.)
By default, the output is written to a file with the basename of the source file and the appropriate extension.
Example: asciidoctor -b html5 source.asciidoc

    -b, --backend BACKEND            set output format backend: [html5, xhtml5, docbook5, docbook45, manpage] (default: html5)
                                     additional backends are supported via extensions (e.g., pdf, latex)
    -d, --doctype DOCTYPE            document type to use when converting document: [article, book, manpage, inline] (default: article)

[...]

Am I missing something? I am in the working directory where the .adoc file and the .rb file are stored.

I have to admit that I'm new to bash, asciidoctor and ruby. Maybe that's the problem :)

[janosvitok]

Lisa: Did you specify all your usual parameters in addition to the -r ? E.g. your document?
What I actually meant was that you have to add -r remove-section-trailing-dot.rb to your current asciidoctor parameters.

[lisa-rosenberg]

Hi janosvitok,

I couldn't get it to work until now, but I will look further into this, thank you :)

I am testing it with a very basic document:

= This is a Test

:numbered:
== With a section
=== A subsection
And some text.

After:
asciidoctor-pdf -r remove-section-trailing-dot.rb -d book test.adoc --trace

I'm getting this:

/usr/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- remove-section-trailing-dot.rb (LoadError)
        from /usr/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require'
        from /usr/lib/ruby/vendor_ruby/polyglot.rb:63:in `require'
        from /var/lib/gems/2.3.0/gems/asciidoctor-1.5.6.1/lib/asciidoctor/cli/options.rb:230:in `block in parse!'
        from /var/lib/gems/2.3.0/gems/asciidoctor-1.5.6.1/lib/asciidoctor/cli/options.rb:228:in `each'
        from /var/lib/gems/2.3.0/gems/asciidoctor-1.5.6.1/lib/asciidoctor/cli/options.rb:228:in `parse!'
        from /var/lib/gems/2.3.0/gems/asciidoctor-pdf-1.5.0.alpha.16/bin/asciidoctor-pdf:25:in `<top (required)>'
        from /usr/local/bin/asciidoctor-pdf:22:in `load'
        from /usr/local/bin/asciidoctor-pdf:22:in `<main>'

Packages should be up to date:

ruby -v
ruby 2.3.5p376 (2017-09-14 revision 59905) [x86_64-linux-gnu]

asciidoctor -v
Asciidoctor 1.5.6.1 [http://asciidoctor.org]
Runtime Environment (ruby 2.3.5p376 (2017-09-14 revision 59905) [x86_64-linux-gnu]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

asciidoctor-pdf -v
Asciidoctor PDF 1.5.0.alpha.16 using Asciidoctor 1.5.6.1 [http://asciidoctor.org]
Runtime Environment (ruby 2.3.5p376 (2017-09-14 revision 59905) [x86_64-linux-gnu]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

[janosvitok]

@lisa-rosenberg
https://stackoverflow.com/questions/9750610/ruby-require-error-cannot-load-such-file
http://asciidoctor.org/docs/user-manual/#cli-options

TL;DR: either provide path to remove-section-trailing-dot.rb (e.g. -r ./remove-section-trailing-dot.rb or -r /home/asdf/remove-section-trailing-dot.rb) or add -I path (e.g. -I . or -I /home/asdf)

[michael-o]

I'd be interested too. There is no trailing dot in numbering. This is against common convention.

[mojavelinux]

To move forward, we need a way to express this configuration. It probably belongs in the theme. We need to agree on a key and value. Implementation is then rather trivial I would suspect.

[mojavelinux]

(it could also be done with a document attribute so it also applies to other converters).

[mojavelinux]

I'm looking for the name of an option that may exist in other systems, so we can build on established conventions. If we can't find one, we'll have to invent one.

[j-dimension]

I'd be interested too.

[dalemartin]

@mojavelinux what ever became of this? I would like to use the feature if it's been implemented.

[mojavelinux]

We're waiting on architecture. That hasn't been solved, so no code can be written yet. Feel free to propose solutions.

[michael-o]

I'd like to see this removed by default. Haven't found this in any book type setting nor in LaTeX.

[mojavelinux]

We can't simply change behavior on all users. There has to be a setting. Some way to describe that you want different output than what is typical (for Asciidoctor).

[mojavelinux]

O'Reilly always includes the trailing dot in their books. Other publishers do not.