Help needed to diagnose RST problem
I have been doing PG donations using the RST format for many years and have encountered and fixed the "Title level inconsistent:" problem MANY times but my latest file is giving me this for no obvious reason. I'm hoping that one of you can see what I'm missing. My RST files all use this underline format for the headings: ============= for the title ----------------------- for h1 `````````````````````` for h2 This is consistent with what the PG footer uses and has NEVER caused problems in the past. An example of where I've used it successfully is here: https://dev.gutenberg.org/files/64046/ The situation where I generally get the error is if I try to add a fourth level. I've learned not to do that. The attached file uses exactly the same convention and fails. Works just fine with no PG footer directive, fails with *Title level inconsistent *once you add that directive. The TOC shows the levels I would expect to get. I have tried removing the ``````` level underlining and that changes the error reported (different character reported as not in list, ` instead of =) ValueError: '=' is not in list but it still fails. Removing the ---- as well doesn't fail but of course you have no headings https://ebookmaker.pglaf.org/cache/20201229095936/ is my latest attempt to run this. The RST file is attached. Thanks. James Simmons
Gutenberg Volunters: I decided to try to make the smallest RST file that can recreate the problem. The attachment is pretty close to that. I found that the Appendix chapter seems to be causing the problem. Not sure why as it has only one heading, nothing unusual about it, but if you get rid of the Appendix the files get created OK and if you have it in they don't. James Simmons On Tue, Dec 29, 2020 at 1:10 PM James Simmons <nicestep@gmail.com> wrote:
I have been doing PG donations using the RST format for many years and have encountered and fixed the "Title level inconsistent:" problem MANY times but my latest file is giving me this for no obvious reason. I'm hoping that one of you can see what I'm missing.
My RST files all use this underline format for the headings:
============= for the title ----------------------- for h1 `````````````````````` for h2
This is consistent with what the PG footer uses and has NEVER caused problems in the past. An example of where I've used it successfully is here:
https://dev.gutenberg.org/files/64046/
The situation where I generally get the error is if I try to add a fourth level. I've learned not to do that.
The attached file uses exactly the same convention and fails. Works just fine with no PG footer directive, fails with *Title level inconsistent *once you add that directive. The TOC shows the levels I would expect to get.
I have tried removing the ``````` level underlining and that changes the error reported (different character reported as not in list, ` instead of =)
ValueError: '=' is not in list
but it still fails. Removing the ---- as well doesn't fail but of course you have no headings
https://ebookmaker.pglaf.org/cache/20201229095936/
is my latest attempt to run this. The RST file is attached.
Thanks.
James Simmons
PG's headers and footers (text and HTML) have been revised for assorted reasons. I tried James' small test file and got a massive error output. Forwarded its first and last few lines to PG's software people and got this back: Ebookmaker adds headers to RST files, but the new headers are not in the latest ebookmaker release. I wasn't given an ETA. Al From: gutvol-d <gutvol-d-bounces@lists.pglaf.org> On Behalf Of James Simmons Sent: December 29, 2020 2:37 PM To: Gutenberg Volunteers <gutvol-d@lists.pglaf.org> Subject: Re: [gutvol-d] Help needed to diagnose RST problem Gutenberg Volunters: I decided to try to make the smallest RST file that can recreate the problem. The attachment is pretty close to that. I found that the Appendix chapter seems to be causing the problem. Not sure why as it has only one heading, nothing unusual about it, but if you get rid of the Appendix the files get created OK and if you have it in they don't. James Simmons On Tue, Dec 29, 2020 at 1:10 PM James Simmons <nicestep@gmail.com <mailto:nicestep@gmail.com> > wrote: I have been doing PG donations using the RST format for many years and have encountered and fixed the "Title level inconsistent:" problem MANY times but my latest file is giving me this for no obvious reason. I'm hoping that one of you can see what I'm missing. My RST files all use this underline format for the headings: ============= for the title ----------------------- for h1 `````````````````````` for h2 This is consistent with what the PG footer uses and has NEVER caused problems in the past. An example of where I've used it successfully is here: https://dev.gutenberg.org/files/64046/ The situation where I generally get the error is if I try to add a fourth level. I've learned not to do that. The attached file uses exactly the same convention and fails. Works just fine with no PG footer directive, fails with Title level inconsistent once you add that directive. The TOC shows the levels I would expect to get. I have tried removing the ``````` level underlining and that changes the error reported (different character reported as not in list, ` instead of =) ValueError: '=' is not in list but it still fails. Removing the ---- as well doesn't fail but of course you have no headings https://ebookmaker.pglaf.org/cache/20201229095936/ is my latest attempt to run this. The RST file is attached. Thanks. James Simmons
Gutenberg Volunteers: *I came up with a fix*. It turns out that if you have a chapter heading in your RST file that looks like this: APPENDIX -------- plus the PG footer directive this causes Ebookmaker to break. No idea why. The word appendix does not appear in the PG footer. I was able to work around this problem by styling the word APPENDIX like this: .. clearpage:: .. container:: center x-large **APPENDIX.** .. vspace:: 1 This isn't a proper heading, so it doesn't appear in the table of contents, but I think we can live with that. Thanks to everyone that looked at this. James Simmons On Tue, Dec 29, 2020 at 4:37 PM James Simmons <nicestep@gmail.com> wrote:
Gutenberg Volunters:
I decided to try to make the smallest RST file that can recreate the problem. The attachment is pretty close to that. I found that the Appendix chapter seems to be causing the problem. Not sure why as it has only one heading, nothing unusual about it, but if you get rid of the Appendix the files get created OK and if you have it in they don't.
James Simmons
On Tue, Dec 29, 2020 at 1:10 PM James Simmons <nicestep@gmail.com> wrote:
I have been doing PG donations using the RST format for many years and have encountered and fixed the "Title level inconsistent:" problem MANY times but my latest file is giving me this for no obvious reason. I'm hoping that one of you can see what I'm missing.
My RST files all use this underline format for the headings:
============= for the title ----------------------- for h1 `````````````````````` for h2
This is consistent with what the PG footer uses and has NEVER caused problems in the past. An example of where I've used it successfully is here:
https://dev.gutenberg.org/files/64046/
The situation where I generally get the error is if I try to add a fourth level. I've learned not to do that.
The attached file uses exactly the same convention and fails. Works just fine with no PG footer directive, fails with *Title level inconsistent *once you add that directive. The TOC shows the levels I would expect to get.
I have tried removing the ``````` level underlining and that changes the error reported (different character reported as not in list, ` instead of =)
ValueError: '=' is not in list
but it still fails. Removing the ---- as well doesn't fail but of course you have no headings
https://ebookmaker.pglaf.org/cache/20201229095936/
is my latest attempt to run this. The RST file is attached.
Thanks.
James Simmons
participants (2)
-
ajhaines -
James Simmons