7171
7272 <!-- Main -->
7373 < div class ="b0_12 b4_14 b4_push_01 ">
74-
74+
7575 < div class ="p-3x ">
76-
76+
7777 < div class ="block ">
7878 < h1 > Installation</ h1 >
7979 < p class ="intro "> A modular, updatable, easy to use SCSS Framework</ p >
8080 < p > CastleCSS is built with easy updating in mind.< br />
81- You can download the Full package and make adjustments as long as you don't update the dependencies (core, buttons, notifications, etc).</ p >
81+ You can do anything as long as you don't edit the dependencies (core, buttons, notifications, etc).</ p >
8282 < p > When you do adjust the dependencies, you will lose all adjustments with an update.</ p >
83- < p > There are a few ways to install:
84- < ul >
85- < li > Install via < a href ="www.npmjs.com/ "> npm</ a > </ li >
86- < li > < a href ="https://www.npmjs.com/package/require "> Require</ a > it in your own npm package</ li >
87- < li > Download it below</ li >
88- </ ul >
83+ </ div >
84+ < div class ="block block-invert p-3x pt-2x ">
85+ < h2 > Boilerplate</ h2 >
86+ < p >
87+ The < strong > easiest way</ strong > to start is with the CastleCSS Boilerplate
88+ CastleCSS is a modular, updatable and easy to use HTML and SCSS framework. Use this Boilerplate to get started with your project right away!
89+ < div >
90+ < a class ="github-button " href ="https://github.com/castlecss/castlecss-boilerplate " aria-label ="Watch castlecss/castlecss-boilerplate on GitHub "> Watch</ a >
91+ < a class ="github-button " href ="https://github.com/castlecss/castlecss-boilerplate " aria-label ="Star castlecss/castlecss-boilerplate on GitHub "> Star</ a >
92+ </ div >
8993 </ p >
94+ < h3 > What's included?</ h3 >
95+ < ul >
96+ < li > A simple and mobile-friendly HTML5 template to kickstart your website</ li >
97+ < li > Configuration for Grunt, to easily compile and minify your Sass files</ li >
98+ < li > < a href ="https://github.com/CastleCSS/castlecss-core " target ="_blank "> castlecss-core</ a > </ li >
99+ < li > < a href ="https://github.com/CastleCSS/castlecss-buttons " target ="_blank "> castlecss-buttons</ a > </ li >
100+ < li > < a href ="https://github.com/CastleCSS/castlecss-notifications " target ="_blank "> castlecss-notifications</ a > </ li >
101+ </ ul >
102+ < h3 >
103+ Installation
104+ </ h3 >
105+ < div >
106+ < a class ="github-button " href ="https://github.com/castlecss/castlecss-boilerplate/archive/master.zip " aria-label ="Download castlecss/castlecss-boilerplate on GitHub "> Download</ a >
107+ </ div >
108+
90109 </ div >
91110 < div class ="block ">
92- < h2 > Setup</ h2 >
93- < p > Your project should have a setup similair to this (included in the Full package):< br />
94- With this you make sure your own variables overwrite the castle-core variables and your setup is still updatable.
111+ < h2 > Structure</ h2 >
112+ < p > The basis structure for your website should look similar like this (included in the boilerplate):< br />
95113 </ p >
96114 < code class ="code-structure ">
97- | Your project /< br />
115+ | Project directory /< br />
98116 |< br />
99- |-- scss/ < br />
100- | |-- /* Custom project specific files here */< br />
101- | |-- Main.scss< br />
102- | |< br />
103117 |-- node_modules/< br />
104- | | < br />
105- | | /* CastleCSS files included automatically here */< br />
106- | | castlecss-core/< br />
107- | | castlecss-buttons/< br />
108- | | castlecss-etc ;)/< br />
118+ | | -- castlecss-core/< br />
119+ | | --castlecss-buttons/< br />
120+ | | --castlecss-notifications/< br />
121+ | |< br />
122+ |-- scss/< br />
123+ | |-- main.scss< br />
124+ | |-- variables.scss< br />
125+ | |< br />
126+ |-- img/< br />
127+ |-- dist/< br />
128+ | |-- styles.min.css< br />
129+ | |-- styles.min.map< br />
130+ | |< br />
131+ |-- index.html< br />
132+ |-- Gruntfile.js< br />
133+ |-- package.json< br />
109134 </ code >
110135 < br />
111- < p > Your main.scss should have a setup similair to this (included in the Full package):</ p >
136+ < h2 > Main.scss</ h2 >
137+ < p > Your main.scss should have a setup similair to this (included in the boilerplate):</ p >
112138 < pre class ="brush: sass; ">
113- /* core variable files */
139+ /* CastleCSS Core variables */
114140 @import "node_modules/castlecss-core/sass/variables";
115- /* Your own variables so they overwrite the core */
141+
142+ /* Your variables */
116143 @import "variables";
117- /* rest of core files */
144+
145+ /* Remaining Core files and other CastleCSS modules */
118146 @import "node_modules/castlecss-core/sass/main";
147+ @import "node_modules/castlecss-buttons/sass/main";
148+ @import "node_modules/castlecss-notifications/sass/main";
149+
150+ /* Include your own files below this line
151+ -------------------------------------- */
152+
119153
120- /* Include your own files below this line
121- --------------------------------------
122- */
154+
155+ /* --------------------------------------
156+ Include your own files above this line */
157+
158+ @import "node_modules/castlecss-core/sass/base/utility";
159+ @import "node_modules/castlecss-core/sass/base/utility_spacers";
123160 </ pre >
124- </ div >
125- < div class ="block ">
126- < h2 > Starting your project</ h2 >
127- < p > CastleCSS uses GruntJS to build projects.</ p >
128161
129- < p > If you haven't used Grunt before, be sure to check out the < a href ="http://gruntjs.com/getting-started " target ="_blank "> Getting Started</ a > guide.</ p >
130162
131- < p > Start the project for the first time by going to your project folder in your terminal.</ p >
132- < ul >
133- < li > Run < code > npm install</ code > to install all files</ li >
134- < li > Run < code > grunt</ code > to start running the project. If will automatically watch for changes in your SCSS and compile it to CSS</ li >
135- < li > Or use < code > grunt create_css</ code > to create your CSS manually</ li >
136- </ ul >
137- </ div >
138- < div class ="block ">
139- < div class ="g ">
140- < div id ="starter " class ="b0_12 ">
141- < div class ="block block-invert p-3x pt-2x ">
142- < h2 > Full package</ h2 >
143- < p >
144- < div >
145- < a class ="github-button " href ="https://github.com/castlecss/castlecss " aria-label ="Watch castlecss/castlecss-core on GitHub "> Watch</ a >
146- < a class ="github-button " href ="https://github.com/castlecss/castlecss " aria-label ="Star castlecss/castlecss-core on GitHub "> Star</ a >
147- < a class ="github-button " href ="https://github.com/castlecss/castlecss/archive/master.zip " aria-label ="Download castlecss/castlecss on GitHub "> Download</ a >
148- </ div >
149- </ p >
150- < h3 > Installation</ h3 >
151- < p >
152- < code > npm install castlecss</ code > < br />
153- </ p >
154- < h3 > Updating</ h3 >
155- < p class ="alert ">
156- < strong > NOTE:</ strong > Only update the dependencies so you don't overwrite your own SCSS files. If you do update the Full package you'll overwrite everything. < br />
157- We recommend downloading the full package and updating the dependencies like:
158- </ p >
159- < p >
160- < code > npm update castlecss-core</ code > < br />
161- < code > npm update castlecss-buttons</ code > < br />
162- < code > npm update castlecss-notifications</ code > < br />
163- </ p >
164- < h3 > What's included?</ h3 >
165- < p >
166- < ul >
167- < li > < strong > Example project setup</ strong > </ li >
168- < li > < strong > Gruntfile and task</ strong > </ li >
169- < li > < strong > castlecss-core</ strong > </ li >
170- < li > < strong > castlecss-buttons</ strong > </ li >
171- < li > < strong > castlecss-notifications</ strong > </ li >
172- </ ul >
173- </ p >
174- </ div >
175- </ div >
176163 < div id ="core " class ="b0_12 ">
177164 < div class ="block block-invert p-3x pt-2x ">
178165 < h2 > Core only</ h2 >
@@ -269,7 +256,7 @@ <h3>What's included?</h3>
269256 < footer id ="footer "> </ footer >
270257 <!-- Scripts for documentation -->
271258< footer id ="footer ">
272-
259+
273260</ footer >
274261< script >
275262 $ ( function ( ) {
@@ -284,14 +271,15 @@ <h3>What's included?</h3>
284271
285272</ script >
286273
287- < script src ="../js/shCore.js "> </ script >
288- < script src ="../js/shBrushXml.js "> </ script >
289- < script src ="../js/shBrushSass.js "> </ script >
290- < script src ="../js/shBrushJScript.js "> </ script >
274+ < script src ="../dist/ js/shCore.js "> </ script >
275+ < script src ="../dist/ js/shBrushXml.js "> </ script >
276+ < script src ="../dist/ js/shBrushSass.js "> </ script >
277+ < script src ="../dist/ js/shBrushJScript.js "> </ script >
291278< script type ="text/javascript "> SyntaxHighlighter . all ( ) ; </ script >
292279< script async defer src ="https://buttons.github.io/buttons.js "> </ script >
293280
294281
282+
295283 </ body >
296284
297- </ html >
285+ </ html >
0 commit comments