<commit_before>= LSE Cities TWENTY TWELVE =

* by the LSE Cities team, http://lsecities.net/<commit_msg>added intro notes, code structure notes and copyright info to README<commit_after># LSE Cities WordPress theme

This is the WordPress theme for https://lsecities.net/

## Quick start

Install and activate the theme, create all the required Pods content
types (see the Developer section of the
[LSE Cities Web Handbook](http://web-handbook.docs.lsecities.net/)
for details).

## Contributing

Starting in early 2014, the theme's code is being gradually refactored,
with the aim of achieving the following goals:

* Pods data querying/extraction code totally separate from templates
* Twig templates using HAML syntax (via semanticwp/twig-haml-templating)
* Foundation-based layout
* Grunt as task runner

As components get refactored, the updated code tree is as follows:

* `/assets/scss`: stylesheets
* `/lib/lsecities`: Pods code
* `/lib/lsecities/<pod>/`: code for each Pod
* `/templates/lsecities`: Twig+HAML templates
* `/pods-<pod>.php`: WordPress templates (just thin wrappers around
  the real Twig+HAML templates)
  
### Legacy code structure

* `/stylesheets`: stylesheets (compiled from distinct SCSS source
  repository; the legacy stylesheets use the
  [retired 1140px CSS Grid framework](http://andytaylor.me/2013/04/09/1140px-css-grid-retired/))
* `/javascripts`: theme and vendor Javascript code
* `/includes`: PHP includes
* `/includes/pods/pods/<pod>`: code for each pod
* `/includes/pages/<page>`: code for page types (currently only one-off
  and quarterly newsletters)
* `/includes/plugins`: code ported from previously self-contained WP
  plugins
* `/includes/partials`: Pods code for page components
* `/templates/microsites`: PHP templates for microsites
* `/templates/nav`: PHP templates - all the side navigation partials
* `/templates/pods/<pod>`: PHP templates for individual Pods

## License

Copyright (C) 2011-2014 LSE Cities.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
{'fraction_non_alphanumeric': 0.08593448940269749, 'fraction_numerical': 0.011175337186897881, 'mean_word_length': 4.643478260869565, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 1, 'lorem ipsum': 0, 'www.': 1, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1135305', 'n_tokens_mistral': 786, 'n_tokens_neox': 715, 'n_words': 321}