portage/README.md

# Portage — A Theme for Classic Press #
* Contributors: @kjodle
* Tags: black, gray, white, fixed-layout, two-columns, left-sidebar, custom-menu, featured-images, post-formats, theme-options, threaded-comments, translation-ready
* Requires at least: 1.0
* Tested up to: 1.2
* ~~Stable tag: 0.9.1~~ (Not sure how this will work under ClassicPress.)
* License: GPLv2 or later
* License URI: http://www.gnu.org/licenses/gpl-2.0.html

## Description ##

Portage is a spinoff of the Atticus Finch theme I originally designed for use on my WordPress blogs. Because of my dissatisfaction with WordPress and the block editor, I stopped developing it for some time. After transitioning to [ClassicPress](https://www.classicpress.net/), I decided to continue developing it, but changed the name to "Portage" to avoid confusion.

A "portage" is the act of carrying a boat between navigable waters, in this case between the upstream trip I was making with WordPress and the downstream trip I am making with ClassicPress. It seemed appropriate. (It is also the name of the city I live in, which I very much enjoy living in.)

For more information about Atticus Finch please go to http://wiki.kjodle.net/Category:Atticus_Finch_Theme.


## Installation ##

1. In your admin panel, go to Appearance -> Themes and click the 'Add New' button.
1. Upload the zip file.


## Demo Site ##

You can view this theme in action [here](https://classicpress.kjodle.net/).

You can install this theme on your own (non-production) site by logging in via the command line, navigating to the `wp-content/themes` directory and executing the following command:

    git clone https://git.kjodle.net/kjodle/portage

The theme will then appear in your list of available themes.

To check for updates, log in via the command line, and navigate to the `wp-content/themes/portage` directory and execute the following command: 

    git diff ...origin

If the project has not been updated, that command will not ouput anything. If the project has been updated, git will begin displaying what has changed, a page at a time. If you don't want to review that, press `q` to quit.

You can update your installation by executing the following command:

    git pull

Again, please do **not** install this theme on production sites.

## Copyright ##

Portage ClassicPress Theme, Copyright 2021 Kenneth John Odle.
Portage is distributed under the terms of the GNU GPL.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 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 General Public License for more details.

The Atticus Finch theme bundles the following third-party resources:

FontAwesome Icon Font, Copyright 2016 Dave Gandy
License: MIT (http://opensource.org/licenses/mit-license.html)
Source: https://fortawesome.github.io/Font-Awesome/

IM Fell English Font, Copyright 2016 Igino Marini
License: SIL (http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL)
Source: https://www.google.com/fonts/specimen/IM+Fell+English

Superfish jQuery Menu Plugin, Copyright 2015 Joel Birch
License: MIT (http://opensource.org/licenses/mit-license.html)
Source: http://users.tpg.com.au/j_birch/plugins/superfish/

## Notes ##
This theme was *never* fully debugged before I took it live on my own sites. I've slowly been working through both transitioning to Portage and getting rid of bugs. Check the [issues](https://git.kjodle.net/kjodle/portage/issues) page for items I'm in the process of working through. I may also make some notes in the [wiki](https://git.kjodle.net/kjodle/portage/wiki). —Cheers