Download the PHP package eklausme/saaze-koehntopp without Composer
On this page you can find all versions of the php package eklausme/saaze-koehntopp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eklausme/saaze-koehntopp
More information about eklausme/saaze-koehntopp
Files in eklausme/saaze-koehntopp
Package saaze-koehntopp
Short Description An example theme and content using the Simplified Saaze static site generator
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package saaze-koehntopp
Example theme for Simplified Saaze
Here is an example theme, called Koehntopp, modeled after the personal blog of Kristian Köhntopp. This blog itself is based on the Jekyll-based theme Type on Strap. Some characteristics:
- Responsive design
- Based on Bootstrap-CSS
- Tags
- Blog
- RSS feed
- Search functionality, if you have PHP on the web-server
This koehntopp example will generate a full website for the blog of Kristian Köhntopp.
Using Simplified Saaze will further provide MathJax, YouTube, Twitter, CodePen, image galleries, and all the other goodies.
Simplified Saaze
Simplified Saaze is a fast, all-inclusive, flat-file CMS for simple websites and blogs.
Static site builders are fast but normally have a steep learning curve and require lots of tooling to make them work. We believe building a personal site should be stupidly simple. That's why Simplified Saaze is built on the following principles.
- Easy to run - All you need is PHP8, a C compiler, and Composer
- Easy to host - Serve dynamically or statically
- Easy to edit - Edit content using simple Markdown files
- Easy to theme - Templates use plain PHP/HTML
- Fast and secure - No database = less moving parts + more speed
- Simple to understand - Everything is a collection of entries
Read Simplified Saaze for installation and usage.
Installation
Run
This will copy the files of this Git repository, it will also install Simplified Saaze. To run Simplified Saaze you still need to compile one C program, install one PECL (PHP extension), and configure one PHP file. This is something you have to do only once.
Deployment and Usage
The following directories and files only need to be copied if they have been changed:
- public/assets
- koehntopp.css
1. Demo. You can view the theme in action here: Kristian Köhntopp's GitHub page.
The source code for the Composer:
This will install the theme and the static site generator in one step. You still need to follow the steps in Installation, i.e.,
- make yaml extension available for
php - compile
php_md4c_toHtml.c
Once everything is installed switch to the directory and run
The time is only to show you how quick it really is. Runtime on AMD Ryzen 7 5700G is less than 0.2 seconds for almost 1,000 blog posts. And for this only a single core is used. The -d /tmp/build is used to generate the static HTML file in /tmp, which happens to be a RAM disk on Arch Linux. Any other directory will do.
2. Conversion. In case you want to replicate the conversion from the original blog of Kristian Köhntopp, hitherto using Hugo, to Simplified Saaze you will proceed as follows:
- Clone GitHub repository github.com/isotopp.github.io
- Manually rename
Manually rename 2019-04-25-what-has-kubernetes-ever-done=for-us.mdto the same file without the equal sign - Remove file 2004-02-08-cooties.md, as it is entirely empty
- Run each content file through Perl script
blogkoehntopp, i.e.,for i in *.md; do ... done - Change directory to
content/postsand run Perl scriptblogcategory -p ../ *.md > ../cat_and_tags.json - I ran the CSS through CSS Beautifier
3. Comparison. Below are the number of lines for configuration and templates, furthermore errors on pages, and runtimes. Runtimes were measured on AMD Ryzen 7 5700G, max. 5.7 GHz, 64 GB RAM, all files were in RAM disk.
| Hugo | Simplified Saaze |
|---|---|
| config.yaml: 87 | posts.yml+aux.yml: 10 |
| partials:*.html:136 | templates:top+bottom.php:139 |
| W3 validator errors:8 | W3 validator errors:0 |
| hugo build: real 1.15s | php saaze: real 0.19s |
| hugo build: user 12.15s | php saaze: user 0.15s |
Kristian Köhntopp reports runtime for Hugo to be 8.156s on his machine. Apparently, his machine is a slow machine. So according above table based on Ryzen 5700G, Simplified Saaze is more than six times faster than Hugo in real time. Real time is the time, the user actually has to wait for his results, sometimes also called elapsed time. Simplified Saaze is more than 70-times faster than Hugo w.r.t. CPU time. User time is the time all CPUs together needed to compute your result. The AMD Ryzen 7 5700G CPU has 16 logical cores. All these cores were used by Hugo, only one was used for Simplified Saaze. More comparison of runtimes between Simplified Saaze and other static site generators are here Performance Comparison Saaze vs. Hugo vs. Zola.
Kristian Köhntopp remarks:
Build time is 0.272s, approximately human reaction time - it's instant.
That's the time Hugo needs for refreshing a single page. At the same time, that's the time Simplified Saaze needs to rebuild the entire 1,000 pages.
Credits
Simplified Saaze was created by Elmar Klausmeier.
Saaze was created by Gilbert Pellegrom from Dev7studios. Released under the MIT license.
