bc-marx
v1.2.1-b
Published
The stylish CSS reset.
Downloads
4
Maintainers
Readme
Marx
The stylish CSS reset.
No JavaScript. No Classes. Just raw CSS.
##Is Marx for you? Marx is a CSS stylesheet to be used in any projects (namely small ones). If you don't need the weight of heavy frameworks or you would just like to make an edible website quickly, Marx is perfect for you. It can be used out of the minified box but it can also be customised and styled through the use of HTML classes.
##Key features
- Built atop of Sanitize.css, meaning all browsers render consistently.
- Created using the SASS/Stylus preprocessors (Customise all the variables!).
- Responsive and mobile-friendly.
- Clean, beautiful typography.
- Forms, tables, buttons and navigation.
- Zero classes so it already works with your HTML.
- Drop-dead gorgeous.
- It just works.
Demo
Quick Start
Several quick start options are available:
- Install with Bower:
bower install marx
(recommended). - Use the latest Marx CDN
<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="https://cdn.rawgit.com/mblode/marx/master/css/marx.min.css">
- Source code.
- Download the latest release.
- Clone the repo:
git clone https://github.com/mblode/marx.git
.
if you have cloned the repo or downloaded from .zip, there are a few steps you must take within the terminal.
- Change directory:
cd marx
. - Install node modules:
npm install
. - Install scss-lint Ruby gem:
gem install scss-lint
. - To run gulp server:
gulp
. - To run build process:
gulp build
.
Optional: To run server or build using Stylus instead of SASS, then try
gulp stylus
andgulp build styus
, respectively.
Running Github Pages
The gh-pages branch is built using Jekyll and must therefore be install with gem install jekyll
.
- Checkout in to gh-pages:
git checkout gh-pages
. - Install marx dependency:
bower install
. - Run jekyll:
jekyll serve
. - Open in browser:
localhost:4000/marx/
.
What's Included
These are the files that are generated from bower install marx
.
├── README.md
├── bower.json
├── css
│ ├── marx.css
│ ├── marx.css.map
│ ├── marx.min.css
│ └── marx.min.css.map
└── scss
│ ├── _buttons.scss
│ ├── _config.scss
│ ├── _forms.scss
│ ├── _html.scss
│ ├── _navigation.scss
│ ├── _sanitize.scss
│ ├── _tables.scss
│ ├── _typography.scss
│ ├── _variables.scss
│ └── marx.scss
└── styl
├── _buttons.styl
├── _config.styl
├── _forms.styl
├── _html.styl
├── _navigation.styl
├── _sanitize.styl
├── _tables.styl
├── _typography.styl
├── _variables.styl
└── marx.styl
Documentation
Basic HTML Template
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Marx Template</title>
<!-- Marx CSS -->
<link rel="stylesheet" href="css/marx.min.css">
</head>
<body>
<!-- main is the container -->
<main>
<!-- Navigation -->
<nav>
<ul>
<li><a href="#"><b>First</b></a></li>
<li><a href="#">Second</a></li>
<li><a href="#">Third</a></li>
<li><a href="#">Fourth</a></li>
</ul>
</nav>
<!-- article -->
<article>
<h1>Article</h1>
</article>
<!-- aside -->
<aside>
<h1>Aside</h1>
</aside>
<!-- section -->
<section>
<h1>Section</h1>
</section>
<!-- footer -->
<footer>
<p>© Matthew Blode 2015</p>
</footer>
</main>
</body>
</html>
Contributing to Marx
Pull requests are the way to go.
Creators
Matthew Blode
License
MIT © Matthew Blode