Skip to content

textpattern/textpattern-default-theme

Repository files navigation

Textpattern CMS default theme

GitHub Sponsors

This project is the source for the default theme that ships as standard with Textpattern CMS. 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).

Features

  1. The code is commented throughout with helpful information to help you learn some of the techniques and tags available within Textpattern.
  2. Current best practices gathered from all over the web - in particular the HTML5 Boilerplate.
  3. Mobile first structure.
  4. Responsive CSS layout adapts to various device screen sizes, from 320px to over 1280px.
  5. Adheres to the Schema.org microdata format.
  6. Includes Sass version of CSS for rapid development.
  7. No external images used at all.
  8. Tested on a wide range of devices, browsers and operating systems.

Supported web browsers

  • Chrome, Edge, Firefox, Safari and Opera the last two recent stable releases.
  • Internet Explorer 11.
  • Firefox ESR latest major point release.

Requirements

Building this repository requires:

Build setup

Installing required tools

The project uses Webpack to run tasks and Sass for CSS pre-processing. First make sure you have a recent version of Node.js installed. You can install Node.js using the installer or package manager.

Installing dependencies

After you have Node.js 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 Webpack and any necessary JavaScript packages.

Building

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 the build:

$ npm run build

Pre-built version

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

The file src/dev-docs/design-patterns-page.textile is a reference you can use when authoring themes, it contains many of the HTML tags (and their equivalent Textile format where available) that should be accounted for in your designs. Paste this code directly into a Textpattern article.

License

Licensed under the GPLv2 license.

Some demo site content is licensed under Creative Commons BY-NC 3.0 (audio: "Moonlight Reprise" from "Irsen's Tale" by Kai Engel) and BY 3.0 (video: "Big Buck Bunny").