pg.ddx.io pgsql-admin@postgresql.org mailing list archive
help / color / mirror / Atom feedHTML/PDF Build Errors
4+ messages / 2 participants
[nested] [flat]
* HTML/PDF Build Errors
@ 2018-12-21 01:32 Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:07 ` Re: HTML/PDF Build Errors Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 4+ messages in thread
From: Sarah Conway Schnurr @ 2018-12-21 01:32 UTC (permalink / raw)
To: pgsql-admin@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: HTML/PDF Build Errors
2018-12-21 01:32 HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
@ 2018-12-21 03:07 ` Tom Lane <tgl@sss.pgh.pa.us>
2018-12-21 03:13 ` Re: HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: Tom Lane @ 2018-12-21 03:07 UTC (permalink / raw)
To: Sarah Conway Schnurr <xenophenes42@gmail.com>; +Cc: pgsql-admin@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: HTML/PDF Build Errors
2018-12-21 01:32 HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:07 ` Re: HTML/PDF Build Errors Tom Lane <tgl@sss.pgh.pa.us>
@ 2018-12-21 03:13 ` Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:14 ` Re: HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: Sarah Conway Schnurr @ 2018-12-21 03:13 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-admin@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: HTML/PDF Build Errors
2018-12-21 01:32 HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:07 ` Re: HTML/PDF Build Errors Tom Lane <tgl@sss.pgh.pa.us>
2018-12-21 03:13 ` Re: HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
@ 2018-12-21 03:14 ` Sarah Conway Schnurr <xenophenes42@gmail.com>
0 siblings, 0 replies; 4+ messages in thread
From: Sarah Conway Schnurr @ 2018-12-21 03:14 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-admin@lists.postgresql.org
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 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
>
--
Sarah Conway Schnurr
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2018-12-21 03:14 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-12-21 01:32 HTML/PDF Build Errors Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:07 ` Tom Lane <tgl@sss.pgh.pa.us>
2018-12-21 03:13 ` Sarah Conway Schnurr <xenophenes42@gmail.com>
2018-12-21 03:14 ` Sarah Conway Schnurr <xenophenes42@gmail.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox