Page numbering renders as 1 in all sections

I think this bug has influence in all the flavours.

• https://www.itu.int/pub/T-TUT-FSTP-2020-ACC.WEBVRI
• https://www.itu.int/pub/T-TUT-L-2020-GLR
• https://www.itu.int/pub/T-TUT-CABLETV-2020

Question for @andrew2net . The mn-samples-itu STL-manual.adoc has these references to Annexes, but they are not auto-fetched. What is the correct notation cite an ITU Recommendation Annex? Thanks.

* [[[G726-LinearIO,20]]], ITU Telecommunication Standardization Sector. Extensions of Recommendation ITU-T G.726 for use with uniform quantized input and output. In _Recommendation G.726_, chapter Annex A. ITU, Geneva, Switzerland, November 1994.
* [[[G727-LinearIO,22]]], ITU Telecommunication Standardization Sector. Annex A to Recommendation ITU-T G.727, _Extensions of Recommendation ITU-T G.727 for use with uniform-quantized input and output._ ITU, Geneva, Switzerland, November 1994.
* [[[G.728G,23]]], ITU Telecommunication Standardization Sector. _Recommendation ITU-T G.728 Annex G - 16 kbit/s fixed point specification._ ITU, Geneva, Switzerland, November 1994.
* [[[G.728I,24]]], ITU Telecommunication Standardization Sector. _Recommendation ITU-T G.728 Annex I - Frame or packet loss concealment for the LD-CELP decoder._ ITU, Geneva, Switzerland, July 1999.
* [[[P.50,(14)ITU-T P.50]]], ITU Telecommunication Standardization Sector. _Recommendation ITU-T P.50 Annex I - Artificial voices._ ITU, Geneva, Switzerland, February 1998.

In example block, there is a noticeable difference between paragraph margin and list block margin.

me-issue-sample.zip

Following differences were noticed:

• "W3C" is duplicated in generated DOC, although there is no duplication in .adoc:
  * [[[xmlschema, W3C XMLSchema]]] W3C Recommendation (2004), _XML Schema Part 2: Datatypes Second Edition_.
* [[[csstransforms,(b-W3C CSS Transforms)W3C CSS Transforms]]] W3C, _CSS_ _Transforms Module Level 1_. https://www.w3.org/TR/css-transforms-1/[https://www.w3.org/TR/css-transforms-1/] – [Last accessed 02 Oct. 2018].

Moreover, when auto-fetching isn't possible, document identifier is rendered twice - between the brackets and in the short reference description.

Original:

Generated DOC:

• Some of the b-references and cross-references are rendered differently than in the original document. They include more brackets in generated DOC.

Original:

Generated DOC:

• In the original document, reference tag/ID and its corresponding description are written like in two separate columns (similar to definitions in Metanorma). In other words, spacing between the tag/ID and its short description differs.

Original:

Generated DOC:

https://www.itu.int/rec/T-REC-G.Imp8001-202002-I/en

Please, refer to the sample:

table-issue-sample.zip

From @ronaldtse

"""
ITU says they couldn't install the ruby-xslt gem in this bundle: https://github.com/metanorma/mn-itu-docs
But they can install Metanorma Chocolatey fine.
(they had to add the "C:\tools\ruby25\bin" path to "environment variables" to make Ruby work)
"""

AFAIK action items are:

• Add Appveyor CI
• Update Gemfile.lock will be done in the scope of #2

ITU has given three documents to exercise the compiler, I put them under reference-docs/.

The purposes are:

• Y.3507: contains figures inside a table
• G.650.1: contains a number of equations, and
• Z.100 Annex F1: uses different types of fonts.

@opoudjis could you please help convert them? Thanks!

https://github.com/metanorma/mn-samples-itu/runs/2040568410?check_suite_focus=true#step:5:39214

...
Anchors: (XML Line 000001): Anchor tbl_known-endian has already been used at line 567
Error: multiple instances of same ID

@ronaldtse could you please assign it to someone who familiar with it? If not, I can dig into it

Similar to metanorma/mn-samples-ietf#43

Only in DOC output:
footnote-issue-sample.zip

