-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy patha-short-blojsom-faq.html
113 lines (109 loc) · 8.01 KB
/
a-short-blojsom-faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!DOCTYPE html>
<html lang="en">
<head>
<title>meandering journey</title>
<meta charset="utf-8" />
<link href="./theme/css/main.css" type="text/css" rel="stylesheet" />
<link href="http://meandering.journey.sk/feeds/all.atom.xml" type="application/atom+xml" rel="alternate" title="meandering journey Full Atom Feed" />
<link href="http://meandering.journey.sk/feeds/misc.atom.xml" type="application/atom+xml" rel="alternate" title="meandering journey Categories Atom Feed" />
</head>
<body id="index" class="home">
<div class="all">
<div class="extra-info">
<aside>
<h3>About the blog</h3>
A platform to practice my written communication skills.
The range of topics tends to surprise even myself.
</aside>
<aside>
<h3>About the author</h3>
My name is Ján Hušták. I live near
<a href="http://maps.google.com/maps?q=bratislava&z=6">Bratislava</a>.
I've been developing software professionally since 1998.
The Java platform has served me well but I don't dwell on it.
</aside>
<aside>
<h3>Links</h3>
<a href="http://www.journey.sk">Main site</a>,
<a href="http://coding.journey.sk">projects page</a>,
<a href="https://github.com/codingjourney">GitHub</a>.
Sorry, no social networks. I do read mail sent to
coding at journey.sk.
</aside>
<aside id="tags">
<h3>Tags</h3>
<a href="./tag/motivation.html">motivation</a>
- <a href="./tag/htpc.html">HTPC</a>
- <a href="./tag/openbsd.html">OpenBSD</a>
- <a href="./tag/qt.html">Qt</a>
- <a href="./tag/upsheet.html">upsheet</a>
- <a href="./tag/python.html">Python</a>
- <a href="./tag/kde.html">KDE</a>
- <a href="./tag/cloud-computing.html">cloud computing</a>
- <a href="./tag/caldav.html">CalDAV</a>
- <a href="./tag/howto.html">howto</a>
- <a href="./tag/jetty.html">Jetty</a>
- <a href="./tag/craftsmanship.html">craftsmanship</a>
- <a href="./tag/meta.html">meta</a>
- <a href="./tag/music.html">music</a>
- <a href="./tag/it-misadventures.html">IT misadventures</a>
- <a href="./tag/algorithms.html">algorithms</a>
- <a href="./tag/android.html">Android</a>
- <a href="./tag/cups.html">CUPS</a>
- <a href="./tag/security.html">security</a>
- <a href="./tag/html5.html">HTML5</a>
</aside>
<aside class="links">
<h3>Recent articles</h3>
<a href="./much-more-fun-with-planning-poker.html">Much more fun with Planning poker</a>
<a href="./the-child-that-grew-too-fast.html">The child that grew too fast</a>
<a href="./mare-nostrum-at-konzerthaus.html">Mare Nostrum at Konzerthaus</a>
<a href="./too-much-fun-with-planning-poker.html">Too much fun with Planning poker</a>
<a href="./long-time-no-blog.html">Long time no blog</a>
<a href="./what-i-did-last-summer.html">What I did last summer</a>
<a href="./october-2013-is-here.html">October 2013 is here</a>
<a href="./october-2013.html">October 2013</a>
</aside>
</div><!-- /.extra-info -->
<div class="main-column">
<header id="banner" class="body">
<h1><a href=".">meandering<img src="./theme/images/logo.png"/>journey</a></h1>
</header><!-- /#banner -->
<section id="content" class="body">
<header>
<h3>
<a href="a-short-blojsom-faq.html" rel="bookmark"
title="Permalink to A short Blojsom FAQ">A short Blojsom FAQ</a></h2>
</header>
<footer class="post-info">
Published on <abbr class="published" title="2010-11-06T08:07:00"> Sat 06 November 2010 </abbr> under
<a href="./tag/meta.html">meta</a>, <a href="./tag/howto.html">howto</a> </footer><!-- /.post-info -->
<div class="entry-content">
<p><em>(Please note that in May 2013 the blog ha migrated to Pelican.)</em></p>
<p>This blog is powered by the <a href="http://www.sourceforge.net/projects/blojsom">Blojsom</a> blog engine, installed and managed by myself on my own server. Blojsom is a nice piece of work but its <a href="http://wiki.blojsom.com/">documentation pages</a> seem to be down at the moment, so I had to poke around a bit while setting it up. I've compiled a quick FAQ based on that experience:</p>
<ul>
<li><strong>Is Blojsom suitable for me?</strong>
If you're familiar with Java-based web technologies and you want to host a blog, Blojsom is probably your best choice. Just drop the .war file into Tomcat's webapps/, deploy, tweak an XML file, restart and you're done. If you have no idea what the previous sentence is about, Blojsom is definitely not suitable for you.</li>
<li><strong>How do I configure Blojsom?</strong>
Low-level settings can be set in <em>WEB-INF/web.xml</em> and <em>WEB-INF/classes/*.xml</em>. There are only two things you really need to set, both of them in <em>WEB-INF/classes/blojsom-helper-beans-include.xml</em>. The first is database location. Look for "jdbc:hsqldb:mem" and replace "mem" with the desired path (like "/home/joe/databases/blog" where "/home/joe/databases" is an existing writable directory and "blog" is an arbitrary database name). Blojsom will create database files during the next start-up. By default, Blojsom also destroys its database upon shutdown (the default settings are meant for initial testing). To prevent that from happening, look for "hbm2ddl.auto" and on the same line, change "create-drop" to just "create".</li>
<li><strong>When I start Blojsom and go to its URL I see no blog, only something about a "meta refresh". What's up with that?</strong>
A single Blojsom installation can run multiple blogs at once, hence it has no central home page. Instead, each blog gets its own page. The default blog is called "default" and its URL under Blojsom is <em>/blog/default/</em>, i.e. instead of <em>http://server/blojsom/</em> you should go to <em>http://server/blojsom/blog/default/</em>. How to automatically bring visitors from <em>/blojsom</em> to <em>/blojsom/blog/default</em> is a topic beyond the scope of this FAQ.</li>
<li><strong>How do I log into Blojsom?</strong>
Blojsom's default theme has no <em>Log in</em> link. To get to a blog's login page, simply append "?flavor=admin" to the blog's URL. The pre-set admin account is "blojsom" (password "blojsom"). Once logged in, you can configure accounts under <em>Weblog Settings > Users</em>.</li>
<li><strong>How do I change my blog's theme?</strong>
Themes are simply collections of files in subdirectories under <em>WEB-INF/themes</em>. A few are pre-installed; you can choose among them under <em>Plugins > Configure > Theme Switcher plugin</em>. Keep in mind that while logged in, you see the blog's "admin" flavor but themes are applied to the "html" flavor by default.</li>
<li><strong>I hate all of the bundled themes, how do I add my own?</strong>
Oh come on, the "autumn" theme is pretty good ;-) Anyway, your best bet is to copy an existing theme into a new directory and tweak the files until you're satisfied. One caveat: Blojsom doesn't actually use the files under <em>WEB-INF/themes</em> when rendering a blog. Instead, whenever you choose a theme in the admin page, its files are copied into <em>resources/<blogname></em> and that's where Blojsom looks when rendering. So each time you want to see the changes you've made under <em>WEB-INF/themes/myCoolTheme</em> you have to choose "myCoolTheme" in the admin page. You could, of course, edit files under <em>resources/<blogname></em> directly but you would risk losing your changes at the next theme switch.</li>
</ul>
</div><!-- /.entry-content -->
</section>
<footer id="contentinfo" class="body">
<address id="about" class="vcard body">
Proudly powered by <a href="http://getpelican.com/">Pelican</a>,
which takes great advantage of <a href="http://python.org">Python</a>.
</address><!-- /#about -->
</footer><!-- /#contentinfo -->
</div><!-- /.main-column -->
</div><!-- /.all -->
</body>
</html>