Обсуждение: HTML/PDF Build Errors
Hello!
--
Came across a couple of errors when building HTML and PDF files with the Makefile.
System Info
CentOS 7
pdfTeX 3.1415926-2.5-1.40.14 (TeX Live 2013)
pgadmin4-3.2
HTML
(Relevant) Output:
$ make docs
...
`tablespace_dialog.rst:: WARNING: document isn't included in any toctree`
Adding it to ignore_patterns in conf.py results in:
Exception occurred:
File "/usr/lib/python2.7/site-packages/sphinx/builders/html.py", line 407, in get_doc_context
display_toc = (self.env.toc_num_entries[docname] > 1),
KeyError: 'tablespace_dialog'
Deleting it (obviously not the ideal solution) resolves the error and allows the files to be built as expected.
PDF
(Relevant) Output
$ make docs-pdf
...
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1phv.fd) [1{/usr/share/texlive
/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2]
Adding blank page after the table of contents.
pdfTeX warning (ext4): destination with the same identifier (name{page.i}) has
been already used, duplicate ignored
<to be read again>
\relax
l.113 \tableofcontents
[1]pdfTeX warning (ext4): destination with the same iden
tifier (name{page.ii}) has been already used, duplicate ignored
<to be read again>
\relax
l.113 \tableofcontents
[2] <logo-right-128.png, id=23, 128.48pt x 128.48pt>
<use logo-right-128.png> <use logo-right-128.png> [1 <./logo-right-128.png>]
[2]
Chapter 1.
! Use of \@icentercr doesn't match its definition.
<argument> \def
l.128 ...r{\index{Getting Started}Getting Started}
?
Have not found a workaround for the PDF issue as of yet.
Are these actual bugs or am I missing some kind of dependency?
Thanks very much for your time & help, ahead of time.
Sarah Conway Schnurr
Sarah Conway Schnurr <xenophenes42@gmail.com> writes:
> Came across a couple of errors when building HTML and PDF files with the
> Makefile.
Which PG version? (I assume 9.6 or older, because v10 and up don't use
TeX-based toolchain)
> Deleting it (obviously not the ideal solution) resolves the error and
> allows the files to be built as expected.
I"m confused about what you deleted, exactly?
> Are these actual bugs or am I missing some kind of dependency?
I'm guessing a dependency issue, but I don't know what it is exactly.
My experience with building these docs on Red Hat-based systems is
that if you install the "authoring and publishing" package set you're
good. I never tried to narrow down exactly what you need from that.
regards, tom lane
On Thu, Dec 20, 2018 at 7:07 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
Sarah Conway Schnurr <xenophenes42@gmail.com> writes:
> Came across a couple of errors when building HTML and PDF files with the
> Makefile.
Which PG version? (I assume 9.6 or older, because v10 and up don't use
TeX-based toolchain)
Er, well, I have PostgreSQL version 10.5 installed, but I'm not quite sure how this relates to building the documentation for pgAdmin4 version 3.2.
The Makefile commands being questioned are...
docs:
LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 $(MAKE) -C docs/en_US -f Makefile.sphinx html
docs-pdf:
LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 $(MAKE) -C docs/en_US -f Makefile.sphinx latexpdf
...which seem to only make use of pdflatex and sphinx-build, but please correct me if I'm wrong.
> Deleting it (obviously not the ideal solution) resolves the error and
> allows the files to be built as expected.
I"m confused about what you deleted, exactly?
The file that's throwing the error - tablespace_dialog.rst.
> Are these actual bugs or am I missing some kind of dependency?
I'm guessing a dependency issue, but I don't know what it is exactly.
My experience with building these docs on Red Hat-based systems is
that if you install the "authoring and publishing" package set you're
good. I never tried to narrow down exactly what you need from that.
I have all of these installed already (and more) trying to figure it out, unfortunately.
Sarah Conway Schnurr
Actually, I'm so sorry - tab-complete selected the wrong mailing list. My apologies for taking up your time.
On Thu, Dec 20, 2018 at 7:13 PM Sarah Conway Schnurr <xenophenes42@gmail.com> wrote:
On Thu, Dec 20, 2018 at 7:07 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:Sarah Conway Schnurr <xenophenes42@gmail.com> writes:
> Came across a couple of errors when building HTML and PDF files with the
> Makefile.
Which PG version? (I assume 9.6 or older, because v10 and up don't use
TeX-based toolchain)Er, well, I have PostgreSQL version 10.5 installed, but I'm not quite sure how this relates to building the documentation for pgAdmin4 version 3.2.The Makefile commands being questioned are...docs:LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 $(MAKE) -C docs/en_US -f Makefile.sphinx htmldocs-pdf:LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 $(MAKE) -C docs/en_US -f Makefile.sphinx latexpdf...which seem to only make use of pdflatex and sphinx-build, but please correct me if I'm wrong.> Deleting it (obviously not the ideal solution) resolves the error and
> allows the files to be built as expected.
I"m confused about what you deleted, exactly?The file that's throwing the error - tablespace_dialog.rst.> Are these actual bugs or am I missing some kind of dependency?
I'm guessing a dependency issue, but I don't know what it is exactly.
My experience with building these docs on Red Hat-based systems is
that if you install the "authoring and publishing" package set you're
good. I never tried to narrow down exactly what you need from that.I have all of these installed already (and more) trying to figure it out, unfortunately.--Sarah Conway Schnurr
Sarah Conway Schnurr