Our Open Bookshelf books aren't available in pdf or any e-book format for the following reasons:
Toolchain. Producing readable and well-formatted books on all the various formats would require that we use a more sophisticated toolchain, along the lines that book publishers use. This adds more complexity to our process, which impedes publishing velocity.
Frequent updates. We're constantly updating them with small fixes and tweaks. If we re-generate e-book versions after every fix, that means readers could be reading many different versions at any point in time. We want to avoid this problem and just have one master copy that's online.
Media and links. We consider these natively online books and want to use the full features of webpages in them, including videos and links to other resources. This isn't possible for offline media.
This conversation with LSBot is temporary.
Sign up for free
to save your conversations with LSBot.
Hi! I'm LSBot. I'm here to help you understand this chapter content with fast, focused answers.
Ask me about concepts, examples, or anything you'd like clarified from this chapter. I can explain complex topics, provide examples, or help connect ideas.
You can write code blocks using three backticks (```) followed by the language you want to show.
For instance, if you wanted to write a Ruby code block you would write:
```ruby
class Foo
end
```
class Foo
end
You can also leave out the language identifier, doing this will make it so your code isn't highlighted at all, and all text will be white with no coloring.
```
class Bar
end
```
class Bar
end
Highlighting
You may highlight lines within your code blocks. This is a different type of highlighting, and isn't related to how the code within your code block may be colored depending on the language identifier used.
To highlight one or more lines of code, add # highlight on a separate line just before the first line you wish to highlight. To end highlighting, add # endhighlight on a separate line immediately after the last line you wish to highlight.