aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fad71d3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+`GSP` (pronounced _gee ess pee_) is a transpiler to convert a nicer to write and
+more human-friendly syntax into valid HTML. Writing HTML can be made more
+bearable using things like Emmet, but it’s still not great, and the syntax is
+far too bloated, visually polluting your documents.
+
+`GSP` will never support templating or other useless features. If you need
+support for such things, just use a programming- or macro language such as
+Python or M4.
+
+## Why Not Use Pug or [INSERT LANGUAGE HERE]
+
+Simply put, they are all trash. Pug has decent syntax but requires you use
+JavaScript. All the others fall for the same kind of problem. As far as I
+could find, there is no pre-GSP transpiler from good syntax to HTML that works
+as just one binary you call on some files. All options force you into needing
+to write JavaScript/Ruby/etc. scripts, which just isn’t good enough.
+
+## Syntax Example
+
+```gsp
+html lang="en" {
+ head {
+ meta charset="UTF-8"
+ meta name="viewport" content="width=device-width, initial-scale=1.0"
+ link href="/favicon.svg" rel="shortcut icon" type="image/svg"
+ link href="/style.svg" rel="stylesheet"
+ title {-My Website Title}
+ }
+ body {
+ p #my-id {- This is a paragraph with the id ‘my-id’ }
+ p .my-cls {- This is a paragraph with the class ‘my-cls’ }
+
+ p
+ #some-id
+ .class-1
+ .class-2
+ key-1="value-1"
+ key-2 = "value-2"
+ {-
+ This paragraph has an ID, two classes, and two additional attributes. GSP
+ allows us to use the ‘#ident’ and ‘.ident’ syntaxes as shorthands for
+ applying IDs, and classes. This is a text node, so nothing is being
+ interpreted as GSP nodes, but we can include them inline if we want. As
+ an example, here is some @em {-emphatic} text. Your inline nodes can also
+ have attributes @em #id .cls {-just like a regular node}.
+ }
+ }
+}
+```
+
+## Why The Name GSP?
+
+I was originally inspired by Pug, but my dog is a GSP, not a pug.