tDiary BlogKit modifies tDiary. This modification enables tDiary to manage articles by topics, not daily. tDiary with BlogKit is different from original one:
- Date has no meaning. It looks like 'serial number'.
- Each topic have last-modified.
- Top page has the 1st section of each topic(like summary).
- tDiary with BlogKit makes new topic number automatically when update.
- BlogKit adds new features: 'Recent Entries' and 'What's New'.
You can setup BlogKit without changing tDiary. It is only plugged-in.
See "how to install (use gem)" section if you want to run tDiary + BlogKit with gem.
First, you need tDiary that is installed. You must use tDiary version 2.1.3 or later. Here, it is assumed that you install tDiary under $INSTALL anew.
Copy tdiary.conf.sample
in BlogKit to $INSTALL/tdiary.conf
. And, rewrite @data_path
in the tdiary.conf to your data saving directory. Read README of tDiary about @data_path
.
Copy tdiary/blog_style.rb
of BlogKit under $INSTALL/tdiary
. You have to confirm there is "@style= 'Blog'" in your tdiary.conf
.
If you want to write by Wiki style, install Wiki style of tDiary original and copy tdiary/blogwiki_style.rb into $INSTALL/tdiary. And specify "@style = 'BlogWiki'" in your tdiary.conf.
Also if you want to write by RD style, install RD style of tDiary original and copy tdiary/blogrd_style.rb into $INSTALL/tdiary. And specify "@style = 'BlogRD'" in your tdiary.conf.
A sample theme for BlogKit available in tdiary-theme package named by "blog'. This is one kind of tDiary themes, but it has some settings to enable sidebar etc.
After tDiary 2.0.1, you can select plugin in preference page. Add the path of BlogKit plugins into tdiary.conf:
@options['sp.path'] = ['misc/plugin', 'blogkit/plugin']
This option can have some pathes of plugins, 1st path is tDiary plugin collection. 2nd path is BlogKit's. Modify path name with your environment.
When you want to add a new topic, click 'Update' link at the bottom of the page. If you want to edit existing page, open the topic and click 'Edit' link at the bottom of the page.
If you installed tDiary by gem, exec tdiary new
command to make your diary, and move current directory to the diary. If you did not use tDiary gem, also make your diary and move current directory to it.
Edit Gemfile.local
on the current directory, add a line below:
gem 'tdiary-blogkit'
(If you want to use any web server, you can specify into the same file.)
So, edit tdiary.conf
file and change @style
variable to 'Blog', 'BlogWiki' or 'BlogRD'.
Then exec tDiary: tdiary server
command or your specified web server.
See each plugin file if you want more information.
Shows all the topics in group sorted by topic number. By default, this plugin shows the topics in the sidebar.
Like archive plugin, this plugin shows all the topics in group. The topics are shown in dropdown list.
Changes 'Diary like' labels to 'Blog like' and adjust title style. You should enable this plugin for using BlogKit.
Shows last-modified in each topic. You can choose position of the last-modified, under topic title or bottom of article. You can use this plugin only by copying this plugin to plugin directory.
Shows the list of the recent topics. You have to choose this plugin or recent-entry2.
Shows a topic title as navigation label. You can use this plugin only by copying this plugin to plugin directory.
Shows a list of updated topics like "What's new". This plugin cannot be used on secure mode. And it can generate RDF file when option setting in tdiary.conf.
Add category feature. A word surrounded by '[' and ']' is treated as a name of category. By clicking this category name, you can move to the page which displays articles of the category. You should initialize the index of category in the config page of tDiary.
Show the list of titles which can't be shown in the category specific page.
Shows all categories in dropdown list. You can select a category to be shown.
Make whole title to link to Permalink.
Copyright (C) by TADA Tadashi [email protected].
You can distribute or modify this under GPL.