Veraxus / nouveau

A simple, clean, cutting-edge WordPress theme framework built on PHP 7.1+ and Zurb Foundation 6.5
http://nouveauframework.org
GNU General Public License v2.0
84 stars 26 forks source link

NOUVEAU Starter Theme

Contributors: Veraxus
Donate link: http://nouveauframework.org/
Author URI: http://nouveauframework.org/
Tags: framework, php5.6
Version: 0.14
Foundation version: 6.3.1
Requires at least: 4.6
Tested up to: 4.7
Stable tag: 0.14
Text Domain: nvLangScope
License: GPL2+ & MIT

NOUVEAU is an open-source, rapid-development theme & plugin framework for WordPress, built on Zurb Foundation 6 and PHP 5.6+. Work fast. Be awesome.

Description

NOUVEAU is NOT a ready-made theme; it is meant as a starting point for developers.

NOUVEAU is a rapid-development framework for WordPress. Unlike other "theme frameworks" NOUVEAU doesn't try to cram everything into a single, overreaching, monolithic theme - instead, the theme is dedicated to presentation work, keeping things clean and easy.

If you want even more features, don't clutter your theme with them... that's what plugins are for! Download NOUVEAU's starter plugins for any features you really need in your project, and customize them quickly and easily. Everything is standardized, simple, clean, and well commented - so you can work fast.

Features

In addition to having very well documented code, you can find a complete Getting Started tutorial at NouveauFramework.org

Installation Instructions

NOTE: NOUVEAU is NOT a ready-made theme and should only be used by developers. it is specifically built to facilitate rapid development and easy maintenance. The code is clean, simple, and very well commented and documented.

Prerequisites for SASS developers

If you want to use the SASS workflow, ensure that you have all of Foundations prerequisites met first. Note that NOUVEAU uses the non-Compass version of Foundation, and is therefore compatible with compilers like libsass.

For full prerequisites, see: http://foundation.zurb.com/docs/sass.html).

To get started, make sure you have npm installed, switch to your NOUVEAU theme directory and run...

  1. npm install to install all dependencies
  2. npm start to begin watching and compiling sass & js

That's all there is to it!

General Installation

To install, simply the copy the NOUVEAU theme folder to your wp-content\themes directory. Before activating, be sure you rename the theme folder and perform a global find-replace for the strings (case sensitive) NOUVEAU, Nouveau, and nouveau, as well as the language scope (nvLangScope).

You can find detailed documentation for NOUVEAU at NOUVEAUFramework.org, and documentation for Zurb Foundation at foundation.zurb.com

Also remember that you can test your own NOUVEAU derivatives by using the WordPress Theme Unit Test.

File Structure

NOUVEAU has an file structure that encourages better organization of your theme.

General page templates (index.php, archive.php, page.php, single.php, etc) as well as critical files like functions.php still go in the theme's root folder. This allows WordPress's core template system to continue working as-is. As a rule, you should keep your PAGE templates here, and organize any fragment/part templates under the parts directory. This keeps the root clean and helps encourage use of clean, organized, reusable template parts.

You find a complete (yet concise) overview of file and folder structure at NOUVEAUFramework.org

Using Without SASS

If you don't want to use SASS, then everything is already compiled for you. Just write your plain CSS in the main style.css file (in the theme root) as you would normally do.

Companion Plugins

WordPress themes (and theme frameworks) should never be monolithic monstrosities. As a result, all the added functionality you could ever want are available separately as neatly packaged "starter" plugins.

Browse NOUUVEAU starter plugins at NOUVEAUFramework.org

Internationalization (I18n)

NOUVEAU comes with all text strings properly scoped for internationalization. To set a custom scope string, you can quickly run a project-wide search and replace for the string nvLangScope and you'll be up and running in no time.