Botwiki is powered by Pico, which is a very simple CMS running on PHP, the content of the site is created with Markdown. You can install the site with Composer, so one of these should work (provided that you have already installed PHP):
php composer install
Or
php composer.phar install
See the Pico documentation for more details; additionally, if you also want to mess with the look of the site, you will need to install node (which comes with npm).
Then, from the root directory, you can run:
sudo npm install
All the website's content is inside the content
folder. If you only want to update the content, not the look of the page, go to the main folder and run
php -S localhost:5000
The folder structure is very simple and corresponds to the actual structure of the site. So, for example, if you want to add a new Twitter bot, you can navigate to
content/bots/twitterbots/
Then create a new file my_new_bot.md
and the page will be available at
localhost:3000/bots/twitterbots/my_new_bot
Or
botwiki.org/bots/twitterbots/my_new_bot
First run the site as above:
php -S localhost:5000
And then run the gulp tasks, simply with:
gulp
The site will be available with live-reloading at localhost:3000.
If you for some reason get an error about a node package missing, just install it with
sudo npm install NAME_OF_THE_PACKAGE --save-dev
The main idea behind Botwiki is to keep maintaining, contributing and distributing simple. It runs on PHP, which is the most common back-end language, available even on free web hosting sites. Markdown is a fairly simple language that uses only text.
If you'd like to contribute outside of GitHub, you can send an email to [email protected]. Simply copy the content of this file and replace it with relevant information -- and if you'd like, you can also include a screenshot (the width should be 900px, height is not limited, but shouldn't be more than around 500px).