site  contact  subhomenews

shellCMS category front-pages

September 16, 2017 — BarryK

I have added a very nice enhancement to shellCMS, per-category front-pages, and have written a tutorial page to introduce it:

Here is a front-page for the "shellcms" category:

Notice too, it has its own top-banner. Now, all posts in that category have that banner.

Tags: shellcms

Local www folder hierarchy matches remote site

September 13, 2017 — BarryK

When I first created shellCMS (forked from BashBlog), I specified the local copy of the website in a folder named LOCAL. If there is a nested shellCMS, say "news", then it was in LOCAL/news/LOCAL, which is getting weird. And difficult to understand when looking at shellCMS for the first time.

I have modified the shellcms script so that the local website is now www, and everything inside is exactly as it will be on the remote host. This greatly simplifies everything, and is easy to understand.

I have rewritten these tutorials accordingly:

There is another improvement that I want to work on next, that users will like. Hope to implement that tomorrow morning.

Tags: shellcms

Sitemap created for

September 10, 2017 — BarryK

I have written another documentation page for shellCMS, explaining how to create a sitemap file and submit it to Google:

It turned out to be very easy, and I am updating the sitemap every time that I do an upload.

Tags: shellcms

shellCMS now has a search box

September 09, 2017 — BarryK

The search box is at the top of the "Barry's News" page. It could be placed on other pages.

It is a simple html form, using Google. very simple.

The config file in shellCMS has variable search_box_pages, which specifies on what pages (or none) that the search box is to appear.

I made a submission to Google to spider my site, however, at the time of writing this, it is far from complete, showing many links that no longer exist.

I need to do some experimenting, as the box width is not displaying correctly on my browser. In the <form> tag, there is the <input> tag, with size="20", which according to online docs, is supposed to set the width of the box to 20 characters. But it doesn't.

Have changed the search box to the official one from duckduckgo, created here:

Have created a variable search_box_engine, to be able to offer a choice of search engine. Currently it is search_box_engine="duckduckgo"

I was reading about duckduckgo. Apparently it does not do much web crawling. Instead it probes other search engines, in particular Bing. So there is nowhere to submit a URL to duckduckgo, have to submit to Bing, then duckduckgo will pick it up.
Which won't happen immediately, and I read some complaints on how long that takes. So, there is a downside to duckduckgo.  

Have got the google search box working. Which is what you see above. Enter a search term, and it will open in a new browser tab, and search the site.

The variable is now search_box_engine="google"

There is still a problem. I cannot change the width of the search box. Tried "width" style, the "size" parameter, no go. Just ignores everything, displays at the default width, whatever that is. Viewing with SeaMonkey.

Tags: shellcms

Install shellCMS as a blog, tutorial

September 07, 2017 — BarryK

I previously posted a tutorial how to install shellCMS as a document manager, at the root of

Now I have written another tutorial, to install shellCMS as a blog, in this case in a folder,

I added the capability of one installation of shellCMS to link to another. If you look at those above pages, you will see a button at the top linking to this blog.

shellCMS is turning out to be lots of fun, and I am brimming over with ideas for its future development.

Tags: shellcms

shellCMS sans markdown uploaded

September 06, 2017 — BarryK

OK, here is the first upload of shellCMS rewritten to write new posts, or edit posts, using a html editor, instead of markdown:

I am using SeaMonkey Composer, WYSIWYG html editor, however, there are other choices for Linux, such as Screem, Bracket and Bluefish.

The last version that has markdown is here:

Tags: shellcms

shellCMS moved from markdown to html

September 05, 2017 — BarryK

I posted yesterday about my growing reservations about markdown:

An additional comment that I can make, is that due to it's limitations, there are many markdown extensions, trying to get it up to a reasonable level of functionality.

I am sure that others out there must have come to the same conclusion about markdown. Yes, read this:

Yep, I agree 100%. Apart from simple github READMEs, markdown is an awful fit. It is a bad fit for blog posts like this one, as I soon found out when I wanted to do more than rudimentary posts.

Well, Fatdog has gone over to markdown, and it seems just about everybody is on the markdown bandwagon, so I got seduced.

I played with markdown briefly for use as local html help pages in Easy OS. Soon realised the limitations, and went back to html.

Then there was BashBlog, which became shellCMS, and I used the nice markdown plugin for Geany. Started hitting gotchas, and doubts crept in.

So, what to do? Fortunately, shellCMS is a small bash script, that I can readily modify, unlike those enormous CMSs out there, where you are locked-in to whatever way they want to do things.

Simple solution, I rewrote shellCMS to write posts with a html editor. Not just any editor, I am using SeaMonkey Composer, a What You See Is What You Get (WYSIWYG) html editor. Using it right now to type this post.

Now, creating a post is so simple! What I am typing in is exactly WYSIWYG. Without the page-layout stuff of course. As I mentioned in the post yesterday, just because html, css, javascript, etc., supports page-layout and all sorts of fancy things, doesn't preclude writing simple non-page-layout html, as I am doing now.

But, anything extra? A table? No problem! Lovely GUI tools to create a table just as I want.

I recall several months ago, I mentioned to a friend, a web page designer, that I use SeaMonkey Composer to create my web pages, and he smiled indulgently, and commented that that is the "old school" way of doing it.

Well, now I have a CMS, in my case a static site generator, so have the advantage of a consistent page layout, headers, links, buttons, etc., and I am still using SM Composer!

I haven't uploaded this new shellCMS yet. Want to do a bit more testing. I converted this blog, which was fairly easy as there are as yet few posts -- it required replacing all the raw .md files with .htmraw. The latter, ".htmraw", are my posts.

Tags: shellcms