forked from team/bashblog
more variables
This commit is contained in:
parent
b61dc479e5
commit
239c4c9f9d
88
bb.1
88
bb.1
|
@ -39,12 +39,19 @@ will open your
|
||||||
.Ev $EDITOR
|
.Ev $EDITOR
|
||||||
to author a new post in markdown. if available, else in html directly. Use
|
to author a new post in markdown. if available, else in html directly. Use
|
||||||
.Nm
|
.Nm
|
||||||
.br
|
|
||||||
.Cm post
|
.Cm post
|
||||||
.Fl html
|
.Fl html
|
||||||
to start a new post using HTML even when markdown is available.
|
to start a new post using HTML even when markdown is available. After you
|
||||||
|
save and exit your editor, you will be asked if you want to post (
|
||||||
|
.Sq p
|
||||||
|
), edit (
|
||||||
|
.Sq E
|
||||||
|
) or keep this for later as a draft (
|
||||||
|
.Sq d
|
||||||
|
).
|
||||||
Posts will be served at
|
Posts will be served at
|
||||||
.Pa https://tilde.club/~you/blog/ .
|
.Pa https://tilde.club/~you/blog/
|
||||||
|
\.
|
||||||
Specifying a
|
Specifying a
|
||||||
.Pa filename
|
.Pa filename
|
||||||
will pre-load the editor with the contents of that file.
|
will pre-load the editor with the contents of that file.
|
||||||
|
@ -82,7 +89,7 @@ regenerates all pages and posts, preserving the content of the entries.
|
||||||
.Nm
|
.Nm
|
||||||
.Cm reset
|
.Cm reset
|
||||||
deletes everything. Use with caution and
|
deletes everything. Use with caution and
|
||||||
.Sy backup everything
|
.Em backup everything
|
||||||
first.
|
first.
|
||||||
.Pp
|
.Pp
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -113,7 +120,10 @@ otherwise you will see strange behaviour.
|
||||||
Configuration file overriding the global defaults.
|
Configuration file overriding the global defaults.
|
||||||
.Pp
|
.Pp
|
||||||
.It Pa drafts/
|
.It Pa drafts/
|
||||||
Folder where you drafts are saved.
|
Folder where you drafts are saved if you choose the
|
||||||
|
.Sq d
|
||||||
|
option after exiting your
|
||||||
|
.Ev EDITOR .
|
||||||
.It Pa .backup.tar.gz
|
.It Pa .backup.tar.gz
|
||||||
Backup from before you did something silly.
|
Backup from before you did something silly.
|
||||||
.It Pa .yesterday.tar.gz
|
.It Pa .yesterday.tar.gz
|
||||||
|
@ -135,8 +145,8 @@ which allows you to set
|
||||||
variables which override the global defaults.
|
variables which override the global defaults.
|
||||||
.Em Note,
|
.Em Note,
|
||||||
this is a bash script, so the format is
|
this is a bash script, so the format is
|
||||||
.Ql var="value" .
|
.Dl var="value"
|
||||||
Do not try to get fancy.
|
Please do not try to get fancy.
|
||||||
.Pp
|
.Pp
|
||||||
Available variables:
|
Available variables:
|
||||||
.Bl -tag -width xxxxxxxxxxxxxxxxxxxxxx
|
.Bl -tag -width xxxxxxxxxxxxxxxxxxxxxx
|
||||||
|
@ -144,6 +154,70 @@ Available variables:
|
||||||
Blog title
|
Blog title
|
||||||
.It global_description
|
.It global_description
|
||||||
The typical subtitle for each blog.
|
The typical subtitle for each blog.
|
||||||
|
.It global_url
|
||||||
|
The public base URL for this blog.
|
||||||
|
.It global_author
|
||||||
|
Your name
|
||||||
|
.It global_author_url
|
||||||
|
You can use your tildehome, Twitter, Facebook, etc. as your
|
||||||
|
.Sq global_author_url
|
||||||
|
.It global_email
|
||||||
|
Your email address.
|
||||||
|
.It global_license
|
||||||
|
CC by-nc-nd is a good starting point, but you can pick a different license. You can change this to
|
||||||
|
.Ql ©
|
||||||
|
for Copyright.
|
||||||
|
.It global_feedburner
|
||||||
|
Set to empty (
|
||||||
|
.Ql ""
|
||||||
|
) if you don't use feedburner, otherwise point it to your URL.
|
||||||
|
.It global_twitter_username
|
||||||
|
Set this to your username if you want to use Twitter for comments.
|
||||||
|
.It global_twitter_cookieless
|
||||||
|
Set this to
|
||||||
|
.Ql false
|
||||||
|
for a Twitter button with a share count. The cookieless version is just a link.
|
||||||
|
.It global_twitter_search
|
||||||
|
Default search page, where tweets more than a week old are hidden.
|
||||||
|
.It index_file
|
||||||
|
The index page of the blog. Probably a good idea to stick with
|
||||||
|
.Ql index.html
|
||||||
|
.It number_of_index_articles
|
||||||
|
How many posts to show on the index page.
|
||||||
|
.It archive_index
|
||||||
|
Page name of your
|
||||||
|
.Dq all posts
|
||||||
|
page.
|
||||||
|
.It tags_index
|
||||||
|
Page name of your
|
||||||
|
.Dq all tags
|
||||||
|
page.
|
||||||
|
.It gophermap
|
||||||
|
Ignore gophermap?
|
||||||
|
.It non_blogpost_files
|
||||||
|
A bash array of files that
|
||||||
|
.Nm
|
||||||
|
will ignore. Useful for static resources. E.g.
|
||||||
|
.Dl
|
||||||
|
non_blogpost_files=("news.html" "test.html")
|
||||||
|
.It blog_feed
|
||||||
|
RSS feed file name.
|
||||||
|
.It number_of_feed_articles
|
||||||
|
How many posts to put in the RSS feed.
|
||||||
|
.It cut_do
|
||||||
|
.Dq cut
|
||||||
|
blog entry when putting it to index page. Leave blank for full
|
||||||
|
articles in front page, i.e. include only up to first
|
||||||
|
.Ql <hr>
|
||||||
|
or
|
||||||
|
.Ql ----
|
||||||
|
in markdown.
|
||||||
|
.It cut_tags
|
||||||
|
When cutting, cut also tags? If
|
||||||
|
.Ql no
|
||||||
|
, tags will appear in index page for cut articles. If
|
||||||
|
.Ql yes
|
||||||
|
, they won't.
|
||||||
.El
|
.El
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
.Sh DIAGNOSTICS
|
.Sh DIAGNOSTICS
|
||||||
|
|
Loading…
Reference in New Issue