documentation updates
parent
22676344c9
commit
02aa584f60
39
README.md
39
README.md
|
@ -1,4 +1,7 @@
|
|||
a command-line based blogging platform running on tilde.town
|
||||
*a command-line based blogging platform running on tilde.town*
|
||||
|
||||
`ttbp` stands for "tilde.town blogging platform", the original working name for
|
||||
this project.
|
||||
|
||||
to use, run `~endorphant/bin/ttbp` while logged in to tilde.town
|
||||
|
||||
|
@ -26,20 +29,50 @@ of date order by creating files with any date you want.
|
|||
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.**
|
||||
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!
|
||||
* 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
|
||||
|
||||
### 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
|
||||
|
|
|
@ -1,9 +1,8 @@
|
|||
TO-DO:
|
||||
(goals for stable release)
|
||||
|
||||
-command line flags:
|
||||
-shortcut to most recent feels, writing entry, seeing own entry
|
||||
-neighbor view takes you to individual entry listing
|
||||
-set pub/nopub on entries
|
||||
|
||||
(goals for version two)
|
||||
|
||||
|
@ -15,11 +14,21 @@ TO-DO:
|
|||
-make a nicer entry view wrapper
|
||||
-maybe with a box? and a nicer feed view?
|
||||
|
||||
(flair)
|
||||
|
||||
-graffiti wall
|
||||
-command line flags:
|
||||
(maybe; not sure i want this to be a feature at all)
|
||||
-shortcut to most recent feels, writing entry, seeing own entry
|
||||
-#hashtags
|
||||
|
||||
------
|
||||
|
||||
CHANGELOG:
|
||||
|
||||
ver 0.8.7
|
||||
-fixing publish/nopub option setting from patcher
|
||||
|
||||
ver 0.8.6; mostly structural changes
|
||||
-a freaking patch utility?! yes, there's a patch utility now
|
||||
-settings now has an option to publish or not publish your blog to
|
||||
|
|
Loading…
Reference in New Issue