what's the use of feeling? (blue)
 
 
Go to file
endorphant 2a406d7958 added patching utility
now checks for user version; if it doesn't match current version, apply
patches.

current patch reconfigures user directories, moving files out of
public_html and setting up a symlink from user's "publish dir" to
.ttbp/www instead. also moves style.css into .ttbp/config and symlinks
to www/style.css in preparation for style selector.
2016-05-16 21:42:32 -04:00
bin added patching utility 2016-05-16 21:42:32 -04:00
lib setup and posting function running 2016-05-01 19:34:20 -04:00
README.md more docs updating 2016-05-15 03:11:51 -04:00
changelog.txt working on private blogging 2016-05-15 18:15:53 -04:00
devnotes.txt editing docs 2016-05-15 02:53:50 -04:00

README.md

a command-line based blogging platform running on tilde.town

to use, run ~endorphant/bin/ttbp while logged in to tilde.town

you can also try ~endorphant/bin/ttbp-beta for a more unstable, bleeding-edge experience.

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
  • 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)

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/www/style.css
  • 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

  • add alias ttbp="~endorphant/bin/ttbp" to your .bash_aliases for fewer keystrokes