odoo / odoo/documentation

PDF version of user docs

Open
#289 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

technical improvement technical question
Dominant language
reStructuredText
Stars
1.3k
Forks
12.1k
PR merge metrics
No merged PRs in 30d

Description

Is there a pdf version of the user docs? A while back I tried setting up latex and use the make latexpdf recipe on Debian Stretch with no success. Now i tried https://github.com/brechtm/rinohtype on Ubuntu 18.04 but that also fails. 'make singlehtml' also fails. make html works fine. Maybe Odoo SA just uses make html for the online docs. Are the other code paths tested, are they supposed to work? If they are and its not just me I'll post the outputs and the logs. For now I just trying to understand if its worth investing time in this.

Contributor guide

No contributing guide indexed for this repository

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 checking the documentation build configuration behind the make latexpdf, make singlehtml, and make html recipes on Debian Stretch and Ubuntu 18.04, then reproduce the reported failures and inspect their logs. Done means the PDF and single-page HTML paths are confirmed working or their failures are clearly documented; the issue names no file or test.

Written by the indexing model from the issue text.

Assessment

Tech stack
debian, latex, ubuntu
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.