Here's what I had in mind for the requirements of an updated site:
1. Not backed by a live database - everything produced is stored in plain text files for maximum portability.
2. Generates to static HTML site - must support mobile devices.
3. Generates to a PDF document, or at least single text file, eg sbref_v2.txt.
4. Site works with F2 key from SmallBASIC editor.
5. Community / page
- links to external forums like this one
- links to relevant external articles etc
- SUB/FUNC pages can have mailto link for user update suggestions
6. Contact / support page:
- email, etc
7. Reference guide
8. Online examples
- Already served from github
- Need to create separate "repository" for all the other code in the current site
9. ChangeLog page
11. Download page
The current http://smallbasic.github.io
site meets some of these requirements but could meet all with some changes. I don't think a wiki could fulfil all the requirements.
The site is based on the "markdown" format. There are lots of free tools for editing markdown files, apparently ATOM (https://atom.io
) is quite good.
Publishing changes involves using git. There's a bit of a learning curve with git, but well worth the effort. Here's the git side of the site: https://github.com/smallbasic/smallbasic.github.io
- pull requests are (will be) welcome.
The site also uses the default "Jekyll" tool to generate the site (including sorting error). I'd probably switch to some other tool or maybe write something in SmallBASIC.
The good thing about git is it's so easy to "pick up your bat and ball" and move to another host. There are also a multitude of options for serving static web pages, but github seems the best at the moment.