# Is there an online version of the Sonic Pi language reference?

**URL:** <https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182>\
**Category:** \[P\] Patreon Support\
**Created:** [October 6, 2017, 4:05am UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182 "2017-10-06T04:05:15Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![scossar](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/scossar/32/937_2.png) [@scossar](https://in-thread.sonic-pi.net/u/scossar)\
**Post date:** [October 6, 2017, 4:05am UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/1 "2017-10-06T04:05:15Z")

</div>

I’m using Sonic Pi on a Raspberry Pi - controlling it with emacs and the sonic-pi-tool. It would be great to be able to view the language reference files that are available in the Sonic Pi GUI. Are they available anywhere online?

---

<div class="post-metadata">

**Author:** ![robin.newman](https://avatars.discourse-cdn.com/v4/letter/r/76d3ee/32.png) [@robin.newman](https://in-thread.sonic-pi.net/u/robin.newman)\
**Post date:** [October 6, 2017, 10:39am UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/2 "2017-10-06T10:39:50Z")

</div>

I have seen one or two posted before. It is possible to produce the documentation from the build process for Sonic PI fairly easily. The documents are all in html format. I can easily post a version IF @samaaron is in agreement. The potentital is that various versions get around which become out of date, and the html files do not obviously include the version information which is generated elsewhere in Sonic Pi.

---

<div class="post-metadata">

**Author:** ![scossar](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/scossar/32/937_2.png) [@scossar](https://in-thread.sonic-pi.net/u/scossar)\
**Post date:** [October 6, 2017, 5:33pm UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/3 "2017-10-06T17:33:05Z")

</div>

> [@robin.newman](#):
>
> The documents are all in html format.

If I could find them in the source code, that would be a good enough solution. What I’m looking for is the content of the Synths, Fx, Samples, and Lang tabs from the GUI.

---

<div class="post-metadata">

**Author:** ![kniknoo](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/kniknoo/32/146_2.png) [@kniknoo](https://in-thread.sonic-pi.net/u/kniknoo)\
**Post date:** [October 6, 2017, 5:42pm UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/4 "2017-10-06T17:42:57Z")

</div>

I’ve been on this very hunt before. I’d super appreciate having the full reference easily available online.

---

<div class="post-metadata">

**Author:** ![robin.newman](https://avatars.discourse-cdn.com/v4/letter/r/76d3ee/32.png) [@robin.newman](https://in-thread.sonic-pi.net/u/robin.newman)\
**Post date:** [October 6, 2017, 6:13pm UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/5 "2017-10-06T18:13:53Z")

</div>

They are generated during the build process. You would need to have a compiler installed (on a Mac use Xcode to do this), also ruby (I used ruby-2.4.1) and would have to run the following sections of the build process.  
download the Sonic Pi source from github to a suitable location using  
git clone [https://github.com/samaaron/sonic-pi.git](https://github.com/samaaron/sonic-pi.git)  
(This installs a folder sonic-pi containing the source code)  
cd sonic-pi/app/gui/qt  
…/…/server/bin/compile-extensions.rb  
…/…/server/bin/i18n-tool.rb -t  
cp -f ruby\_help.tmpl ruby\_help.h  
…/…/server/bin/qt-doc.rb -o ruby\_help.h

(You can see a reasonably recent complete install script I have used for Mac [here](https://github.com/samaaron/sonic-pi/issues/1629)

You will find a folder book has been created in the qt folder. This contains the html files to run the variouls sections of documentation eg  
Sonic Pi - Examples.html  
Sonic Pi - Fx.html  
Sonic Pi - Lang.htmll  
Sonic Pi - Samples.html  
Sonic Pi - Synths.html

It also uses a folder theme which is also in the qt folder.

---

<div class="post-metadata">

**Author:** ![samaaron](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/samaaron/32/7_2.png) [@samaaron](https://in-thread.sonic-pi.net/u/samaaron)\
**Post date:** [October 6, 2017, 6:44pm UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/6 "2017-10-06T18:44:36Z")

</div>

I’m planning to release a polished full ‘book’ PDF some point in the short/medium term - so please hold in there. For now, you can access all the raw markdown files here: [https://github.com/samaaron/sonic-pi/tree/master/etc/doc/tutorial](https://github.com/samaaron/sonic-pi/tree/master/etc/doc/tutorial)

---

<div class="post-metadata">

**Author:** ![samaaron](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/samaaron/32/7_2.png) [@samaaron](https://in-thread.sonic-pi.net/u/samaaron)\
**Post date:** [April 28, 2018, 11:42pm UTC](https://in-thread.sonic-pi.net/t/is-there-an-online-version-of-the-sonic-pi-language-reference/182/7 "2018-04-28T23:42:25Z")

</div>

The tutorial is now available to read in your browser here: [https://sonic-pi.net/tutorial](https://sonic-pi.net/tutorial)
