Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

LaTeX publisher #545

Merged
merged 88 commits into from
Mar 2, 2022
Merged

LaTeX publisher #545

merged 88 commits into from
Mar 2, 2022

Conversation

neerdoc
Copy link
Collaborator

@neerdoc neerdoc commented Mar 2, 2022

After reviewing doorstop for a number of years at different companies I have always gotten stuck on the fact that there is no native publisher for LaTeX. Sure, it is possible to go through pandoc, but the results have been less that satisfactory.

So, I have finally decided to write a LaTeX-publisher for doorstop and I hope that it should fulfill everyone's needs.

I have included a simple template for LaTeX so it should be very easy to create nice and customized PDF:s directly from doorstop, so the need for the first part of #295 should be more or less gone. It should also take care of #166 for anyone that is willing to use LaTeX, as changing the existing template or using a company-template is quite straightforward.

I have also included LaTeX-packages to allow linking both inside documents and between documents, so that the produced PDFs have a traceability matrix at the end of the document that is clickable even to other documents. Each link to child and parent items are also clickable.

In the same spirit of having a fully customizable template that generates PDFs of high quality with linking between documents, this PR might be useful for the issues #515 and #314.

I have taken care to create a complete test suite for the LaTeX-functionality, tested on Linux and Mac OS X, and as far as I can see no other tests have broken either.

Copy link
Member

@jacebrowning jacebrowning left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work on this! It looks like the only failures are in the output "diff" tests, which I think we can remove because they're not providing a useful failure signal. I'll get a beta release ready so folks can start exploring this feature.

@jacebrowning jacebrowning merged commit 3dfc07d into doorstop-dev:develop Mar 2, 2022
@jacebrowning
Copy link
Member

This feature is available here: https://pypi.org/project/doorstop/3.0b1/

@neerdoc neerdoc added this to the v2.3 milestone Mar 9, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants