notice | this project has moved to a new home: git.s-ol.nu/mmm . This github archive will not be kept up-to-date. |
---|
mmm is not the www, because it runs on MoonScript.
live version at mmm.s-ol.nu.
This repo is roughly split into three parts:
mmm.dom
,mmm.component
: polymorphic Lua/Moonscript modules for web development. [code:mmm
- docs]mmmfs
: the CMS/FS powering mmm.s-ol.nu. [code:mmm/mmmfs
- article]- the page contents: includes my portfolio, blog, experiments...
authored using a mix of Moonscript, Markdown and HTML, thanks to the power of
mmmfs
. [data:root
, but you might want to read a bit about mmmfs before you jump in.]
You can run the interactive server (build/server.moon
):
$ moon build/server.moon fs
You can then view the website in your browser.
It should be availabe at https://localhost:8000
.
Alternatively, build/render_all.moon
can be used to generate a static HTML version of a tree:
$ moon build/render_all.moon fs output-dir /root/path
The /root/path/
argument is optional and needs to be set if the generated HTML will not be
served from the root /
of a server (which is assumed per default).
The fs
argument in the commands above specifies where and how the content is to be found.
The argument consists first of the type of storage,
and then optionally extra arguments separated by a colon (:
).
The following types are available:
fs:[path]
: load a directory from the filesystem. +path
is the path of the root directory, relative to the current directory. If omitted, defaults toroot
.sql:[path]
: load a SQLite3 database. +path
is the path to the sqlite database file. If omitted, defaults todb.sqlite3
.sql:MEMORY
: create an emptry in-memory SQLite3 database.
Required dependencies:
- MoonScript:
luarocks install moonscript
- lua-http:
luarocks install http
For unit tests:
- busted:
luarocks install busted
Not required but recommended:
- lua-sqlite3:
luarocks install sqlite3
(for SQLite3 backend) - lua-cjson:
luarocks install lua-cjson 2.1.0-1
(for server-side JSON support) - discount:
luarocks install discount
(requires libmarkdown2, for Markdown support) - luaposix:
luarocks install luaposix
(for SASS support)
entr is useful for reloading the realtime server when code outside the root
changes:
$ ls {build,mmm}/**.moon | entr -r moon build/server.moon fs