update bookmarklet and api links to point to help
[bootswatch] / help / index.html
1 <!DOCTYPE html>
2 <html lang="en">
3   <head>
4     <title>Bootswatch: Help</title>
5     <meta name="viewport" content="width=device-width, initial-scale=1.0">
6     <meta charset="utf-8">
7     <link rel="stylesheet" href="../flatly/bootstrap.min.css" media="screen">
8     <link rel="stylesheet" href="../bower_components/font-awesome/css/font-awesome.min.css">
9     <link rel="stylesheet" href="../assets/css/bootswatch.min.css">
10     <style>
11
12       h1 {
13         margin-top: 2em;
14       }
15
16       code {
17         background-color: #eee;
18         color: inherit;
19       }
20
21     </style>
22     <script type="text/javascript">
23
24      var _gaq = _gaq || [];
25       _gaq.push(['_setAccount', 'UA-23019901-1']);
26       _gaq.push(['_setDomainName', "bootswatch.com"]);
27         _gaq.push(['_setAllowLinker', true]);
28       _gaq.push(['_trackPageview']);
29
30      (function() {
31        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
32        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
33        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
34      })();
35
36     </script>
37   </head>
38   <body>
39
40     <div class="navbar navbar-fixed-top">
41       <div class="container">
42         <a href="../" class="navbar-brand">Bootswatch</a>
43         <button class="navbar-toggle" type="button" data-toggle="collapse" data-target="#navbar-main">
44           <span class="icon-bar"></span>
45           <span class="icon-bar"></span>
46           <span class="icon-bar"></span>
47         </button>
48         <div class="nav-collapse collapse" id="navbar-main">
49           <ul class="nav navbar-nav">
50             <li class="dropdown">
51               <a class="dropdown-toggle" data-toggle="dropdown" href="#" id="themes">Themes <span class="caret"></span></a>
52               <ul class="dropdown-menu" aria-labelledby="themes">
53                 <li><a tabindex="-1" href="../default/">Default</a></li>
54                 <li class="divider"></li>
55                 <li><a tabindex="-1" href="../amelia/">Amelia</a></li>
56                 <li><a tabindex="-1" href="../cerulean/">Cerulean</a></li>
57                 <li><a tabindex="-1" href="../cosmo/">Cosmo</a></li>
58                 <li><a tabindex="-1" href="../cyborg/">Cyborg</a></li>
59                 <li><a tabindex="-1" href="../flatly/">Flatly</a></li>
60                 <li><a tabindex="-1" href="../journal/">Journal</a></li>
61                 <li><a tabindex="-1" href="../readable/">Readable</a></li>
62                 <li><a tabindex="-1" href="../simplex/">Simplex</a></li>
63                 <li><a tabindex="-1" href="../slate/">Slate</a></li>
64                 <li><a tabindex="-1" href="../spacelab/">Spacelab</a></li>
65                 <li><a tabindex="-1" href="../superhero/">Superhero</a></li>
66                 <li><a tabindex="-1" href="../united/">United</a></li>
67               </ul>
68             </li>
69             <li class="active">
70               <a href="./help/">Help</a>
71             </li>
72             <li>
73               <a href="http://news.bootswatch.com">Blog</a>
74             </li>
75           </ul>
76
77           <ul class="nav navbar-nav pull-right">
78             <li><a href="http://builtwithbootstrap.com/" target="_blank">Built With Bootstrap</a></li>
79             <li><a href="https://wrapbootstrap.com/?ref=bsw" target="_blank">WrapBootstrap</a></li>
80           </ul>
81
82         </div>
83       </div>
84     </div>
85
86     <div class="container">
87       <div class="row">
88         <div class="col-lg-9">
89
90             <h1 id="quickstart">Quick Start</h1>
91             <p>Using a theme is as easy as downloading a CSS file and replacing the one that comes with <a href="http://getbootstrap.com" target="_blank">Bootstrap</a>.</p>
92
93             <h1 id="customization">Customization</h1> 
94             <p>To modify a theme or create your own, follow the steps below.</p>
95             <ol>
96               <li><p><code>git clone git@github.com:thomaspark/bootswatch.git</code></p></li>
97               <li><p><code>npm install</code></p></li>
98               <li><p><code>bower install</code></p></li>
99               <li>
100                 <p>Edit <code>variables.less</code> and <code>bootswatch.less</code> in one of the theme directories, or create your own in <code>/custom</code>.</p>
101               </li>
102               <li><p>Type <code>grunt swatch:[theme]</code> to build the CSS for a theme, e.g., <code>grunt swatch:amelia</code> for Amelia. Or type <code>grunt swatch</code> to build them all at once.</p></li>
103             </ol>
104             <p>Here are additional tips for <a href="http://coding.smashingmagazine.com/2013/03/12/customizing-bootstrap/" target="_blank">customizing Bootstrap</a>.</p>
105
106             <h1 id="api">API</h1>
107             <p>You can use the API to integrate the themes with your platform. Send your request to:</p>
108             <p><a href="http://api.bootswatch.com/3/">http://api.bootswatch.com/3/</a></p>
109             <p>This returns the <code>version</code> and a <code>themes</code> array with the following properties: <code>name</code>, <code>description</code>, <code>preview</code>, <code>thumbnail</code>, <code>css</code>, <code>cssMin</code>, <code>less</code>, and <code>lessVariables</code>.</p>
110             <p>Here's a <a href="http://jsbin.com/oqubil/1/edit" target="_blank">demo</a> with mustache.js templating.</p>
111
112         </div>
113       </div>
114     </div>
115
116
117     <div class="container">
118       <footer>
119         <div class="row">
120           <div class="col-lg-12">
121             
122             <ul class="list-unstyled">
123               <li class="pull-right"><a href="#top">Back to top</a></li>
124               <li><a href="http://news.bootswatch.com" onclick="pageTracker._link(this.href); return false;">Blog</a></li>
125               <li><a href="http://feeds.feedburner.com/bootswatch">RSS</a></li>
126               <li><a href="https://twitter.com/thomashpark">Twitter</a></li>
127               <li><a href="https://github.com/thomaspark/bootswatch/">GitHub</a></li>
128               <li><a href="../help/#api">API</a></li>
129               <li><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&amp;hosted_button_id=F22JEM3Q78JC2">Donate</a></li>
130             </ul>
131             <p>Made by <a href="http://thomaspark.me">Thomas Park</a>. Contact him at <a href="mailto:hello@thomaspark.me">hello@thomaspark.me</a>.</p>
132             <p>Code licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License v2.0</a>.</p>
133             <p>Based on <a href="http://getbootstrap.com">Bootstrap</a>. Icons from <a href="http://fortawesome.github.io/Font-Awesome/">Font Awesome</a>. Web fonts from <a href="http://www.google.com/webfonts">Google</a>. Favicon by <a href="https://twitter.com/geraldhiller">Gerald Hiller</a>.</p>
134
135           </div>
136         </div>
137         
138       </footer>
139     
140     </div>
141
142
143     <script src="../bower_components/jquery/jquery.min.js"></script>
144     <script src="../bower_components/bootstrap/dist/js/bootstrap.min.js"></script>
145     <script src="../assets/js/bootswatch.js"></script>
146     <script type="text/javascript">
147       !function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");
148     </script>
149   </body>
150 </html>