Goals

Self-contained; all you need is some sort of POSIX OS and Lua. No LuaRocks, no need to compile additional libraries.
Offline first. Hosting on the internet is optional; the primary supported way to use this data is locally.
Git is merely the means of distribution of the data. In particular, don't rely on the commit hashes being immutable.

Steps

Download and unzip a Slack archive to some directory, say input/.
Generate a list of files inside all channels:
```
ls input/*/*.json > file_list
```
Generate html for file_list into directory output/:
```
rm -rf output  # clear output
lua generate_html.lua input/channels.json input/users.json file_list output
```
Tested with Lua 5.1, 5.2, 5.3, 5.4.

Does not work with filenames with strange characters like spaces, but Slack exports seem well-behaved so far.

Will not perform any operations outside of file operations, and will not perform file operations to anything outside of file_list and output/.

FAQ

Q: Why did you invent a whole new URL format?

Since this is a statically generated website, I can't use query parameters containing ? and &. There are redirects to minimize the changes needed. Just turn:

https://futureofcoding.slack.com/archives/C5T9GPWFL/p1653663004176149

into something like:

        http://akkartik.name/archives/foc/C5T9GPWFL/p1653663004176149.html

and it'll redirect you to the right page.

Q: How do I search?

Use Github search

Q: Is there a way to look up people's introductions?

Create a bookmark with this Javascript:

javascript:window.open('http://akkartik.name/archives/foc/introduce-yourself/'+((window.getSelection() != '' ? window.getSelection().toString() : prompt('Please enter a name (case sensitive)')).trim().replaceAll(/[^\w_.~-]/g, '-'))+'.html');undefined

akkartik/foc-archive

Goals

Steps

FAQ