public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Mauro Carvalho Chehab <mchehab@s-opensource.com>
To: Jim Davis <jim.epost@gmail.com>
Cc: Markus Heiser <markus.heiser@darmarit.de>,
	Linux Doc Mailing List <linux-doc@vger.kernel.org>,
	Mauro Carvalho Chehab <mchehab@infradead.org>,
	linux-kernel <linux-kernel@vger.kernel.org>,
	Jonathan Corbet <corbet@lwn.net>
Subject: Re: [PATCH RFC] scripts/sphinx-pre-install: add a script to check Sphinx install
Date: Fri, 14 Jul 2017 22:27:37 -0300	[thread overview]
Message-ID: <20170714222737.39f489c1@vento.lan> (raw)
In-Reply-To: <CA+r1ZhgBL8HGTEgKhA_fSkvViFc7B-KjwsO+JBb0xsLBZOn3fA@mail.gmail.com>

Em Fri, 14 Jul 2017 15:51:03 -0700
Jim Davis <jim.epost@gmail.com> escreveu:

> On Fri, Jul 14, 2017 at 10:35 AM, Markus Heiser
> <markus.heiser@darmarit.de> wrote:
> >
> >
> > Ok, this won't solve TeX installation problems of Linux distros,  
> 
> Which seems to be the thorniest problem.  It's one thing to identify
> which sphinx versions work, and another to figure out which of the
> metric boatload of TeX packages are needed.

Yes. That's likely the hardest part.

> On a fresh Fedora 26 install I was able to get "make pdfdocs" to build
> (hurrah!) after adding

Just sent a version 2 of the script, with support for Fedora 26.

I tested with a Fedora lxc container. The only package I had to manually
install there is perl. I'm pretty sure that a minimal Fedora image
(outside a LXC) already comes with perl, so I guess the script is
an improvement over manually checking all needed dependencies.

> ImageMagick
> latex
> sphinx-build
> texlive-adjustbox
> texlive-babel-english
> texlive-capt-of
> texlive-cm
> texlive-cmap
> texlive-ec
> texlive-eqparbox
> texlive-euenc
> texlive-fancyhdr
> texlive-fncychap
> texlive-framed
> texlive-hyphen-base
> texlive-mdwtools
> texlive-multirow
> texlive-parskip
> texlive-tablefootnote
> texlive-tabulary
> texlive-threeparttable
> texlive-titlesec
> texlive-unicode-data
> texlive-upquote
> texlive-wrapfig
> xelatex

There is a package called "python-sphinx-latex" that seems to install
almost everything needed for Fedora 26. This one, plus:
	xelatex
	texlive-adjustbox

It also optionally require DeJavu fonts.

are enough for PDF build. You still need:
	ImageMagick
	graphviz

for both html and pdf targets, if you want to have support for
images.
 
> which ended up installing about 160 RPMs.  Figuring out the right
> texlive parts wasn't much fun; footnote.sty is well-hidden in
> texlive-mdwtools, for instance, and without texlive-babel-english the
> build failed with very mysterious errors in userspace-api.

Yeah, that's why I think the right solution is to have a script that
will identify the distribution and install the missing dependencies.

Thanks,
Mauro

  reply	other threads:[~2017-07-15  1:27 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-07-14 16:49 [PATCH RFC] scripts/sphinx-pre-install: add a script to check Sphinx install Mauro Carvalho Chehab
2017-07-14 17:35 ` Markus Heiser
2017-07-14 22:51   ` Jim Davis
2017-07-15  1:27     ` Mauro Carvalho Chehab [this message]
2017-07-15  2:21   ` Mauro Carvalho Chehab
2017-07-15  9:51     ` Markus Heiser
2017-07-15 12:49       ` Mauro Carvalho Chehab
2017-07-15 12:55         ` Mauro Carvalho Chehab
2017-07-15 19:27           ` Mauro Carvalho Chehab
2017-07-16  7:29         ` Markus Heiser
2017-07-16  9:57           ` Mauro Carvalho Chehab

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20170714222737.39f489c1@vento.lan \
    --to=mchehab@s-opensource.com \
    --cc=corbet@lwn.net \
    --cc=jim.epost@gmail.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=markus.heiser@darmarit.de \
    --cc=mchehab@infradead.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox