HTMLy is an open source databaseless blogging platform prioritizes simplicity and speed written in PHP.
It uses a unique algorithm to find or list any content based on date, type, category, tag, or author, and it's performance remain fast even if we have ten thousand of posts and hundreds of tags.
HTMLy requires PHP 5.3 or greater, PHP-XML package, PHP-INTL package, and PHP-ZIP package for backup feature.
Install HTMLy using the source code:
- Download the latest version from the Github repo
- Upload and extract the zip file to your web server. You can upload it in the root directory, or in subdirectory such as
htmly. - Visit your domain. If you extract it in root directory visit
https://www.example.com/install.phpand if in subdirectory visithttps://www.example.com/htmly/install.php. - Follow the installer to install HTMLy.
- The installer will try to delete itself. Please delete the installer manually if the
install.phpstill exist.
Note: If you don't need to log in to the dashboard, just rename config.ini.example to config.ini, delete install.php, and you are set. It's always good practice to set the site.url
Install HTMLy without downloading the source code and use the online installer:
- Download
online-installer.phpfrom the latest release - If you upload it in root directory visit
https://www.example.com/online-installer.phpor if in subdirectory visithttps://www.example.com/subdirectory/online-installer.php. - Follow the installer to install HTMLy.
- Please delete the installer manually if the
online-installer.phpandinstall.phpstill exist.
Set written permission for the cache and content directories.
Users assigned with the admin role can edit/delete all users posts.
To access the admin panel, add /login to the end of your site's URL.
e.g. www.yoursite.com/login
Like traditional static pages, even though HTMLy is a dynamic PHP application, most important metadata such as username, category, type, tags, publication date, and slug are in the folder name and filename.
If you use the dashboard to write your posts, the folder structure and filenames will be set by the dashboard automatically.
The following is an example of a folder and file structure from HTMLy:
content/my-username/blog/my-category/post/2024-01-10-15-35-45_tag1,tag2_my-post-slug.mdHere's the explanation:
my-usernameis the username.my-categoryis the content category.postis the content type. Available content typepost,video,audio,link,quote.2024-01-10-15-35-45is the published date. The date format isY-m-d-H-i-stag1,tag2are the tags, separated by commasmy-post-slugis the URL
Note: the filename metadata (post date, tags, slug) separated by an underscore.
With a structure like above, the post can now be visited even though it's just a folder structure and filename.
To claim this content or log in to dashboard, simply create my-username.ini in the config/users/ folder (see username.ini.example).
;Password
password = yourpassword
;Encryption: Set to clear, and later it will changed to password_hash automatically during login
encryption = clear
;Role
role = adminAnd to add information about the author, create author.md in content/my-username/, example:
<!--t My Cool Name t-->
Just another HTMLy userInformation about my-category can be added by creating my-category.md inside the content/data/category/ folder.
<!--t My category title t-->
<!--d My category meta description d-->
This is my category info etc.Note: The default category is Uncategorized with slug uncategorized and you do not need to creating it inside content/data/category/ folder.
Note: Delete the page folder inside the cache folder to clear the html page cache served to visitors.
Important: Every time new content added (post, pages, category), or you make changes that change the folder structure or filenames, simply delete the index and widget folder inside cache folder so that the changes detected by HTMLy.
Post Views limitations: HTMLy using the post/page slug for the post/page views counter ID. So if you edit a post/page slug without using the dashboard, then you must edit views.json in the content/data/ folder manually to update to the correct slug.
For static pages, use the following format:
content/static/about.mdIn the example above, the about.md creates the URL: www.yourblog.com/about
Thus, if you write/create files locally, you must name the .md file in the format above.
For static subpages, use the following format:
content/static/about/me.mdThis will create the URL: www.yourblog.com/about/me
An example pages/subpages content looks like:
<!--t My page title t-->
<!--d My page meta description d-->
This is my page info etc.Page ordering
To sort the pages, you just need to add integer value followed by a period.
content/static/01.contact.md
content/static/02.about.mdFor static subpages:
content/static/01.contact/01.us.md
content/static/01.contact/02.me.mdIf you are writing locally, you need specify the content tags below:
Title
<!--t Title t-->Meta description
<!--d The meta description d-->Tags
This is just the tags display and for the slug is in the filename.
<!--tag Tag1,Tag2 tag-->Featured image
Post with featured image.
<!--image http://www.example.com/image-url/image.jpg image-->Featured youtube video
Post with featured youtube video.
<!--video https://www.youtube.com/watch?v=xxxxxxx video-->Featured soundcloud audio
Post with featured soundcloud audio.
<!--audio https://soundcloud.com/xxxx/audio-url audio-->Featured link
Post with featured link.
<!--link https://github.com/danpros/htmly link-->Featured quote
Post with featured quote.
<!--quote Premature Optimization is The Root of All Evil quote-->Example
Example of how your post would look like:
<!--t Here is the post title t-->
<!--d The meta description d-->
<!--tag Tag1,Tag2 tag-->
<!--video https://www.youtube.com/watch?v=xxxxxxx video-->
Paragraph 1
Paragraph 2 etc.The following is an example configuration for lighttpd:
$HTTP["url"] =~ "^/config" {
url.access-deny = ( "" )
}
$HTTP["url"] =~ "^/system/includes" {
url.access-deny = ( "" )
}
$HTTP["url"] =~ "^/system/admin/views" {
url.access-deny = ( "" )
}
url.rewrite-once = (
"^/(themes|system|vendor)/(.*)" => "$0",
"^/(.*\.php)" => "$0",
# Everything else is handles by htmly
"^/(.*)$" => "/index.php/$1"
)The following is a basic configuration for Nginx:
server {
listen 80;
server_name example.com www.example.com;
root /usr/share/nginx/html;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log error;
index index.php;
location ~ /config/ {
deny all;
}
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}Passwords can be stored in username.ini (where "username" is the user's username) in either plaintext, encryption algorithms supported by php hash or bcrypt (recommended). To generate a bcrypt encrypted password:
$ php -a
> echo password_hash('desiredpassword', PASSWORD_BCRYPT);
This will produce a hash which is to be placed in the password field in username.ini. Ensure that the encryption field is set to password_hash.
- Fork and edit
- Submit pull request for consideration
For copyright notice please read COPYRIGHT.txt. HTMLy is licensed under the GNU General Public License Version 2.0 (or later).
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent