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

Developing web-offline and mobile app version of this book #2268

Closed
benedictjohannes opened this issue Feb 18, 2020 · 8 comments
Closed

Developing web-offline and mobile app version of this book #2268

benedictjohannes opened this issue Feb 18, 2020 · 8 comments

Comments

@benedictjohannes
Copy link

I would like to develop an open source application for this book, using Javascript toolchain aimed at mobile devices (using JS toolchain - considering GatsbyJS with Ionic) with periodically updated content tracking this repository. Would the book authors approve of another publishing medium of this book?

Disclaimer: I'm a Javascript dev, and have just start learning Rust. I've noted that the book is licensed under MIT, but I wouldn't publish anything without prior approval (for self use only). Might help with #1565 if successful.

@steveklabnik
Copy link
Member

I don't understand what exactly you're asking, to be honest.

@stappersg
Copy link
Contributor

@benedictjohannes web-offline is already available in rustup, verify with

rustup docs --book

And please be aware of previous update in this issue:

I don't understand what exactly you're asking, to be honest.

It says, in my words, please elaborate your idea.
Looking forward to further interaction.

@benedictjohannes
Copy link
Author

@stappersg Thank you for your reply.
While rustup docs --book works well on my machine, I'd want to build a mobile version of the book, packaged as Android app that can run offline using Gatsby and Ionic, as just another way to access the Rust book. I'd hope that the authors would allow me to (re)publish the content.

@stappersg
Copy link
Contributor

Ah, now i understand the wish. I'm not really a small screen person so I go to detach me from this issue.

A last thing I can do is requesting the labels enhancement and blocked upstream like #218 and #1565 already have.

@benedictjohannes
Copy link
Author

@stappersg I can understand that. I do my coding on my laptop, while reading/learning more on my phone, being with me more often than my laptop.
Apart of adding ease-of-access, I came up on the ide due to the code samples in the book being hard to read in mobile due to buttons obscuring the code samples. (screenshot below taken from https://doc.rust-lang.org/book/ch04-02-references-and-borrowing.html)

home_benedict rustup_toolchains_stable-x86_64-unknown-linux-gnu_share_doc_rust_html_book_ch04-02-references-and-borrowing html(Galaxy S5)

I do realize that some (minor) styling change can be achieved, enhancing mobile readibility of the book. If beneficial, I might be able to help with styling (I'm a JS/ web dev afterall, although not familiar with Rust HTML styling/templating sytem). Let me know if I can help.

@stappersg
Copy link
Contributor

Let me know if I can help.

That offer has been seen. Please re-state it at https://github.com/rust-lang/mdBook project.
Even better would be providing patches. (At other places have I learnt that tell me what to do is often recieved as seen the training request, no resources for that and even none for telling that. The trick is see the work that needs to done and then just do it.)

@benedictjohannes
Copy link
Author

@stappersg Thank you, I'll see what I can do.

@carols10cents
Copy link
Member

I'm going to close this: if you do end up developing such a mobile app, please mark it clearly as unofficial and not provided by the Rust project. Then it's fine with me!

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

4 participants