Canonizer.com is a wiki system that solves the critical liabilities of Wikipedia. It solves petty "edit wars" by providing contributors the ability to create and join camps and present their views without having them immediately erased. It also provides ways to standardize definitions and vocabulary, especially important in new fields.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Things you need on your machine to install this project
Git: You should have git installed on your machine, If you do not have git installed on your system please visit https://www.atlassian.com/git/tutorials/install-git follow instructions and install it.
Composer: Composer is an application-level package manager for the PHP programming language that provides a standard format for managing dependencies of PHP software and required libraries.
To install composer visit - https://getcomposer.org/
Clone Project from github - https://github.com/the-canonizer/canonizer.2.0 Command: git clone https://github.com/the-canonizer/canonizer.2.0.git
Run composer after connecting to your repository root directory (where composer.phar exists) php composer.phar update
composer will install all dependencies and all laravel packages.
Database & its Configuration path to DB - database/canonizer2.sql
Composer should have created .env file for you where you have to set the DB credentials once you upload database to your phpmyadmin.
Note: If .env file is not being generated automatically, you can create it by copying .env.example
Now you are ready to go localhost/project_directory/public it should lead you to home page now.
You can set virtual host if you want to avoid "public" in url.
Apache comes installed with the Mac OS, but not MySQL. An easy installation package is available online here: https://dev.mysql.com/doc/refman/5.6/en/osx-installation-pkg.html
You can use MySQL Workbench as a GUI interface to set up your database. Workbench us available here: https://dev.mysql.com/downloads/workbench/
Sourcetree is the best GUI interface for Git on Mac. You can download it here: https://downloads.atlassian.com/software/sourcetree/Sourcetree_2.7.1d.zip?_ga=2.264683343.1572218970.1521135631-982429275.1520535016
When setting up your local version of canonizer, you'll first need to create the canonizer.2.0 directory as a subdirectory of /Library/WebServer/Documents/ and then place the .env file in the canonizer.2.0 directory.
Open Sourcetree. Under the "File" menu option, select "New." Select "Clone from URL."
Source URL: https://github.com/the-canonizer/canonizer.2.0.git Destination Path: /Library/WebServer/Documents/canonizer.2.0 Name: canonizer.2.0
Click "Advanced Options" and select the branch you want to clone.
Open Terminal. You'll need to change permissions on all files in the canonizer.2.0 directory and subdirectory. The following two commands will allow you to do that: cd /Library/WebServer/Documents/canonizer.2.0 sudo chmod -R 777
Install and update composer using the method described above.
To enable file upload feature need to activate storage as documented by laravel using command php artisan storage:link. For more info visit - https://laravel.com/docs/5.6/filesystem
For DB changes: create migration for any db change. Do not forget to add migration file in your commit.
All dependencies should be added through composer only.
create your own branch for task you have done with "your name or username" (developer name or username) example: git checkout -b dev-jackson
Commit changes
push the branch git push origin dev-jackson
Download Xampp having php > = 7 from link https://www.apachefriends.org/download.html
After download install Xampp in your system lets say c://Xampp.
After installing xampp open xampp application and start apache server and mysql server
clone the canonizer code to xampp/htdocs directory from the link mentioned above
create a database in your mysql, set the same name in .env file and run the migrations in the project( go to xampp/htdocs/canonizer in terminal and run php artisan migrate)
Thats it! Canonizer will work on your local system
Update your linux system with following command
sudo apt-get updateInstall Apache Server
sudo apt-get install apache2 apache2-doc apache2-npm-prefork apache2-utils libexpat1 ssl-cert
Install Mysql-server
sudo apt-get install mysql-server mysql-client libmysqlclient-dev
Install php ( php 7 or the latest version of php)
sudo apt-get install libapache2-mod-php7.0 php7.0 php7.0-common php7.0-curl php7.0-dev php7.0-gd php-pear php-imagick php7.0-mcrypt php7.0-mysql php7.0-ps php7.0-xsl
Install phpmyadmin(Optional as it provide GUI to access database)
sudo apt-get install phpmyadmin
clone the canonizer code to /var/www/html directory from the link mentioned above
create a database in your mysql, set the same name in .env file and run the migrations in the project( go to var/www/html/canonizer in terminal and run php artisan migrate)
Quick fix is:
https://github.com/the-canonizer/canonizer.2.0/tree/development-50/database
canonizer2.sql
c_threads.sql
replies.sql
Then copy the rest of the migrations to a folder then apply it (Other than problematic one)
Ashutosh indicated "Schema is already in the migrations. But some files are unordered I believe"
and: "I think we need to delete user_id (migrations) to the user migration table then it'll fix the issue. But need to test that. I am travelling tomorrow. Will try to look into this today "
Thats it!
There are two files in public directory robots.txt and robots-production.txt. Copy the content of robots-production.txt file in robots.txt file and remove the robots-production.txt file to enable robots file.
Thank you for considering contributing to the Canonizer!
MIT License
Copyright (c) 2006-2018 Canonizer.com
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 the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.