| XLAYOUT | xcl-html5-boilerplate |
|---|---|
| Description | Starter Theme built with HTML5 Boilerplate v8.0.0 and XLayout Flexbox Helper |
| Render Engine | Smarty v2 and Smarty v3 |
| Version | 2.3.1 |
| Author | https://github.com/h5bp/html5-boilerplate |
| Author | @gigamaster Nuno Luciano (XCL23) |
| Copyright | 2011-2022 Authors |
| License | MIT |
Apache, Nginx, etc. PHP 7.2.x
MySQL 5.6, MariaDB InnoDB utf8 / utf8mb4
XCL version >= 2.3.1
HTML5-Boilerplate is a professional front-end template for building fast, robust, and adaptable web apps or sites.
Render Engine - Smarty is a template engine for PHP, facilitating the separation of presentation (HTML/CSS) from application logic.
This implies that PHP code is application logic, and is separated from the presentation, making it easier to customize theme and templates.
What is Smarty v2
Smarty 3 Overview
- Flexbox layout
- Responsive theme
- CSS Custom properties
- Localization
- Select a branch from this repo and, from the dropdown button "Code" select Clone or Download zip.
- Extract and upload the folder "theme-name" to your domain, eg.: public/html/themes/theme-name/.
- From the Administration dashboard, activate the Theme (checkbox/select).
X-Update Store
- Login to your the Administration Control Panel » X-Update » Themes
- Select the theme from the Theme Store
- Proceed to automatically download and install.
Branches are used to build independent Themes, Templates, Components and features.
Following the core idea behind the Feature Branch Workflow each theme development
takes place in a dedicated branch instead of the main branch. This encapsulation makes
it easy for multiple themes built with a specific CSS framework or xLayout.
You can clone the repository to create a local copy on your computer.
This gives us access to all branches in this repository.
git clone https://github.com/xoopscube-themes/xcl-html5-boilerplate.git
When you clone a repository, you get the main branch by default.
This means you will have to checkout another branch yourself.
You can easily switch between each branch using GitHub Desktop.
There are two ways to clone a specific branch. You can either:
a) Clone the repository, fetch all branches, and checkout a specific branch. b) Clone the repository and fetch only a single branch.
git clone --branch <branchname> <remote-repo-url>
or using -b an alias for --branch
git clone -b <branchname> <remote-repo-url>
git clone --branch <branch-theme-name> --single-branch <remote-repo-url>
or using -b an alias for --branch
git clone -b <branch-theme-name> --single-branch <remote-repo-url>
This performs the same action as option one, except that the --single-branch option
only fetch the files from the specified Theme branch without fetching other branches.
Learn more...
Technically, themes only require four files : manifesto.ini.php, screenshot.png, style.css, theme.html.
You can create a folder assets for all the assets used in the theme, including images, stylesheets, and javascript files.
The following is an example of the files and folders that can be found in typical XCL theme folder structure.
themes
└───theme-name
│ CHANGELOG.md
│ manifesto.ini.php
│ README.md
│ screenshot.png
│ theme.html
│
├───component
├───css
├───images
├───js
├───language
└───templates
├───d3forum
├───legacy
├───legacyRender
├───message
├───pico
├───profile
└───userThe Themes are released under a BSD or Creative Commons license.
Some Components and Plugins can be released under licenses that
guarantee a certain specific set of freedoms - GPL, MIT, etc.
If find a bug or it's a feature that you think should be implemented please open an issue first,
join or start a new discussion.
Otherwise, you can follow this process:
- Fork the project Fork a Repo
- Create a feature branch :
git checkout -b my_branch - Push your changes to your new branch :
git push origin my_branch - Initiate a pull request About Pull Requests
- Your pull request will be reviewed and hopefully merged :)
Have Fun ^_^/