Web Architecture for Unix Lovers

### [@schmonz](https://twitter.com/schmonz)
]

---

### [@schmonz](https://twitter.com/schmonz)
]

---

# Web Architecture for Unix Lovers

## Amitai Schlair

### PillarCon 2016/04/15

???

These are presenter notes.
Press 'C' to clone, then 'P' to show these notes.

---

> <a href="../../../../../../2013/05/27/remembering-textpattern/">the  Unix of web CMSes  (orthogonal and composable, with the concomitant learning curve) and a  web CMS for Unix  (files in the filesystem, real revision control)</a>

### Build a site.

### Your server doesn't need a database.

### It might not even need ikiwiki.
]

---

<img src="../1-ikiwiki.info.png" width="600" height="375" alt="screenshot of ikiwiki.info" class="img" />
]

---

### A wiki

- Style: <a href="http://ikiwiki.info/themes/">the "anti-theme"</a>
- Edit this page
- Markdown
- RecentChanges (sitewide)
- History (per-page)
- <a href="http://ikiwiki.info/tips/untrusted_git_push/">tips/untrusted git push</a>
- Oh yeah: `git`!
]

---

<img src="../2-schmonz.com.png" width="600" height="375" alt="screenshot of schmonz.com" class="img" />
]

---

### A blog

- Style: the "actiontabs" theme
- Markdown (and also Textile for older posts)
- Local offline instance: no web server, just files
- `git commit` regenerates affected content
- Tag cloud, backlinks, previous/next, RSS with enclosures, feed _aggregator_ (!), etc.
- `git push` to publish
- Live instance: web server with CGI enabled for search, comments
- I wrote a [program to import my site from Textpattern](https://github.com/schmonz/txp2ikiwiki)
]

---

<img src="../3-agilein3minut.es.png" width="600" height="375" alt="screenshot of agilein3minut.es" class="img" />
]

---

### A podcast

- Similar to `schmonz.com` (including the unimpressive appearance)
- I <a href="../../../../../../2013/08/22/tdd-by-example-an-ikiwiki-feature/">wrote ikiwiki's modern podcast support</a>
]

---

.left-column[
## Example 4/5:
]
.right-column[
## [philo.org](http://www.columbia.edu/cu/philo/) (1/2)

<img src="../4-philo.org.png" width="600" height="375" alt="screenshot of philo.org" class="img" />
]

---

.left-column[
## Example 4/5:
]
.right-column[
## [philo.org](http://www.columbia.edu/cu/philo/) (2/2)

### An access-controlled wiki

- Custom template (not by me)
- University-provided web space is static-only
- But group members can web-edit, and the site updates!
- Alumnus provided a confederate server for ikiwiki CGI + my `rsync`, `windauth` plugins
- No software on `www.columbia.edu`
- I don't know any other way we could have accomplished this
]

---

<img src="../5-wiki.netbsd.org.png" width="600" height="375" alt="screenshot of wiki.netbsd.org" class="img" />
]

---

<img src="../6-www.netbsd.org.png" width="600" height="375" alt="screenshot of www.netbsd.org" class="img" />
]

---

### An access-controlled wiki

- Custom template designed to match [NetBSD's website](http://www.netbsd.org) (plus wiki-specific action bar)
- I wrote <a href="http://ikiwiki.info/rcs/cvs/">ikiwiki's CVS integration</a> so that NetBSD could have a wiki in my lifetime
- Meets NetBSD project's [requirements for security, mirroring, backup, etc.](http://wiki.netbsd.org/wiki/todo/choose_wiki_software/)
- Edit in browser with project Kerberos credentials
- Edit in `$EDITOR` and commit to CVS
- I don't know any other way we could have accomplished this
]

---

When I realized I was about to be giving a bunch of talks, I
integrated [Remark.js](http://remarkjs.com) into ikiwiki.
It was pretty easy.

Now I just write Markdown in a `.remark` file and it turns into slides
like these.

```markdown
.left-column[
## Example 6/5:
]
.right-column[
## These slides

When I realized I was about to be giving a bunch of talks, I
integrated [Remark.js](http://remarkjs.com) into ikiwiki.
It was pretty easy.

Now I just write Markdown in a `.remark` file and it turns into slides
like these.
]
```
]

---

.right-column[
## <a href="../../../../../../2007/05/14/schmonzs-theorem/">Similar, yet different</a>

Ikiwiki can be kind of **like WordPress**, kind of **like Jekyll**, or
both. _Nothing else is kind of like ikiwiki_. It does **most
anything you want** (once you figure out how), and if it doesn't, you can
**test-drive** what you want. And if you don't like Perl as much as I do,
you can <a href="http://ikiwiki.info/plugins/write/external/">extend ikiwiki in any language via XML-RPC</a>.

### More Goodies

- My <a href="../../../../../../2014/11/15/pittsburgh-perl-workshop-2014-web-architecture-for-unix-lovers-with-ikiwiki/">full-length ikiwiki talk from Pittsburgh Perl Workshop 2014</a>, including a live-coded plugin
- My <a href="../../../../../../tag/ikiwiki/">writings about ikiwiki</a>
]

---

# Web Architecture for Unix Lovers

## Amitai Schlair

### PillarCon 2016/04/15

## [schmonz.com](https://schmonz.com)

## [ai3m.co](http://ai3m.co)