forked from endorphant/ttbp
132 lines
5.0 KiB
Markdown
132 lines
5.0 KiB
Markdown
*a command-line based blogging platform running on tilde.town*
|
|
|
|
`ttbp` stands for "tilde.town blogging platform", the original working name for
|
|
this project.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`ttbp` runs from the command line, providing a hub for writing personal blog
|
|
posts and reading posts written by other users of tilde.town. it's a little bit
|
|
like livejournal or dreamwidth or tumblr. you can opt to publish your posts to
|
|
a public html file hosted on your tilde page, or keep all your entries private
|
|
to the tilde.town server.
|
|
|
|
to use, run `~endorphant/bin/ttbp` while logged in to tilde.town
|
|
|
|
you can also try `~endorphant/bin/ttbp-beta` for a more colorful, but
|
|
potentially volatile experience; i sometimes announce in irc or on twitter when
|
|
i'm testing a new feature.
|
|
|
|
### QUICK START
|
|
|
|
no coding or html experience is necessary to get started. just log in to your
|
|
tilde.town account and enter:
|
|
|
|
`~endorphant/bin/ttbp`
|
|
|
|
ttbp will ask you a few questions to get you started. after that, writing and
|
|
reading entries all happen within the program.
|
|
|
|
that's it!
|
|
|
|
### SUPPORT
|
|
|
|
if you're having trouble getting started, or run into program errors or strange
|
|
behavior, please send internal tilde.town mail to ~endorphant and i'll try to
|
|
sort things out!
|
|
|
|
### writing entries
|
|
|
|
entries are recorded as plaintext files in your ~/.ttbp/entries
|
|
directory. you can edit them there directly, or fix old entries, or
|
|
delete entries.
|
|
|
|
*warning*: changing old entries might cause strange things to
|
|
happen with timestamps. the main program looks at the filename
|
|
first for setting the date, then the last modified time to sort
|
|
recent posts. it expects YYYMMDD.txt as the filename; anything else
|
|
won't show up as a valid entry. yes, this means you can post things out
|
|
of date order by creating files with any date you want.
|
|
|
|
#### general entry-writing notes
|
|
|
|
* you can use [markdown](https://daringfireball.net/projects/markdown/syntax)
|
|
* you can use html
|
|
* you can also put things between `<!-- comments -->` to have them show up
|
|
in the feed but not render in a browser (but people can still read
|
|
them with view-source)
|
|
|
|
### privacy
|
|
|
|
when you start your ttbp, you have the option of publishing or not publishing
|
|
your blog.
|
|
|
|
if you opt to publish, the program creates a directory `~/.ttbp/www`
|
|
where it stores all html files it generates, and symlinks this from your
|
|
`~/public_html` with your chosen blog directory. your blog will also be listed
|
|
on the [main ttbp page](https://tilde.town/~endorphant/ttbp).
|
|
|
|
if you opt to not publish, your entires will never be accessible from outside
|
|
of the tilde.town network; other tilde.town users will still be able to read
|
|
your entries through the ttbp interface, or by directly accessing your
|
|
`~/.ttbp/entries` directory.
|
|
|
|
if you want to further protect your entries, you can `chmod 700` your entries
|
|
directory.
|
|
|
|
### changing your page layout
|
|
|
|
you can modify how your blog looks by editing the stylesheet or
|
|
header and footer files. the program sets you up with basic
|
|
default. if you break your page somehow, you can force the program to
|
|
regenerate your configuration by deleting your ~/.ttbp directory entirely.
|
|
**you might want to back up your ~/.ttbp/entries directory before you do
|
|
this.**
|
|
|
|
* to modify your stylesheet, edit your ~/.ttbp/config/style.css
|
|
* (future feature: having multiple stylesheets you can select)
|
|
* to modify the page header, edit your ~/.ttbp/config/header.txt
|
|
* you might note that there's a place marked off in the default header where
|
|
you can safely put custom HTML elements!
|
|
* to modify the page footer, edit your ~/.ttbp/config/footer.txt
|
|
|
|
### general tips/troubleshooting
|
|
|
|
* add `alias ttbp="~endorphant/bin/ttbp"` to your .bash_aliases for fewer keystrokes
|
|
* (similarly, `alias ttbp-beta="~endorphant/bin/ttbp-beta"`)
|
|
* if the date looks like it's ahead or behind, it's because you haven't set
|
|
your local timezone yet. here are some
|
|
[timezone setting instructions](http://www.cyberciti.biz/faq/linux-unix-set-tz-environment-variable/)
|
|
|
|
### future features
|
|
|
|
these are a few ideas being kicked around, or under active development:
|
|
|
|
* better entry privacy/publish control options
|
|
* stylesheet/theme selector
|
|
* responding to entries
|
|
* paginated list view
|
|
* better entry display within ttbp
|
|
|
|
### dependencies
|
|
|
|
(this section is only relevant if you plan on forking the repo and running an
|
|
instance of this yourself)
|
|
|
|
* [mistune](https://pypi.python.org/pypi/mistune)
|
|
* [inflect](https://pypi.python.org/pypi/inflect)
|
|
|
|
### contributing
|
|
|
|
please check out my contributor guidelines on github if you'd like to get
|
|
involved with development!
|
|
|
|
if you find any bugs or strange behavior, please message me locally on tildemail
|
|
or open a github issue and i'll get back to you as soon as i can.
|
|
|
|
if you're interested in helping with the code, please drop me some tildemail!
|