Browse Source

Update files

pull/640/head v2.8.4
danpros 2 years ago
parent
commit
f1f2b94e11
3 changed files with 5 additions and 132 deletions
  1. +1
    -1
      COPYRIGHT.txt
  2. +3
    -130
      README.md
  3. +1
    -1
      cache/installedVersion.json

+ 1
- 1
COPYRIGHT.txt View File

@ -1,4 +1,4 @@
Copyright (c) 2014-2021 Danang Probo Sayekti.
Copyright (c) 2014-2023 Danang Probo Sayekti.
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by


+ 3
- 130
README.md View File

@ -44,10 +44,11 @@ Features
- Post Draft - Post Draft
- i18n - i18n
- Menu builder - Menu builder
- Scheduled posts
Requirements Requirements
------------ ------------
HTMLy requires PHP 5.3 or greater, PHP-XML package, and PHP-ZIP package for backup feature.
HTMLy requires PHP 5.3 or greater, PHP-XML package, PHP-INTL package, and PHP-ZIP package for backup feature.
Installations Installations
------------- -------------
@ -79,7 +80,7 @@ In addition, HTMLy support admin user role. To do so, simply add the following l
role = admin role = admin
```` ````
Users assigned with the admin role can edit/delete all users' posts.
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. To access the admin panel, add `/login` to the end of your site's URL.
e.g. `www.yoursite.com/login` e.g. `www.yoursite.com/login`
@ -148,134 +149,6 @@ $ php -a
```` ````
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`. 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`.
Both Online or Offline
----------------------
The built-in editor found in the admin panel, also provides you the ability to write to Markdown files offline by uploading them (see naming convention below) into the `content/username/blog/category/type/`:
* `username` must match `config/users/username.ini`.
* `category` must match the `category.md` inside `content/data/category/category.md` except the `uncategorized` category.
* `type` is the content type. Available content type `post`, `video`, `audio`, `link`, `quote`.
For static pages you can upload it to the `content/static` folder.
Category
--------
The default category is `Uncategorized` with slug `uncategorized` and you do not need to creating it inside `content/data/category/` folder. But if you write it offline and want to assign new category to specific post you need to creating it first before you can use those category, example `content/data/category/new-category.md` with the following content:
```html
<!--t New category title t-->
<!--d New category meta description d-->
New category info etc.
````
The slug for the new category is `new-category` (htmly removing the file extension). And for full file directory:
````
content/username/new-category/post/file.md
````
File Naming Convention
----------------------
When you write a blog post and save it via the admin panel, HTMLy automatically create a .md file extension with the following name, example:
````
2014-01-31-12-56-40_tag1,tag2,tag3_databaseless-blogging-platform-flat-file-blog.md
````
Here's the explanation (separated by an underscore):
- `2014-01-31-12-56-40` is the published date. The date format is `yyyy-mm-dd-hh-mm-ss`
- `tag1,tag2,tag3` are the tags, separated by commas
- `databaseless-blogging-platform-flat-file-blog` is the URL
For static pages, use the following format:
````
content/static/about.md
````
In the example above, the `/about.md` creates the URL: `www.yourblog.com/about`
Thus, if you write/create files offline, you must name the .md file in the format above.
For static subpages, use the following format:
````
content/static/about/me.md
````
This will create the URL: `www.yourblog.com/about/me`
Content Tags
-------------
If you are writing offline, you need specify the content tags below:
**Title**
```html
<!--t Title t-->
````
**Meta description**
```html
<!--d The meta description d-->
````
**Tags**
This is just the tags display and for the slug is in the filename.
```html
<!--tag Tag1,Tag2 tag-->
````
**Featured image**
Post with featured image.
```html
<!--image http://www.example.com/image-url/image.jpg image-->
````
**Featured youtube video**
Post with featured youtube video.
```html
<!--video https://www.youtube.com/watch?v=xxxxxxx video-->
````
**Featured soundcloud audio**
Post with featured soundcloud audio.
```html
<!--audio https://soundcloud.com/xxxx/audio-url audio-->
````
**Featured link**
Post with featured link.
```html
<!--link https://github.com/danpros/htmly link-->
````
**Featured quote**
Post with featured quote.
```html
<!--quote Premature Optimization is The Root of All Evil quote-->
````
**Example**
Example of how your post would look like:
```html
<!--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.
```
Contribute Contribute
---------- ----------
1. Fork and edit 1. Fork and edit


+ 1
- 1
cache/installedVersion.json View File

@ -1,4 +1,4 @@
{ {
"id": 782014, "id": 782014,
"tag_name": "v2.8.3"
"tag_name": "v2.8.4"
} }

Loading…
Cancel
Save