The wesnoth.fsf.hu Project

Magyar

A wesnoth.fsf.hu portál fájljai.

Telepítés

Drupal 6

A telepítéshez szükség van composerre. A következő lépéseket kövesd:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal6
composer.phar install
cd web
sudo update-alternatives --set php /usr/bin/php5.6
../vendor/bin/drush.phar site-install default --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal6_ --locale=hu
../vendor/bin/drush.phar pm-enable advanced_forum author_pane comment_subject login_destination pathauto token transliteration image bbcode mass_contact privatemsg smileys captcha taxonomy_image wysiwyg views votingapi ctools

Megjegyzés: mbstring hiba esetén tedd a sites/default/default.settings fájlba:

ini_set('mbstring.http_input', 'pass');
ini_set('mbstring.http_output', 'pass');

Drupal 7

A telepítéshez szükség van composerre és drushra. A következő lépéseket kövesd:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal7
composer.phar install
cd web
drush site-install standard --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal7_ --locale=hu
drush pm-enable profile image
drush pm-enable $(ls sites/all/modules/contrib/)

Drupal 8

A telepítéshez szükség van composerre és drushra. A következő lépéseket kövesd:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal8
composer.phar install
cd web
drush site-install wesnoth_hu --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal8_ --locale=hu

Frissítés

Drupal 6-ról 7-re

Telepítsük az előző fejezetben leírtak alapján a 6 és 7-es verziót. A site-aliases mappában másoljuk le a sample fájlt, majd töltsük ki a Drupal 7 oldal megfelelő adataival. Ezután adjuk ki a következő parancsokat:

cd drupal7/web
composer.phar remove drupal/login_destination drupal/taxonomy_image drupal/wysiwyg
cd ../../drupal6/web
../vendor/bin/drush site-upgrade --alias-path=../../site-aliases/ @wesnoth-d7
cd ../../drupal7/web
composer.phar require drupal/login_destination drupal/taxonomy_image drupal/wysiwyg
drush pm-uninstall login_destination
drush pm-enable captcha image auto_nodetitle download_count login_destination token pathauto transliteration bbcode mass_contact privatemsg privatemsg_limits privatemsg_filter privatemsg_roles pm_block_user pm_email_notify image_captcha taxonomy_list wysiwyg views_ui votingapi
drush updatedb
drush role-add-perm 'Adminisztrátor' 'edit own comments,administer fields,administer image styles,administer modules'
drush cron

Megjegyzés: három modul nincs engedélyezve a frissítés előtt, mert gondot okoz:

• login_destination: nincs upgrade path a 6-os és a 7-es verzió között, uninstall és enable kell
• taxonomy_image: az image field nem létezik upgrade közben, az upgrade után kell engedélyezni
• wysiwyg: ismert hiba, az upgrade során a modul disabled állapotban van, ezért errort dob

Drupal 6-ról 8-ra

FONTOS! A Drupal 6-ról 8-ra frissítés sokáig tervben volt, azonban a 7-re frissítés egyszerűbb és gyorsabb, ezért a portálnál ezt a módszert választottuk.

drush.phar pm-enable -y migrate_upgrade migrate_plus migrate_tools
drush.phar migrate-upgrade --legacy-db-url=mysql://USER:PASSWORD@HOST/DATABASE --legacy-root=/var/www/filesystem --legacy-db-prefix=drupal_
drush.phar php-script profiles/wesnoth_hu/wesnoth_hu_postmigration.php

Dokumentáció

A docs/weshu-d8.tjp fájl egy TaskJuggler projekt fájl. A segítségével HTML készíthető belőle.

A docs/specifikacio.adoc fájl egy AsciiDoc fájl, az Asciidoctorral HTML készíthető belőle.

A docs/mergedocs.sh fájl egy bash script, ami a fenti kettő generálást elvégzi, és az eredményüket összefésüli egy index.html fájlba.

English

Project related files for the wesnoth.fsf.hu site

Installation

Drupal 6

For the installation you need composer. Follow these steps:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal6
composer.phar install
cd web
sudo update-alternatives --set php /usr/bin/php5.6
../vendor/bin/drush.phar site-install default --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal6_ --locale=hu
../vendor/bin/drush.phar pm-enable advanced_forum author_pane comment_subject login_destination pathauto token transliteration image bbcode mass_contact privatemsg smileys captcha taxonomy_image wysiwyg views votingapi ctools

Note: in case of an mbstring error put the following into sites/default/default.settings file:

ini_set('mbstring.http_input', 'pass');
ini_set('mbstring.http_output', 'pass');

Drupal 7

For the installation you need composer and drush. Follow these steps:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal7
composer.phar install
cd web
drush.phar site-install wesnoth_hu --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal7_ --locale=hu
drush pm-enable profile
drush pm-enable $(ls sites/all/modules/contrib/)

Drupal 8

For the installation you need composer and drush. Follow these steps:

git clone git@github.com:wesnoth-hu/project.git
cd project/drupal8
composer.phar install
cd web
drush.phar site-install wesnoth_hu --db-url=mysql://USER:PASSWORD@HOST/DATABASE --db-prefix=drupal8_ --locale=hu

Upgrade

From Drupal 6 to 7

Install both instances as discribed in the last section. Then we should copy and modify hte sample file in the site-aliases folder with the correct parameters of the Drupal 7 site. Then step into the Drupal 7 folder and issue the site-upgrade command:

cd drupal7/web
composer.phar remove drupal/login_destination drupal/taxonomy_image drupal/wysiwyg
cd ../../drupal6/web
../vendor/bin/drush site-upgrade --alias-path=../../site-aliases/ @wesnoth-d7
cd ../../drupal7/web
composer.phar require drupal/login_destination drupal/taxonomy_image drupal/wysiwyg
drush pm-uninstall login_destination
drush pm-enable captcha image auto_nodetitle download_count login_destination token pathauto transliteration bbcode mass_contact privatemsg privatemsg_limits privatemsg_filter privatemsg_roles pm_block_user pm_email_notify image_captcha taxonomy_list wysiwyg views_ui votingapi
drush updatedb
drush role-add-perm 'Adminisztrátor' 'edit own comments,administer fields,administer image styles,administer modules'
drush cron

Note: the three modules are not enabled before the upgrade, because they cause issues:

• login_destination: there is no upgrade path from 6 to 7, it requires an uninstall and an enable
• taxonomy_image: the image field does not exist during the upgrade, it needs to be enabled after the upgrade
• wysiwyg: known error, during the upgrade the module is disabled and therefore it throws an error

From Drupal 6 to 8

IMPORTANT! The Drupal 6 to 8 upgrade was planned for a long time, but upgrading to 7 seems easier and faster, therefore we choose that one for the site.

drush.phar pm-enable -y migrate_upgrade migrate_plus migrate_tools
drush.phar migrate-upgrade --legacy-db-url=mysql://USER:PASSWORD@HOST/DATABASE --legacy-root=/var/www/filesystem --legacy-db-prefix=drupal_
drush.phar php-script profiles/wesnoth_hu/wesnoth_hu_postmigration.php

Documentations

The docs/weshu-d8.tjp file is a TaskJuggler project file. You can compile it to HTML.

The docs/specifikacio.adoc file is an AsciiDoc file, you can use Asciidoctor to create a HTML page.

The docs/mergedocs.sh file is a bash script which executes the two conversions above, and merges them into an index.html file.