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

Issues I had with literate while trying to build your slides #3

Closed
alyssadev opened this issue Aug 1, 2022 · 5 comments
Closed

Issues I had with literate while trying to build your slides #3

alyssadev opened this issue Aug 1, 2022 · 5 comments

Comments

@alyssadev
Copy link

Hey there. First time doing anything at all with Rust, your videos came up in the ol recommended feed and they're very friendly and affirming, it's a great presentation style.
Did everything in your Rust lightsaber video, love neovide, thanks for the tip there. Tried to build your slides here, ran into issues with literate that could benefit from some notes in scripts/readme.md. The main ones being:

  • literate doesn't have docs on how to build the cli binary
  • cargo install wouldn't install literate without a Cargo.toml file which literate was meant to generate
  • after cloning the literate-rs repo and running cargo build and cargo install, it still didn't create the binary
  • eventually i ran cargo run and it said i needed to build it again with --features=cli, this wasn't documented anywhere upstream that i could find, maybe it's common knowledge among rust developers
  • once i ran cargo install --release --features=cli in the literate-rs directory, it was finally installed

i'm assuming the one command needed to get this to work in the first place was cargo install literate --features=cli. After this and installing cargo-script, which went smoothly, the rust lightsaber markdown document is now compiling via make build.

@alyssadev
Copy link
Author

And it's probably out of scope for this repo specifically and something best added to the literate-rs project in documentation, but I didn't want to commit the faux pas of assuming that something is a mistake in a new community and then to be told "oh no this is a completely normal thing that you've entirely misunderstood".

@0atman
Copy link
Owner

0atman commented Aug 26, 2022

Thank you very much for the reminder, I will update my readmes

@0atman
Copy link
Owner

0atman commented Aug 26, 2022

BTW I suspect I downloaded a precompiled binary https://github.com/misalcedo/literate-rs/releases/tag/v0.5.1

@0atman
Copy link
Owner

0atman commented Aug 27, 2022

From video 9 onwards I have much streamlined the process, apologies that I don't yet have time to retro-actively fix the old scripts

@0atman
Copy link
Owner

0atman commented Oct 3, 2022

Thank you for the issue.

@0atman 0atman closed this as completed Oct 3, 2022
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

No branches or pull requests

2 participants