details/README.md

# details

this is a tiny twine-like gamemaking tool using the html details tag.

## how to use

to use this tool, you'll need rustc and cargo, which you can download [at the rustlang website](https://rust-lang.org). clone this repo, navigate to it, and run

```
cargo run path/to/detail/file
```

to generate an html file.

(sorry you have to download a whole programming language to compile ~200 lines of code. tk: web tool to facilitate this?)

## markup

`~title write the title of your game`: this will show up as the page title.

`~detail start`: this is where your game will start. required.

`~detail name of a detail`: starts a new detail passage.

`#name of a detail#`: inserts the text wrapped in `#` as the summary of a `<details>` tag, and the contents of the `~detail` passage of the same name as its contents.

`#display text~name of a detail#`: the same as above, except the text before the `~` will be displayed as the summary instead of the passage name.

you can use markdown in passage text---whatever's supported by [the rust markdown crate](https://crates.io/crates/markdown). this is meant to be a _simple_ way of marking up passages, and wasn't built with more complex markdown features like footnotes, bibliographies, etc. in mind.

## example .detail file: 

```
~title cat story

~detail start
the #cat# sat on the mat

~detail cat
the cat was very #pretty~pet# and has green eyes

~detail pet
you pet the cat! it _purred_ pleasantly
```

## inspirations/influences

- [twine](https://twinery.org)
- [tracery](http://tracery.io)
- [soft corruptor](http://cordite.org.au/poetry/game/soft-corruptor/)