https://github.com/marijnh/Eloquent-JavaScript

The sources for the Eloquent JavaScript book
https://github.com/marijnh/Eloquent-JavaScript

Last synced: 3 months ago
JSON representation

The sources for the Eloquent JavaScript book

• Host: GitHub
• URL: https://github.com/marijnh/Eloquent-JavaScript
• Owner: marijnh
• Created: 2013-09-30T13:40:20.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-05-22T15:54:14.000Z (6 months ago)
• Last Synced: 2024-05-22T17:01:12.158Z (6 months ago)
• Language: JavaScript
• Homepage: https://eloquentjavascript.net
• Size: 20.3 MB
• Stars: 2,981
• Watchers: 140
• Forks: 786
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Eloquent JavaScript

These are the sources used to build the third edition of Eloquent

JavaScript (https://eloquentjavascript.net).

Feedback welcome, in the form of issues and pull requests.

## Building

This builds the HTML output in `html/`, where `make` is GNU make:

    npm install

    make html

To build the PDF file (don't bother trying this unless you really need

it, since this list has probably bitrotted again and getting all this

set up is a pain):

    apt-get install texlive texlive-xetex fonts-inconsolata fonts-symbola texlive-lang-chinese inkscape

    make book.pdf

## Translating

Translations are very much welcome. The license this book is published

under allows non-commercial derivations, which includes open

translations. If you do one, let me know, and I'll add a link to the

website.

A note of caution though: This text consists of about 130 000 words,

the paper book is 400 pages. That's a lot of text, which will take a

lot of time to translate.

If that doesn't scare you off, the recommended way to go about a

translation is:

 - Fork this repository on GitHub.

 - Create an issue on the repository describing your plan to translate.

 - Translate the `.md` files in your fork. These are

   [CommonMark](https://commonmark.org/) formatted, with a few

   extensions. You may consider omitting the index terms (indicated

   with double parentheses and `{{index ...}}` syntax) from your

   translation, since that's mostly relevant for print output.

 - Publish somewhere online or ask me to host the result.

Doing this in public, and creating an issue that links to your work,

helps avoid wasted effort, where multiple people start a translation

to the same language (and possibly never finish it). (Since

translations have to retain the license, it is okay to pick up someone

else's translation and continue it, even when they have vanished from

the internet.)