<commit_before>
Introduction to @aaronfischer's Drupal Starter Theme/Boilerplate or base_theme (adaptation of Basic theme)

Basic boasts a clean HTML5 structure with extensible CSS classes and ID's for unlimited
theming possibilities as well as a top-down load order for improved SEO.

Basic's goal is to provide themers the building blocks needed to get their designs up and
running quickly and simply.

Basic is perfect if you want a simple, smart, and flexible theme starter.

Less code spam, more ham.

__________________________________________________________________________________________

Installation

- Basic utilizes SASS for adaptive grids and layouts and general structure of the site.
  It's recommended to use SASS for building out your theme. You are required to download
  the following Ruby Gems and plugins:

  - SASS (http://sass-lang.com/)

- base_theme uses GULP, reference the package.json file for included node_modules

- base_theme is meant to be YOUR theme. To change the name of the theme from 'base_theme' to another name like 'mytheme',
follow these steps (to do BEFORE enabling the theme) :

    - rename the theme folder to 'mytheme'
    - rename basic.info to mytheme.info
    - Edit base_theme.info and change the name, description, project (can be deleted), replace all other instances of "base_theme" ie. [base_theme_tabs] would become [mytheme_tabs]
    - In template.php change each iteration of 'base_theme' to 'mytheme'
    - In theme-settings.php change each iteration of 'base_theme' to 'mytheme'

__________________________________________________________________________________________

What are the files for ?
------------------------

- base_theme.info                => provide informations about the theme, like regions, css, settings, js ...
- block-system-main.tpl.php => template to edit the content
- block.tpl.php             => template to edit the blocks
- comment.tpl.php           => template to edit the comments
- node.tpl.php              => template to edit the nodes (in content)
- page.tpl.php              => template to edit the page
- template.php              => used to modify drupal's default behavior before outputting HTML through
                               the theme
- theme-settings            => used to create additional settings in the theme settings page

In /SASS
-------

- This uses an up to date version of the PRPLrs Boilerplate (https://github.com/prplrs/prpl-boilerplate)

__________________________________________________________________________________________

Changing the Layout

The layout used in Basic is fairly similar to the Holy Grail method. It has been tested on
all major browser including IE (5>10), Opera, Firefox, Safari, Chrome ...
The purpose of this method is to have a minimal markup for an ideal display.
For accessibility and search engine optimization, the best order to display a page is ]
the following :

    1. header
    2. content
    3. sidebars
    4. footer

This is how the page template is buit in basic, and it works in fluid and fixed layout.
Refers to the notes in layout.css to see how to modify the layout.
__________________________________________________________________________________________

Using Gulp

In order to use gulp (http://gulpjs.com/) with basic you will need to install a few programs.

Getting Started

1. Navigate to http://nodejs.org/ and install node.js.
2. Once you have node installed you will be able to use the npm (node package manager) to install the rest.
   In order for gulp to work in terminal we are going to need the gulp cli. Open a new terminal window and type "npm install --global gulp" , this will install the gulp globally. Restart terminal when that is complete and you will now be able to use gulp commands.
3. Install gulp in your project devDependencies: "npm install --save-dev gulp".

How To Use Gulp

1. cd into the base_theme and run "gulp watch".


__________________________________________________________________________________________

UPDATING BASIC

Once you start using basic, you will massively change it until a point where it has nothing
to do with basic anymore. Unlike ZEN, basic is not intended to be use as a base theme for a
sub-theme (even though it is possible to do so). Because of this, it is not necessary to
update your theme when a new version of BASIC comes out. Always see Basic as a STARTER, and
as soon as you start using it, it is not BASIC anymore, but your own theme.

If you didn't rename your theme, but you don't want to be notified when basic has a new version
by the update module, simply delete "project = "basic" in basic.info

__________________________________________________________________________________________

Thanks for using BASIC, and remember to use the issue queue in drupal.org for any question
or bug report:

http://drupal.org/project/issues/basic

Maintainers of base_theme:
* <NAME> - (@aaronfischer) - http://aaronbrycefischer.com
<commit_msg>correcting instances of basic with base_theme<commit_after>
Introduction to @aaronfischer's Drupal Starter Theme/Boilerplate or base_theme (adaptation of Basic theme)

Basic boasts a clean HTML5 structure with extensible CSS classes and ID's for unlimited
theming possibilities as well as a top-down load order for improved SEO.

Basic's goal is to provide themers the building blocks needed to get their designs up and
running quickly and simply.

Basic is perfect if you want a simple, smart, and flexible theme starter.

Less code spam, more ham.

__________________________________________________________________________________________

Installation

- Basic utilizes SASS for adaptive grids and layouts and general structure of the site.
  It's recommended to use SASS for building out your theme. You are required to download
  the following Ruby Gems and plugins:

  - SASS (http://sass-lang.com/)

- base_theme uses GULP, reference the package.json file for included node_modules

- base_theme is meant to be YOUR theme. To change the name of the theme from 'base_theme' to another name like 'mytheme',
follow these steps (to do BEFORE enabling the theme) :

    - rename the theme folder to 'mytheme'
    - rename basic.info to mytheme.info
    - Edit base_theme.info and change the name, description, project (can be deleted), replace all other instances of "base_theme" ie. [base_theme_tabs] would become [mytheme_tabs]
    - In template.php change each iteration of 'base_theme' to 'mytheme'
    - In theme-settings.php change each iteration of 'base_theme' to 'mytheme'

__________________________________________________________________________________________

What are the files for ?
------------------------

- base_theme.info                => provide informations about the theme, like regions, css, settings, js ...
- block-system-main.tpl.php => template to edit the content
- block.tpl.php             => template to edit the blocks
- comment.tpl.php           => template to edit the comments
- node.tpl.php              => template to edit the nodes (in content)
- page.tpl.php              => template to edit the page
- template.php              => used to modify drupal's default behavior before outputting HTML through
                               the theme
- theme-settings            => used to create additional settings in the theme settings page

In /SASS
-------

- This uses an up to date version of the PRPLrs Boilerplate (https://github.com/prplrs/prpl-boilerplate)

__________________________________________________________________________________________

Changing the Layout

The layout used in Basic is fairly similar to the Holy Grail method. It has been tested on
all major browser including IE (5>10), Opera, Firefox, Safari, Chrome ...
The purpose of this method is to have a minimal markup for an ideal display.
For accessibility and search engine optimization, the best order to display a page is ]
the following :

    1. header
    2. content
    3. sidebars
    4. footer

This is how the page template is buit in basic, and it works in fluid and fixed layout.
Refers to the notes in layout.css to see how to modify the layout.
__________________________________________________________________________________________

Using Gulp

In order to use gulp (http://gulpjs.com/) with basic you will need to install a few programs.

Getting Started

1. Navigate to http://nodejs.org/ and install node.js.
2. Once you have node installed you will be able to use the npm (node package manager) to install the rest.
   In order for gulp to work in terminal we are going to need the gulp cli. Open a new terminal window and type "npm install --global gulp" , this will install the gulp globally. Restart terminal when that is complete and you will now be able to use gulp commands.
3. Install gulp in your project devDependencies: "npm install --save-dev gulp".

How To Use Gulp

1. cd into the base_theme and run "gulp watch".


__________________________________________________________________________________________

UPDATING base_theme (Basic)

Once you start using base_theme, you will massively change it until a point where it has nothing
to do with base_theme anymore. Unlike ZEN, base_theme is not intended to be use as a base theme for a
sub-theme (even though it is possible to do so). Because of this, it is not necessary to
update your theme when a new version of base_theme comes out. Always see base_theme as a STARTER, and
as soon as you start using it, it is not base_theme anymore, but your own theme.

If you didn't rename your theme, but you don't want to be notified when basic has a new version
by the update module, simply delete "project = "base_theme" in base_theme.info

__________________________________________________________________________________________

Thanks for using BASIC, and remember to use the issue queue in drupal.org for any question
or bug report:

http://drupal.org/project/issues/basic

Maintainers of base_theme:
* <NAME> - (@aaronfischer) - http://aaronbrycefischer.com

{'fraction_non_alphanumeric': 0.05550581915846016, 'fraction_numerical': 0.002387347060578932, 'mean_word_length': 3.753664302600473, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 23, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '850426', 'n_tokens_mistral': 2461, 'n_tokens_neox': 2390, 'n_words': 1322}