In response to @anermina: need to investigate warnings about crossreferences:

IDREF "a<em>6_4_1Reference_test_method" without matching ID @ 1844:349
IDREF "a<em>6_3_1_3_3Calculations" without matching ID @ 1454:241
IDREF "a<em>I_1Limited_negative_error_method" without matching ID @ 2366:316
IDREF "a<em>6_3_1_3_2Transmission_through_the_reference_sample" without matching ID @ 1338:95
IDREF "a</em>6_4_2First_alternative_test_method" without matching ID @ 1844:437
IDREF "a</em>I_2Least_squares_method" without matching ID @ 2366:373
IDREF "a</em>6_3_1_2_3Launching_conditions" without matching ID @ 1338:677
IDREF "a</em>6_3_1_3_4Determination_of_cut-off_wavelength" without matching ID @ 1454:319
No label has been processed for ID fig1
No label has been processed for ID [fig1]
No label has been processed for ID fig2
No label has been processed for ID [fig2]
No label has been processed for ID fig2

These may or may not be mark up issues. It may be that anchors must not contain underscores (which is a problem, given that reverse_adoc is generating these.)

There is also a profusion of bibitem/relation and other errors in the grammar parse, which need to be looked at.

Cross-reference to the note (in the images below) indicates the number of subclause, instead of the subsubclause where note is positioned. This doesn't happen in the attached test document using similar cross-referencing.

Original:

Generated:

test_notes_referencing.zip

• Figures are numbered differently (they have chapter/section indication in the original document). Since this wasn't noticed in other ITU recommendations, this issue is opened just to double-check whether this is an inconsistency in the original ITU recommendations, which we can ignore (?). For example, original ITU P.1203 uses the same numbering style as generated DOC.

Generated:

Original:

In mn-samples-itu, the Relaton index is not showing any document, but all are built. Reproduced locally as well. Seems like a Relaton-ITU problem?

In ITU Z.100, pseudocode is written between ==== delimiters marked with [%unnumbered] attribute, but it is still numbered as figure. Is there an option to avoid having a title? Delimiter ---- wouldn't be good in this case because of the text formatting.

Original:

Generated:

ITU uses Times New Roman fonts, but they are not available on the PDF layouts in the output.

Please use https://github.com/fontist/fontist to install the necessary fonts.

• https://www.itu.int/pub/T-TUT-CCICT-2017
• https://www.itu.int/pub/T-TUT-CCICT-2015

A number of technical reports are not officially published in Doc.

All words in table headings are automatically written with capital letter, which isn't correct in some cases. Following example with metric units illustrates the issue.

https://www.itu.int/rec/T-REC-P.Imp863-201912-I

Both T-TUT-CCIT-* documents have been commented out in metanorma.yml because compilation fails with this message:

Bibliography: (XML Line 000001): Numeric reference in normative references
Bibliography: (XML Line 000001): Numeric reference in normative references
Bibliography: (XML Line 000001): Numeric reference in normative references
Bibliography: (XML Line 000001): Numeric reference in normative references
Bibliography: (XML Line 000001): Numeric reference in normative references
Numeric reference in normative references

Then metanorma crashes at this point with a non-zero return code.

There is no vertical space between paragraphs in example block (doc output). I think, in some cases, it may be necessary for styling purposes.
example-issue-sample.zip

If the pseudocode block has a title, it renders as figure title. (Additionally, the background color changes.)

pseudocode-title.zip

This task is to convert P.1203 to Metanorma and add to this repository.

T-REC-P.1203-201710-I!!MSW-E.docx

pseudocode-lines-issue.zip

What’s the minimal build instructions for an ITU sample document?

• https://www.itu.int/rec/T-REC-A.8-200810-I/en
• https://www.itu.int/pub/T-RES-T.1-2016

@anermina do you have time to help convert both of these? I've added them to reference-docs. Thanks!

Please, refer to the sample:
crossreference-issue-sample.zip

Since we have a draft version for ITU J.1108 as a referent document, and the final version was published in the meanwhile, I would like to check how the .adoc should be modified.
Currently, it includes many "Draft [New]" tags.

