search

riscv / docs-spec-template

https://lists.riscv.org/g/sig-documentation
Creative Commons Attribution 4.0 International
18 stars 19 forks source link

compress generated pdf #9

Closed jnk0le closed 9 months ago

jnk0le commented 1 year ago

I think it would be good if the riscv adoc documents were as small as the latex ones. Especially considering the fact that I often approach github repos/releases that download at less than 500kbps.

Currently the adoc unpriv is 8x the size of the latex one.

There is a simple -a compress command to put in a makefile, which in my case, yielded 314KiB document out of 1.2MiB. Didn't visibly affect build time.

There are also some external tools that claim to strip more.

rpsene commented 1 year ago

@wmat any suggestion here? We are using the compress instruction already.

wmat commented 1 year ago

I am looking into optimizing the output. There is asciidoctor-pdf extensions such as https://docs.asciidoctor.org/pdf-converter/latest/optimize-pdf/ that can be used. We'll test this out and see how effective it is.

On Thu, Apr 27, 2023 at 5:27 PM Rafael Sene @.***> wrote:

@wmat https://github.com/wmat any suggestion here? We are using the compress instruction already.

— Reply to this email directly, view it on GitHub https://github.com/riscv/docs-spec-template/issues/9#issuecomment-1526513723, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAAN6ZBZFY6XNCGLQORUMETXDLQFNANCNFSM6AAAAAAUJXEBLM . You are receiving this because you were mentioned.Message ID: @.***>

rpsene commented 9 months ago

The asciidoc compression parameter is already in place https://github.com/riscv/docs-spec-template/blob/main/Makefile#L26.