Frequently Asked Questions
26 February 2018 | 230 views | Tags: Documentation
What is Tuskfish?
It's a software programme for building websites, also known as a "content management system" or "CMS". It is specifically designed to be simple and lightweight. It provides the publishing tools you actually need and not much else. Think of it as a "micro" CMS.
What type of websites can I make with it?
Tuskfish is suitable for publishing blogs, brochure sites, photo galleries, electronic libraries, audio and video podcasts, collections of content or any combination of the above. Anything where you want to self-publish without direct user input or comment (see below). It's good for small organisations, businesses and personal websites.
How is Tuskfish different to other CMS?
Tuskfish differs from mainstream CMS in that is genuinely:
- Simple. There's one form for adding content to your site and that's it.
- Easy to maintain. It doesn't need to be updated constantly. Stability is a key consideration.
- Security-conscious: Tuskfish was built from the ground up with an explicitly minimised attack surface, rigorous data validation and prepared statements. There's no legacy code.
Like most other modern CMS it is also:
- Flexible: You can publish all sorts of different content - audio, video, text articles, downloads, static pages, whatever - index it with tags and organise it into collections.
- Mobile-first and responsive. Grab any Bootstrap themes you like and integrate them with a few minutes work. You can assign themes on a per-page basis.
- Well documented: Every class and method is documented and a User Manual, Developer Guide and API are available.
Is there anything it is not suited for?
Yep, be aware that only a single user is supported (the administrator). This means that Tuskfish is not suitable for "community" style sites where members of the public can make an account and post their own content. The author considers this a "feature".
But I like tons of features that I will never use?
Fair enough. Try Wordpress, Joomla or Drupal.
Do I need to be a programmer?
No. So long as you can manage a web hosting account, use an FTP client and edit text files you should be ok:
- You can use Tuskfish out of the box without programming knowledge. The default configuration provides a blog stream, where your posts are presented in descending chronological order. It is quite effective.
- If you would like to use Tuskfish for another purpose, such as a brochure site, or you want to customise the themes and templates (layout), you will need a basic knowledge of HTML and CSS (and ideally, Bootstrap).
- To set up custom pages you may need to edit a line or two of PHP code (it's easy and detailed instructions are provided, basically just changing the value of a configuration option here and there).
- Where Tuskfish really shines is if you are you are comfortable writing simple PHP scripts (and I do mean simple). You will find Tuskfish allows you to rapidly build your own custom pages. At heart Tuskfish is essentially a standardised data entry tool. You just need to decide what content you want to retrieve from the database (edit the query conditions) and how to present it (edit HTML templates to suit your own tastes).
Is it free software? Is it open source?
Yes. Tuskfish is distributed under the GNU General Public License Version 2. You can use it, customise it and share it with whoever you like so long as you do not remove the copyright notices (it is a copyright work). You must distribute the code or derivative works under the same license.
But the documentation is copyright?
Yes. I'm not happy with the documentation yet, so I don't want people distributing it for the moment. I might distribute the documentation under an open license later on. We'll see.
What themes did you use for tuskfish.biz?
The front end is the Marketing theme from Bootstrap's creators. It's a commercial theme so I can't share it (but you can buy it and modify it, like I did). On the back end I use an adaptation of the default Bootstrap 4 template, which ships with the default install. The login form is an adaptation of the Bootstrap 4 Sign in theme. I'm also using the Pro (paid) version of Font Awesome 5, but the free version is bundled.
What are the system requirements?
PHP 7.2+ with the following extensions:
- curl extension + a Yubikey hardware token are required for optional two-factor Yubikey authentication.
Where do I get it?
Why don't you have a picture of a tuskfish on the front page?
They're not that easy to photograph and not very common here due to heavy fishing pressure. If you have a nice photo and are willing to let me use it I would really appreciate it!
Copyright, all rights reserved.