From cdd62a3dbc5d2df0ba6ef08786d6a305a549077b Mon Sep 17 00:00:00 2001 From: Kevin Chabowski Date: Sun, 22 Jan 2012 00:31:41 +0100 Subject: Changed copyright informations, added README.md and INSTALL.md Also we are now Beta :-) --- CONTRIBUTORS | 6 +++ COPYING | 3 ++ INSTALL.md | 58 ++++++++++++++++++++++ README.md | 34 +++++++++++++ ratatoeskr/licenses/ratatoeskr | 2 +- .../src/systemtemplates/backend_login.html | 2 +- .../templates/src/systemtemplates/master.html | 2 +- 7 files changed, 104 insertions(+), 3 deletions(-) create mode 100644 CONTRIBUTORS create mode 100644 COPYING create mode 100644 INSTALL.md create mode 100644 README.md diff --git a/CONTRIBUTORS b/CONTRIBUTORS new file mode 100644 index 0000000..eb521ac --- /dev/null +++ b/CONTRIBUTORS @@ -0,0 +1,6 @@ +People who have worked on r7r_repo +================================== + +If you modified something, feel free to append your name to this list. + +* Kevin Chabowski diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..6fbf75c --- /dev/null +++ b/COPYING @@ -0,0 +1,3 @@ +Ratatöskr is licensed under the X11/MIT license for free software. + +See /ratatoeskr/licenses/ratatoeskr for more details. diff --git a/INSTALL.md b/INSTALL.md new file mode 100644 index 0000000..8d50ddb --- /dev/null +++ b/INSTALL.md @@ -0,0 +1,58 @@ +Installing Ratatöskr +==================== + +Step 0: Requirements +-------------------- + +* Apache Webserver with PHP 5.3 +* These PHP modules (usually installed): gd, hash, session, mysql +* A MySQL server. + +Step 1: Get additional libraries +-------------------------------- + +You need these libraries to run Ratatöskr (it is probably already bundled with these): + +1. Stupid Template Engine (STE) + + Place "stupid_template_engine.php" directly into this directory. + + STE can be found here: + +2. PHP Markdown + + Place "markdown.php" from the archive directly into this directory. + + PHP Markdown can be found here: + +3. kses + + Place "kses.php" from the archive directly into this directory. + + kses can be found at + +Step 2: Copy files to your Webspace +----------------------------------- + +Copy Ratatöskr to your webspace (usually using FTP or SFTP). + +Step 3: Use the setup wizard +---------------------------- + +1. Open your favourite Web browser and surf to `setup.php` of your Ratatöskr installation. + +2. * If the wizard is complaining about some unmet requirements, your server is probably not capable of running Ratatöskr. Sorry :-(. + * If the wizard is complaining about missing directories, create them. + * If the wizard is complaining about missing files, check, if you uploaded everything. + * If the wizard is complaining about missing writing permissions, give the Webserver writing permissions to these directories. + +3. Choose your language. + +4. Enter the MySQL connection details and the desired username and password for the admin account. + +5. Copy the text from the textbox and replace the contents of `/ratatoeskr/config.php` with it. + +Step 4: Delete the setup wizard +------------------------------- + +Delete the file `setup.php`. diff --git a/README.md b/README.md new file mode 100644 index 0000000..aeba9f0 --- /dev/null +++ b/README.md @@ -0,0 +1,34 @@ +Ratatöskr +========= + +Ratatöskr is a flexible Content Management System / Blogging Software for PHP 5.3. + +Why you should use Ratatöskr +---------------------------- + +* You want to modify the appearance of your Website fairly easily. +* You want to publish your content in multiple languages. +* You want to write powerful plugins using a simple API. + +Possible reasons against Ratatöskr +---------------------------------- + +* Early development. So probably a lot of bugs. +* It will probably perform badly on websites with a lot of page hits (many SQL queries per page request). +* You do not want to write your own templates. Because templates define a lot of the page's behaviour, pre-build templates will probably not meet your needs. Ratatöskr focusses on individual page designs. +* You have a large team that manages the website. Ratatöskr has multi-user support, but there are no access control lists or something like that. + +Wish List +--------- + +* Better multi-user support (e.g. access control lists) +* Version management of articles. + +What does "Ratatöskr" mean? +--------------------------- + +> In Norse mythology, Ratatoskr \[*also spelled* **Ratatöskr**\] is a squirrel who runs up and down the world tree Yggdrasil to carry messages between the unnamed eagle, perched atop Yggdrasil, and the wyrm Níðhöggr, who dwells beneath one of the three roots of the tree. + +Source: [http://en.wikipedia.org/wiki/Ratatöskr](http://en.wikipedia.org/wiki/Ratatöskr) + +Because Ratatöskr delivers messages, I thought it was a good name for a CMS / Blog-Software, which also delivers messages / news. Plus squirrels are cool animals :-). diff --git a/ratatoeskr/licenses/ratatoeskr b/ratatoeskr/licenses/ratatoeskr index c0dc1c0..1483299 100644 --- a/ratatoeskr/licenses/ratatoeskr +++ b/ratatoeskr/licenses/ratatoeskr @@ -1,4 +1,4 @@ -Copyright (c) 2011 Kevin Chabowski +Copyright (c) 2011 The Ratatöskr Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in diff --git a/ratatoeskr/templates/src/systemtemplates/backend_login.html b/ratatoeskr/templates/src/systemtemplates/backend_login.html index 4344461..aebed4a 100755 --- a/ratatoeskr/templates/src/systemtemplates/backend_login.html +++ b/ratatoeskr/templates/src/systemtemplates/backend_login.html @@ -9,7 +9,7 @@
-
Ratatöskr::Noctilucent clouds (v. 0.1 α)
+
Ratatöskr::Noctilucent clouds (v. 0.1 β)

diff --git a/ratatoeskr/templates/src/systemtemplates/master.html b/ratatoeskr/templates/src/systemtemplates/master.html index 67207b9..d1328d9 100755 --- a/ratatoeskr/templates/src/systemtemplates/master.html +++ b/ratatoeskr/templates/src/systemtemplates/master.html @@ -24,7 +24,7 @@
- Ratatöskr::Noctilucent clouds (v. 0.1 α) + Ratatöskr::Noctilucent clouds (v. 0.1 β) $user[name] | -- cgit v1.2.3-70-g09d2