Textpattern CMS default theme
This project is the source for the default theme that ships as standard with Textpattern CMS as of v4.7.0 onwards. It is intended as a starting point for new users learning the Textpattern CMS for the first time or existing users that want to adapt their current code for modern standards, and is not intended as a finished production theme (though you could use it as such if you want to).
- The code is commented throughout with helpful information to help you learn some of the techniques and tags available within Textpattern.
- Current best practices gathered from all over the web - in particular the HTML5 Boilerplate.
- Mobile first structure.
- Responsive CSS layout adapts to various device screen sizes, from 320px to over 1280px.
- Adheres to the Schema.org microdata format.
- Includes Sass version of CSS for rapid development.
- No images used at all.
- Tested on a wide range of devices, browsers and operating systems.
Supported web browsers
- Internet Explorer 11.
- Chrome, Edge, Firefox, Safari and Opera the last two recent stable releases.
Building this repository requires:
Installing required tools
The project uses Grunt to run tasks and Sass for CSS pre-processing. First make sure you have base dependencies installed: Node.js and Grunt. You can install Node using the installer and Grunt with npm:
$ npm install -g grunt-cli
Consult the Grunt documentation for more instructions if necessary. You might need to use
sudo npm install -g grunt-cli instead when installing on certain Unix-based systems.
After you have the base dependencies taken care of, you can install the project's dependencies. Navigate to the project's directory, and run the dependency manager:
$ cd textpattern-default-theme $ npm install
npm installs Node modules for Grunt. You might need to use
sudo npm install instead when installing on certain Unix-based systems.
This repository hosts sources and needs to be built before it can be used. After you have installed all dependencies, you will be able to run tasks using Grunt, including building:
$ grunt @task@
@task@ is either
buildtask builds the project.
watchtask will launch a task that watches for file changes; the project is then automatically built if a source file is modified.
We provide a pre-built version of the theme files within the
dist directory in case you don't want to build it yourself.
Design patterns Textile/HTML reference page
src/dev/design-patterns-page.textile is a reference you can use when authoring themes, it contains many of the HTML5 tags (and their equivalent Textile format where available) that should be accounted for in your designs. Paste this code directly into a Textpattern article. Note: some HTML5 tags may not be fully supported by all browsers, for the latest compatibility details please visit caniuse.
Licensed under the GPLv2 license.