Drupal.cz community website

Build status

Branch	Build status	Dev site	HTTP Basic auth
Master		http://stage.drupal.cz	drupal / cz
Develop		http://dev.drupal.cz	drupal / cz

Contents

• blt/ - Settings for Acquia BLT.
• config/ - Exported Drupal configutation.
• console/ - Cache folder for Drupal Console. ()
• docroot/ - Website root directory.
• drush/ - Drush aliases and other rutiens.
• hooks/ - Acquia cloud hooks. (See https://docs.acquia.com/cloud/manage/cloud-hooks )
• patches/ - Our custom patches. (But we prefer linking drupal.org.)
• reports/ - PHP Unit results.
• tests/ - Collection of tests for Travis CI and local development.
• .gitignore - Gitignore - be sure to check your own local gitignore so you don't commit your IDE's tmp files.
• .travis.yml - Travis CI test suite configuration.

Requirements

Pokud používáte Lando

• Nainstalujte si Lando, https://docs.devwithlando.io/installation/system-requirements.html

• V adresáři projektu spusťte Lando

  lando start

Inicializacie prostředí pro vývoj frontendu (kompilování SASS na CSS)

• Spusťte lando composer run init-theme

NEBO

• Zkopírujte si soubor sass.lando.local.yml do .lando.local.yml

• Zkopírujte si soubor default.config_local.json do config_local.json

• Spusťte lando rebuild -y

Kompilace SASS na CSS

• Přepněte se do adresáře tématu cd docroot/themes/custom/dcz_theme

• Pro kompilaci SASS na CSS použijte lando gulp css

• Pro kompilaci všeho a čekání na změny použijte lando gulp

Pokud používáte jiné vývojové prostředí

• You need PHP ^7.2
• Install composer: https://getcomposer.org/doc/00-intro.md
• Install Drush version 8: http://docs.drush.org/en/master/install/
• We are using Acquia BLT which has it's own set of requirements.
  • Check out https://github.com/acquia/blt
  • Not all are needed for basic tasks.
  • Try blt vm if you don't want to alter your system.
  • See more at https://github.com/acquia/blt

Getting the site up and running.

• Get your copy of the code:
  • Fork this repository. ( https://help.github.com/articles/fork-a-repo/ )
  • Clone your repository.
  • git clone git@github.com:[YOUR-NAME]/drupalcz.git drupalcz
  • cd drupalcz
• Prepare your database and fill the credentials into your new local config.
  • cp docroot/sites/default/settings/default.local.settings.php docroot/sites/default/settings/local.settings.php
  • edit this config: docroot/sites/default/settings/local.settings.php
• Install the site (it will use the Drupal.cz distribution).
  • composer install
  • If this is first time you are setting up BLT, run

    ./vendor/bin/blt blt:init:shell-alias
    source ~/.bash_profile

  • blt setup:git-hooks (Learn more about BLT: https://blt.readthedocs.io/)
  • cd docroot
  • drush si minimal --existing-config
  • Login to new site:
  • read admin password from console, or
  • drush uli
  • or drush upwd admin vase_heslo
• If you want to have some default content for your development, import it
  • drush dcdi --force update
  • drush cr

Contributing

• We are using GitFlow(https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow/) branching strategy
• Learn how to manage config: https://www.youtube.com/watch?v=WsMuQFO8yGU
• You need to create feature/NAME branch for each issue
• Commit your changes. ( http://chris.beams.io/posts/git-commit/ )
• Test your work by running:
  • blt validate
  • blt tests
• After you finish work on issue, create pull request against develop branch.
• Create pull request. https://help.github.com/articles/creating-a-pull-request/