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

Use asciidoctor and asciidoctor-pdf as dependencies #25

Conversation

ggrossetie
Copy link
Collaborator

@ggrossetie ggrossetie commented Oct 29, 2019

If you want to give it a try on your machine.

  1. Remove the node_modules
  2. npm i
  3. npm run generate (or ./generate.sh)

resolves #24

src/quarkus-cheat-sheet/quarkus-cheat-sheet.html Outdated Show resolved Hide resolved
src/quarkus-cheat-sheet/quarkus-cheat-sheet.html Outdated Show resolved Hide resolved
src/quarkus-cheat-sheet/quarkus-cheat-sheet.html Outdated Show resolved Hide resolved
@lordofthejars
Copy link
Owner

lordofthejars commented Oct 29, 2019 via email

@ggrossetie
Copy link
Collaborator Author

ggrossetie commented Oct 30, 2019

The thing is that the html page should be published in GH pages, so no
absolute paths should be added

I think you want to publish the HTML page of the cheat sheet using the default HTML 5 converter from Asciidoctor core right?

The HTML page produced by Asciidoctor PDF (JS) will not be easy to read because the content won't be split by pages. In fact, the content will content will fill the first column until the bottom of the document (so you will have to scroll all the way down to read the first column, then go back to the top of the page for the second column, and again for the third column).

The HTML file generated by Asciidoctor PDF (JS) is designed to be a transient state. If it was possible to generate a PDF without writing an HTML file on the disk I would have done that.
Nothing is set in stone though. If this file is useful we can continue to write it on disk.

Anyway I don't want to disrupt too much things at once, so I will revert this change.

@lordofthejars
Copy link
Owner

I completely agree with you, I think that waiting a bit of time and see how all these changes go for now it is a good strategy.

@ggrossetie ggrossetie force-pushed the issue-24-asciidoctor-dependency branch from 5543d3b to cf4494b Compare October 30, 2019 10:06
@ggrossetie ggrossetie closed this Aug 27, 2020
@ggrossetie ggrossetie deleted the issue-24-asciidoctor-dependency branch August 27, 2020 09:14
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.

Use Asciidoctor PDF (JS) as a dependency
2 participants