python / python/devguide

`make dist-pdf` doesn't work, had to use different method

Open
#1,836 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

topic-documentation type-bug
Dominant language
Python
Stars
2.1k
Forks
1k
Avg merge
2d 12h
Merged PRs (30d)
12

Description

Documentation

Hello, found out about this page here, so I'd like to point this out.

The steps I had to use to get it to work were

make venv
make latex

cd build/latex

for i in $(find -name '*.tex')
do xelatex "$i"
done

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the documented make dist-pdf path, then compare the make venv, make latex, and build/latex steps reported here. Inspect the Makefile targets and the documentation linked in the issue; done means the PDF-building instructions or target accurately reflect a working method.

Written by the indexing model from the issue text.

Assessment

Tech stack
latex, python
Domain
build-system, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.