Polyglot: A Guide for Building Websites With Any Language

8.6

Polyglot: A Guide for Building Websites With Any Language

Sage Gerard

This document serves as an introduction to Polyglot, a tool that runs programs within tagged X-expressions to build powerful websites.

This guide explains why Polyglot is different, and how to get started using its built-in conveniences. Once you’re ready, you can read the API Reference, and learn new tricks from tutorials and how-tos.

1 Why Another Web Development... Thing?!

2 Get Started

2.1 Step 1: Start Your Project

2.2 Step 2: Write Content

2.3 Step 3: Publish

2.4 So What?

3 Racket in Markdown

3.1 Application Elements

3.2 Library Elements

3.3 Accessing Shared Content

3.4 Addendum: Avoid Leaving XML in HTML5

4 The Base Workflow

4.1 Markdown Handling (".md")

4.2 Racket Module Handling (".rkt")

4.3 CSS Handling (".css")

4.4 Literal Path Handling (".literal")

4.5 Default File Handling

5 The Imperative Workflow

5.1 Imperative App and Library Elements

5.1.1 Setting a Page Layout

5.2 Page Macros and Preprocessing

5.2.1 Replace elements using data-macro

5.2.2 Pre-processing

6 The Functional Workflow

6.1 Multiple App Elements

6.2 In-Place Replacements

6.3 Pre-processing and Post-processing

7 Now What?

1	Why Another Web Development... Thing?!
2	Get Started
3	Racket in Markdown
4	The Base Workflow
5	The Imperative Workflow
6	The Functional Workflow
7	Now What?