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

[specification] PDF update #43

Merged
merged 3 commits into from
Dec 15, 2023
Merged

[specification] PDF update #43

merged 3 commits into from
Dec 15, 2023

Conversation

sameo
Copy link
Collaborator

@sameo sameo commented Nov 24, 2023

Update the PDF with all recently added sections.
Add an asciidoctor-pdf preprocessor for it to properly render mermaid diagrams.

@sameo sameo requested review from rsahita and jyao1 November 24, 2023 19:37
@jyao1
Copy link
Collaborator

jyao1 commented Nov 29, 2023

I am OK with the patch.

But, CI failed? @sameo

sameo added a commit to sameo/riscv-docs-base-container-image that referenced this pull request Dec 3, 2023
In order to include mermaid diagrams that are both github and asciidoc
compatible, we need to include the mermaid-cli package.

With that CLI, we can convert github mermaid diagrams on the fly, as
shown in riscv-non-isa/riscv-ap-tee-io#43

Signed-off-by: Samuel Ortiz <sameo@rivosinc.com>
@sameo
Copy link
Collaborator Author

sameo commented Dec 3, 2023

I am OK with the patch.

But, CI failed? @sameo

Yes, the container image used for building the PDF is missing the mermaid CLI. I opened a PR to fix this:
riscv/riscv-docs-base-container-image#4

@jyao1
Copy link
Collaborator

jyao1 commented Dec 5, 2023

@sameo , I approved it. Once the CI issue is resolved, you can merge it.

@rpsene
Copy link
Contributor

rpsene commented Dec 7, 2023

@sameo can you submit the PR again so it can run against the up to date build configuration?

sameo added 2 commits December 7, 2023 22:33
…agrams

In order for mermaid diagrams to render properly on both github and the
generated PDF, we need to preprocess the spec source and replace
[source,mermaid] occurences with [mermaid] ones.

Signed-off-by: Samuel Ortiz <sameo@rivosinc.com>
Signed-off-by: Samuel Ortiz <sameo@rivosinc.com>
@rpsene
Copy link
Contributor

rpsene commented Dec 7, 2023

@sameo let me check why the build fails.

@sameo
Copy link
Collaborator Author

sameo commented Dec 7, 2023

@sameo can you submit the PR again so it can run against the up to date build configuration?

@rpsene Unfortunately it seems to be failing still. I'll try to run it in the new container image and see if I can reproduce this error.

@rpsene
Copy link
Contributor

rpsene commented Dec 7, 2023

@sameo yes, I was following the build. I will debug it here locally now.

@rsahita
Copy link
Collaborator

rsahita commented Dec 8, 2023

👍 LGTM - hopefully the CI issues have resolved?

Until the container image is fixed.

Signed-off-by: Samuel Ortiz <sameo@rivosinc.com>
@sameo sameo merged commit e47aaff into riscv-non-isa:main Dec 15, 2023
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants