Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

position of bibliography in document and toc do not match; index entry in the toc not assigned a page number #238

Open
ReesePlews opened this issue Nov 27, 2024 · 2 comments
Labels
bug Something isn't working

Comments

@ReesePlews
Copy link
Contributor

i have a question about the encoding of the bibliography in one of the project documents.

in the plateau doc2 (sources/002-v4) the bibliography ( 参考文献 ) is showing at the end of the table of contents but the page number says 113 and its position in the document begins on page 113 before the annexes.

from the doc2 reference document (reference-docs/plateau_doc_0002_ver04.pdf) , the bibliography should be at the end of the document.

i looked at doc1 (sources/001-v4) and that document's bibliography is at the end of the document.

the revision history ( 改訂履歴 ) was moved to the early section of both documents (this restructure was approved early on by the plateau team).

i just cannot figure out how / why the bibliography position is different in doc2 vs doc1 except doc1 does not have any annexes but doc2 does. perhaps that is a reason. i have made these checks locally and they match the output the client obtained from github.

we want to keep the bibliography at the end of the document, like it is in doc1 and the reference documents.

the index ( 索 引 ) was added for doc2. is it not present in the doc2 reference document. for now i guess the client would like to keep it, but it is not being styled correctly in the ToC - some additional indent, no page number. i am not sure about the actual format of the index but it does appear at the end of the document, just not styled correctly in the ToC. additionally, i am not sure why the double byte space between the characters of 索 引 we are not doing that in any of the other headings, i think it should be removed.

plateau doc2 ToC

image

Note: the text "Annex B" showing in the entry for 附属書 B (規定) AnnexB 妥当な幾何オブジェクト is just some english text i will remove with a PR later.

if this is a document content issue please let me know and i will fix it. thanks

@ReesePlews ReesePlews added the question Further information is requested label Nov 27, 2024
@ReesePlews
Copy link
Contributor Author

i would like to inquire the status of this issue, if it is a document content issue that i can fix, or if there is something else? please let me know.

it is still visible in https://github.com/metanorma/mn-samples-plateau/actions/runs/12115563553

it was mentioned elsewhere that possibly the bibliography tag appeared twice in the document.

however in another project, using the IEEE flavor template, where the base document code was provided, the following appears:

clause 2:

[bibliography]
== Normative references

and
bibliography:

[appendix,obligation=informative]
== Bibliography

[bibliography]
=== Bibliography

and this IEEE document generates correctly.

i dont know if this matters or not, but i wanted to mention this.

thank you.

@ronaldtse ronaldtse added bug Something isn't working and removed question Further information is requested labels Dec 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

2 participants