Should I correct .adoc in accordance to https://www.itu.int/rec/T-REC-J.1108/en, or to the draft version from https://github.com/metanorma/mn-samples-itu/tree/master/references/itu-t?

In Example environment, the distance between pseudocode block and external text is too large. See sample below.

pseudocode-issue-sample.zip

Stem equations get bigger and boldfaced in HTML output (didn't happen before).

equations-issue-sample.zip

I've uploaded the ITU-T Editing Guidelines to reference-docs/. @anermina could you please help convert it? Thanks!

G.191's source can be found here:

• https://github.com/openitu/STL/tree/dev/doc/manual
• https://github.com/simaocampos/STL-manual

The first link is supposed to be updated to 2019, the second is 2018.

If the first link works, we can ignore the second.

https://www.itu.int/rec/T-REC-H.Imp248-201710-I

NOTE: This is an implementers guide to a "series".

Utilize new citation syntax implemented in metanorma/metanorma-standoc#159 .

Many ITU references go with "[b-ITU xxx]", and this repo's documents will need this.

Ping @manuel489 thanks!

@manuel489 the References are still problematic, we are waiting for @andrew2net to fix relaton/relaton-itu#32 . But let's merge this first.

Originally posted by @ronaldtse in #51 (comment)

If a list title is composed by two or more words, it gets divided in lines (one per word). Please, look at the sample below for clarification purposes.

issue-sample.zip

Sample List:

*Word1*:: Duis accumsan convallis lacus vehicula tristique. Integer maximus magna lorem, at 
ullamcorper ligula vestibulum id. Fusce fringilla velit libero, ut consequat ex pretium eget. Quisque
 vehicula convallis nulla, varius ullamcorper libero euismod eget. Donec consectetur id leo in 
tristique. Curabitur efficitur accumsan est, at volutpat risus elementum nec.

*Word1 Word2*:: Integer vitae mi mauris. Mauris dignissim venenatis lorem. Aliquam at arcu in felis 
mattis volutpat non nec felis. Vivamus placerat neque neque, ut tempus magna tristique eget. 
Suspendisse potenti. Curabitur id mollis mauris, ac pellentesque nunc.

*Word1 Word2 Word3*:: Suspendisse mattis mauris vel luctus suscipit. Nam porttitor ornare 
imperdiet. Pellentesque in nunc a sem porttitor tincidunt vitae vitae arcu. Maecenas sit amet ornare
 ligula. Quisque eu leo urna. Etiam pretium enim ullamcorper, consequat diam a, ornare libero. 
Vivamus neque metus, sagittis ac metus in, tincidunt ultricies dui. Ut ullamcorper sit amet libero et 
blandit.

Images are left-aligned in figure environment (DOC output).

figure-sample-issue.zip

In blockquote, the lines that include line-break character (+) get justified-aligned (instead of left-aligned), making them look strange. (This only happens in doc output.)

jl-issue-sample.zip

https://www.itu.int/rec/T-REC-P.Imp863-201805-I

The inlined base-64 images pollute the text files in text editors, especially for newcomers. Let's get them extracted into separate image files.

This is a strange case.

I need to typeset this piece of text:

For which I use the following markup:

Consider a given vocabulary _V_ containing [smallcap]#_Real_# (but not _currentTime_) and let 
stem:[V^+] be the extension of _V_ with the function symbol _currentTime_. Restrict attention to
stem:[V^+] -states where _currentTime_ evaluates to a real number."

And I get this:

The problem seems to be exclusive for stem:[V^+]. If I remove one of the two "stem:[V^+]" the problem gets solved. If I change the plus sign for a number, it gets solved as well.

se-issue-sample.zip

As requested in #79 (comment)

Task is to check the bibliographies of all the documents from this repository.

In blockquote and example block, the lines that only have inline equations get centered.

ce-issue-sample.zip

ITU-T_G_191__01_2019_.pdf
ITU-T_G_191__01_2019_.docx

And remove from AppVeyor.

Right now the Gemfile lists out git-gems. We want this repository to work with properly released gems. Task for @opoudjis .