Mirror of forum.nim-lang.org

11501 :: Nim on the go: Smartphone, termux and ... "no" docs.

• take1234 (orginal) [2024-04-27T07:00:41+02:00] view original

  Hi,

  Each day I spend some time on the train and want to learn some Nim. :) For privacy reasons I keep my smartphone with Airplane mode ON when not strictly needed - so no internet. I installed Termux (kind of "Linux on a Smartphone") and in termux I installed Nim (of course).

  What missing is: documentation. Since "no internet" online browsing is not an option. Is documentation for learning Nim (I am a Nimbie...a newbie when it comes to Nim) somewhere available as PDF ... I didn't find any ... ?

  Cheers! Take1234

---

• thindil (orginal) [2024-04-27T08:11:41+02:00] view original

  If you can't find anything, you can create a PDF from an existing page in any modern browser, Chromium or Firefox based. In the printing dialog, select destination as "Save as PDF". Should work on smartphones and on desktops too. That's how I often read documentation on a smartphone. :)

---

• take1234 (orginal) [2024-04-27T09:19:59+02:00] view original

  Oh! That's good news. The package installer of Gentoo Linux just states nothing after the installation was finished. I will check, where the docs has been stored. For unknown reasons to me, I thought the docs were online only. Don't know, what the impression was...may be an dangling pointer or so.... ;)

  Any hint how to convert the html to pdf in a way that the "upside slim" format (16:9ish ?) is respected?

  Cheers! Take1234

---

• janAkali (orginal) [2024-04-27T14:04:20+02:00] view original

  You can install devdocs.io as a Progressive Web App in your phone's browser.

  I've tried it in firefox for Android, but chromium-based browsers should also work. It does work offline, just note that you should "enable" a documentation first and then download it from options.

---

• planetis (orginal) [2024-04-27T19:29:13+02:00] view original

  The doc generator has an option to ouput pdf files. Arch for example, used to generate them by default, but now it only installs the .md files under /usr/share/nim/doc/ . Which is another option I guess if you have a markdown reader.

---

• take1234 (orginal) [2024-04-28T20:08:26+02:00] view original

  Hi, Thanks to all for the input! :)

  Just found a way to avoid generating pdfs and get a "good as possible" formatting of the pages...the screen of a smartphone is not a 4k monitor, hehehehe ;)

  There two apps available on f-droid.org. Both are open source and you need not to create an account to download and install the apps. Easiest way to browse this "app store" is by downloading the droid-ify with a browser and install it. This is one of the f-droid clients. Then you need "FTP Sever (Free)" and "IWS" (which is a small and local webserver). Create a user name and password with the FTP server, start it and connect to your smartphone with ftp from the command line or with Putty. Upload the "doc" directory from the distribution to a folder of your liking on your phone. Stop the FTP Server (the is a notification, which can be user for that purpose. Start IWS and direct it to the directory of the "doc" folder, which contains the "index.html" file. The browser of IWS does not show files. The tap the "browser" button inside IWS and VOILA! :) There it is: The Nim doc in all its beauty formatted for the screen of your smartphone. Works on tablet also... :)

  Have fun! Cheers! Take1234

---

• warnersmith43 (orginal) [2024-05-15T09:06:32+02:00] view original

  That's a great idea to use your train commute time to learn Nim! While there isn't an official Nim documentation PDF, there are a couple of options to get you started learning Nim offline:

  1. Nim Manual
  2. Nim By Example

  Happy learning, Take1234!

---

• enthus1ast (orginal) [2024-05-17T20:58:38+02:00] view original

  That's basically how I learned nim (back in the days), during my train rides. It helped a ton that the whole nim docs + the manual where provided in the zip (I had no mobile internet back then). So I read through the manuals, the generated module docs, and then the stdlib source code. Good times

---

• ITwrx (orginal) [2024-05-18T19:01:00+02:00] view original

  IDK where, if anywhere, choosenim installs docs locally, so i downloaded some of the docs pages with commands like wget -r -np -l 1 -p -k https://nim-lang.org/docs/lib.html, which works, but for some reason the browser doesn't load the css file...

---

• enthus1ast (orginal) [2024-05-18T21:14:25+02:00] view original

  for me choosenim installed it there:

  /home/david/.choosenim/toolchains/nim-#devel/doc/html/

---

• warnersmith43 (orginal) [2024-05-20T11:48:41+02:00] view original

  That's a cool way to learn Nim! Especially impressive considering you didn't have mobile internet. Leveraging the offline resources like the docs and standard library source code sounds really effective.

  Nim's focus on readability and a clean syntax [1] probably made those resources easier to digest while on the train. Did you find the standard library source code to be well-written and helpful for learning the language?

---