o1-labs/ocamlbyexample

Learn Ocaml by reading code examples

OCaml

76

117 commits

updated Dec 13, 2022

See the code

README

Ocaml By Example

Screen Shot 2021-06-02 at 9 48 58 PM

Learn the OCaml language, following a series of examples!

You can visit the rendered course here: https://o1-labs.github.io/ocamlbyexample/.

This page is inspired by https://gobyexample.com.

Adding your own examples (chapters)

Create a folder in book/chapters/ (using another example), then add your chapter in book/chapters.json.

Some guidelines:

  1. short examples are best
  2. one chapter teaches one concept well
  3. one block of explanation teaches one subconcept well
  4. a concept is always introduced and explained the first time it is being used in an example

How to render the webpage locally

You need the OCaml language setup. Once you've set up OCaml you can install the dependencies needed by the project with:

make deps

Then simply run:

make

or to automatically update the website as you change files:

make watch

Can I use this for another programming language?

Yes, while the code is written in OCaml you can use it to build similar webpages for any programming language (although syntax highlighting will only work for languages supported by highlight.js).

So feel free to fork this page and use to teach your own stuff!

dune
examples
examples-ocaml
ocaml
opam
utop

Contributors

mimoo

113 commits

jspada

3 commits

graphite-org

1 commits

o1-labs/ocamlbyexample

Learn Ocaml by reading code examples

OCaml

76

117 commits

updated Dec 13, 2022

See the code

README

Ocaml By Example

Screen Shot 2021-06-02 at 9 48 58 PM

Learn the OCaml language, following a series of examples!

You can visit the rendered course here: https://o1-labs.github.io/ocamlbyexample/.

This page is inspired by https://gobyexample.com.

Adding your own examples (chapters)

Create a folder in book/chapters/ (using another example), then add your chapter in book/chapters.json.

Some guidelines:

  1. short examples are best
  2. one chapter teaches one concept well
  3. one block of explanation teaches one subconcept well
  4. a concept is always introduced and explained the first time it is being used in an example

How to render the webpage locally

You need the OCaml language setup. Once you've set up OCaml you can install the dependencies needed by the project with:

make deps

Then simply run:

make

or to automatically update the website as you change files:

make watch

Can I use this for another programming language?

Yes, while the code is written in OCaml you can use it to build similar webpages for any programming language (although syntax highlighting will only work for languages supported by highlight.js).

So feel free to fork this page and use to teach your own stuff!

dune
examples
examples-ocaml
ocaml
opam
utop

Contributors

mimoo

113 commits

jspada

3 commits

graphite-org

1 commits

Languages

OCaml

42.9%

HTML

26.5%

CSS

22.2%

JavaScript

5.1%

Rust

2.9%