41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
|
title the bread tool
|
||
|
author breadw
|
||
|
|
||
|
`bread` is a great tool to interact with some of the aspects of the town.
|
||
|
here are the subcommands:
|
||
|
|
||
|
## news
|
||
|
|
||
|
`bread news` lets you read the latest news.
|
||
|
typed by itself, it'll show you the latest four news items.
|
||
|
you can change the number of shown items by running
|
||
|
`bread news -n NUM`.
|
||
|
if there's a specific word or phrase you're looking for,
|
||
|
you can search all the news with `bread news -s QUERY`.
|
||
|
|
||
|
if you're an admin, you can write an article
|
||
|
using `bread news -w`.
|
||
|
the article will show up on the web site in [news](/news).
|
||
|
|
||
|
later, it'd be nice if users could use `bread news`
|
||
|
to write their own news that could be linked from the main news feed.
|
||
|
eventually, we're going to generate gopher, gemini, and RSS pages
|
||
|
from the news as well.
|
||
|
|
||
|
## docs
|
||
|
|
||
|
`bread docs` lets you read breadpunk.club's [documentation](/docs).
|
||
|
it's kind of like a wiki,
|
||
|
except the pages aren't automatically linked.
|
||
|
typed by itself, it'll let you select a document to read
|
||
|
(type `q` or `CTRL-D` to quit).
|
||
|
you can search for a specific phrase by running `bread docs -s QUERY`.
|
||
|
you can write a new document using `bread docs -n`
|
||
|
(though if it has the same name as another document, it'll fail--
|
||
|
but you can still retrieve it from /tmp).
|
||
|
to edit a document, run `bread docs -e QUERY`,
|
||
|
and choose the one you'd like to edit.
|
||
|
|
||
|
docs are editable by every baker!
|
||
|
so be kind.
|