https://github.com/ubavic/programming-in-haskell

Book on Haskell written in Haskell.
https://github.com/ubavic/programming-in-haskell

book functional-programming haskell

Last synced: 1 day ago
JSON representation

Book on Haskell written in Haskell.

• Host: GitHub
• URL: https://github.com/ubavic/programming-in-haskell
• Owner: ubavic
• Created: 2022-12-11T17:24:33.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-12-08T18:09:45.000Z (about 2 months ago)
• Last Synced: 2025-01-29T01:15:13.545Z (1 day ago)
• Topics: book, functional-programming, haskell
• Language: Haskell
• Homepage: https://haskel.ubavic.rs
• Size: 727 KB
• Stars: 6
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Programming in Haskell

This is repositorium for the *[Programiranje u Haskelu](https://haskel.ubavic.rs)*. The book is written in custom format `.atex` and compiled to `.html` via custom software written in Haskell.

*Programing in Haskell* is written on Serbian, and it is intended as an introductory text to Haskell programming.

Monorepo contains following packages:

+ `book`: text source for the book

+ `compiler`: compiler for `.atex` format

+ `vscode-atex`: VS Code extension for `.atex` format

+ `public`: JS, CSS and image files. Compiled html is placed here

## Build

In `compiler` directory run

```bash

cabal v2-run haskellBook.cabal -- "../book/" "../public/"

```

## Atex

Atex is a markup language that supports basic text formatting. It is inspired by the TeX, but unlike the TeX, in Atex commands start with the `@`. Hence the language name (`at + tex`).

Atex supports following commands:

 + Sectioning: `@chapter`, `@section`, `@subsection`

 + Block environments: `@codeBlock`, `@terminal`, `@example`, `@problem`, `@figure`, `@list`

 + Paragraph `@p` and list item `@li` environments

 + Markup: `@em` (emphasis), `@code` (inline Haskel code), `@pre` (general monospaced text) `@m` (inline math), `@eq` (block math), `@def` (term definition), `@url` (link), `@note` (sidenote), `@ref` (reference - not yet implemented).

 + Todo mark `@todo` - not rendered

Atex extension for VS Code adds support for syntax highlighting and set of snippets. The extension can be installed by copying `vscode-atex` directory to VSC settings directory:

```bash

cp vscode-atex/. ~/.vscode-oss/extensions/atex/ -r

```