Eminently hackable: Chop, slice, dice! hlscript is ready to take your PHP
customization love.
Site formatting/skinning
All your site-specific php goes in site/. You can see on this page
which file is placed where in the main page table.
Article posting
Articles are plain text files located within the articles/ directory.
If you number the article names from 0 to 1 to 2 and onwards, and they'll show
up in the site body, up to the value in the file 'article.top'.
You can also have unlimited named articles, which you can link to as
?article=whatever, in which case only that particular article named 'whatever'
will be shown. I.e. this article's link is ?article=0.
Once you write the next article in your series, say 10, you edit the
'article.top' file and fill in that number. NB the article will only
show up if the dateline is not in the future (or is not a date.)
Article formatting
They should just be normal text files. You can edit them with Notepad
or vim or whatever.
Article layout:
dateline ('Jan 10, 1997' type thing or whatever you want in the left column)
\topic title
some html
<p>
\another topic title
jsdfkjshfjkshf
<p>
Don't forget the <p>. \ at the beginning of a line denotes a topic.
Each topic is boldfaced, and has a permalink generated for it. The first line
in a file is the dateline. This is where you will usually put the date, or some
kind of marker. (See 'today' above.)
Files
config.php
The site-specific config. Edit this file!
site/censor.php
This file determines the word-censor list to be activated if
censor=y on the URL and $censor_enabled = 1.
article.top
This is a text file containing the filename number to make the
top article. i.e. if articles/0 through 47 exist, this file should
contain the string "47". You must update this when you create a new
article and you want it to be the first displayed article.
index.html
index.phtml
index.php
You need to use one of these to generate the front page, with the
bloggy-style article list. Use whichever one your webserver
knows is PHP (most preferably index.html, then .phtml, then .php)
hlscript.php
This file actually generates the site. The various index.* files
just include this one.
rss.php
Autogenerates an RSS feed for your site.
hlscript lays out the main page into a 3-column table. You'll need to
create these files in the site/ directory. If you don't want to use these
just edit config.php and set $display_missing_filename = 0
+--------------+-------------------+-------------+
| topleft.php | top.php | topright.php|
+--------------+-------------------+-------------+
| left.php | [ article.top ] | right.php |
| | | |
| | separator.php | |
| | | |
| | [ article.top-1 ] | |
| | | |
+--------------+-------------------+-------------+
footer.php counter.php
Download
v0.5.6
hlscript.0.5.6.zip: for brand-new installs
hlscript_upgrade.0.5.6.zip: for updating a previous installs (does not overwrite site/ files etc)
Contributors
Brennan Underwood
Justin Frankel
Dan Green
Version history
v0.5.6
- 2 years of little fixes, per-article comments enabling
v0.5.5
- added simple anti-spam question to comments form
v0.5.4
- changed "Comments(0)" to "Comment on this article"
- improved table usage a bit
v0.5.3
- comments improvements: IP address masking, better formatting,
auto URL linking, better spam filtering. Thanks Justin!
v0.5.2
- minor bugfixes and polish
v0.5.1
- added next/prev controls when viewing individual article
v0.5.0
- unbroke comments support :/ oopsie
v0.4.6
- fixes dumb bug where you can't view individual articles :(
v0.4.5
- config option to force width of right column
- fixed alignment bug when showing single article in IE
v0.4.4
- refactored some old cruft out
v0.4.3
- minor bug fixes, polishing, and refactoring
v0.4.2
- merged in L1quid's commenting code, thanks L1quid!
v0.4.1
- lots of changes for lone ;)
- bugfixes
v0.4 (28-nov-2004)
v0.3 (12-oct-2004)