<commit_before>PressGang WordPress Manager
===========================

PressGang is a Django application that makes it easy to manage multiple
WordPress installations on a single server.  Using it, you can install blogs,
lock them down and perform easy rollbacks to previous versions.

PressGang can install any blogs using WordPress 3.0 or greater, and can still
perform some basic management tasks on older blogs.  For the moment, it is only
capable of dealing with blogs installed in subdirectories, and does not support
subdomain installations.

Installation
------------

**Installation**

        git clone git://github.com/cilcoberlin/pressgang.git
        python pressgang/setup.py install
        rm -R pressgang

**File Structure**

1. Create a directory that is writable by your app to contain blog versions.
2. Create a directory that is writable by your app to contain per-blog Apache configuration files.
3. Copy the contents of the media/ directory to your site's media directory.

**Settings**

1. Add 'pressgang' to settings.INSTALLED_APPS.
2. Include 'pressgang.urls' in your URL configuration.
3. If you're running PressGang as your only app, set values for `LOGIN_URL` AND `LOGOUT_URL` to 'YOUR_PRESSGANG_URL/accounts/login' and 'YOUR_PRESSGANG_URL/accounts/logout', respectively.
4. Provide values for the settings below.

`PRESSGANG_APACHE_CONFIGS_DIR`
A string of the absolute path to the directory that you created to hold per-blog Apache configuration files.

`PRESSGANG_APACHE_DOCUMENT_ROOT`
A string that should match the value of Apache's DocumentRoot.

`PRESSGANG_APACHE_RELOAD_CMD`
A string of the full command that will gracefully reload Apache on your server.

`PRESSGANG_BACKUPS_DIR`
A string of the absolute path to the directory that you created to hold the blog backup files.

`PRESSGANG_DB_ADMIN_PASSWORD`
A string of the password for the admin use for your MySQL installation.

`PRESSGANG_DB_ADMIN_USER`
A string of the username of the admin user for your MySQL installation.

`PRESSGANG_INSTALLERS`
An optional list containing strings of the full paths to any custom installer
packages that you have created.  Each item in the list must be on your Python path.

`PRESSGANG_MYSQL_PATH`
The full path to your mysql executable.

`PRESSGANG_MYSQLDUMP_PATH`
The full path to your mysqldump executable.

`PRESSGANG_SERVER_BASE`
A string of the network location (i.e., 'subdomain.server.tld') of the server hosting your blogs.

**Permissions**

Any user that you add to your site must have certain permissions to be able
to use PressGang.  The possible permissions, given as how they show up in the
list of permissions available to users and groups, are:

*pressgang | blog | can install blogs*
Allows the user to install blogs

*pressgang | blog | can manage blogs*
Allows the user to make changes to the blogs.

*pressgang | blog | can view blogs*
Allows the user to view a list of all installed blogs.

Generally, a user will have all of the above permissions, but it is possible to
restrict the permissions if desired.<commit_msg>More readme tweaks.<commit_after>PressGang WordPress Manager
===========================

PressGang is a Django application that makes it easy to manage multiple
WordPress installations on a single server.  Using it, you can install blogs,
lock them down and perform easy rollbacks to previous versions.

PressGang can install any blogs using WordPress 3.0 or greater, and can still
perform some basic management tasks on older blogs.  For the moment, it is only
capable of dealing with blogs installed in subdirectories, and does not support
subdomain installations.

Installation
------------

**Installation**

        git clone git://github.com/cilcoberlin/pressgang.git
        python pressgang/setup.py install
        rm -R pressgang

**File Structure**

1. Create a directory that is writable by your app to contain blog versions.
2. Create a directory that is writable by your app to contain per-blog Apache configuration files.
3. Copy the contents of the media/ directory to your site's media directory.

**Settings**

1. Add 'pressgang' to settings.INSTALLED_APPS.
2. Include 'pressgang.urls' in your URL configuration.
3. If you're running PressGang as your only app, set values for `LOGIN_URL` AND `LOGOUT_URL` to 'YOUR_PRESSGANG_URL/accounts/login' and 'YOUR_PRESSGANG_URL/accounts/logout', respectively.
4. Provide values for the settings below.

`PRESSGANG_APACHE_CONFIGS_DIR`
A string of the absolute path to the directory that you created to hold per-blog Apache configuration files.

`PRESSGANG_APACHE_DOCUMENT_ROOT`
A string that should match the value of Apache's DocumentRoot.

`PRESSGANG_APACHE_RELOAD_CMD`
A string of the full command that will gracefully reload Apache on your server.

`PRESSGANG_BACKUPS_DIR`
A string of the absolute path to the directory that you created to hold the blog backup files.

`PRESSGANG_DB_ADMIN_PASSWORD`
A string of the password for the admin use for your MySQL installation.

`PRESSGANG_DB_ADMIN_USER`
A string of the username of the admin user for your MySQL installation.

`PRESSGANG_INSTALLERS`
An optional list containing strings of the full paths to any custom installer
packages that you have created.  Each item in the list must be on your Python path.

`PRESSGANG_MYSQL_PATH`
The full path to your mysql executable.

`PRESSGANG_MYSQLDUMP_PATH`
The full path to your mysqldump executable.

`PRESSGANG_SERVER_BASE`
A string of the network location (i.e., 'subdomain.server.tld') of the server hosting your blogs.

**Permissions**

Any user that you add to your site must have certain permissions to be able
to use PressGang.  The possible permissions, given as how they show up in the
list of permissions available to users and groups, are:

`pressgang | blog | can install blogs`
Allows the user to install blogs

`pressgang | blog | can manage blogs`
Allows the user to make changes to the blogs.

`pressgang | blog | can view blogs`
Allows the user to view a list of all installed blogs.

Generally, a user will have all of the above permissions, but it is possible to
restrict the permissions if desired.
{'fraction_non_alphanumeric': 0.058469055374592835, 'fraction_numerical': 0.0029315960912052116, 'mean_word_length': 4.512567324955117, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2907883', 'n_tokens_mistral': 1694, 'n_tokens_neox': 1657, 'n_words': 855}