annotate seminar/io2012slides/README.md @ 3:fea44bb81877 default tip

many change
author taiki
date Tue, 10 Dec 2013 15:31:33 +0900
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3
fea44bb81877 many change
taiki
parents:
diff changeset
1 <style>
fea44bb81877 many change
taiki
parents:
diff changeset
2 @import "http://fonts.googleapis.com/css?family=Open Sans:regular,semibold,italic,italicsemibold|Inconsolata&amp;v2";
fea44bb81877 many change
taiki
parents:
diff changeset
3 body {
fea44bb81877 many change
taiki
parents:
diff changeset
4 font-family: "Open Sans";
fea44bb81877 many change
taiki
parents:
diff changeset
5 margin: 6em 2em 2em 2em;
fea44bb81877 many change
taiki
parents:
diff changeset
6 }
fea44bb81877 many change
taiki
parents:
diff changeset
7 body:before {
fea44bb81877 many change
taiki
parents:
diff changeset
8 content: '';
fea44bb81877 many change
taiki
parents:
diff changeset
9 position: fixed;
fea44bb81877 many change
taiki
parents:
diff changeset
10 top: 2%;
fea44bb81877 many change
taiki
parents:
diff changeset
11 right: 3%;
fea44bb81877 many change
taiki
parents:
diff changeset
12 height: 100px;
fea44bb81877 many change
taiki
parents:
diff changeset
13 width: 100px;
fea44bb81877 many change
taiki
parents:
diff changeset
14 background: url(http://www.html5rocks.com/static/images/identity/HTML5_Badge_128.png) no-repeat 50% 50%;
fea44bb81877 many change
taiki
parents:
diff changeset
15 background-size: contain;
fea44bb81877 many change
taiki
parents:
diff changeset
16 z-index: 10;
fea44bb81877 many change
taiki
parents:
diff changeset
17 opacity: 0.1;
fea44bb81877 many change
taiki
parents:
diff changeset
18 }
fea44bb81877 many change
taiki
parents:
diff changeset
19 h1, h2, h3, h4 {
fea44bb81877 many change
taiki
parents:
diff changeset
20 font-weight: 600;
fea44bb81877 many change
taiki
parents:
diff changeset
21 }
fea44bb81877 many change
taiki
parents:
diff changeset
22 h1 {
fea44bb81877 many change
taiki
parents:
diff changeset
23 position: fixed;
fea44bb81877 many change
taiki
parents:
diff changeset
24 background: -webkit-linear-gradient(top, white 65%, rgba(255,255,255,0));
fea44bb81877 many change
taiki
parents:
diff changeset
25 background: -moz-linear-gradient(top, white 65%, rgba(255,255,255,0));
fea44bb81877 many change
taiki
parents:
diff changeset
26 background: -ms-linear-gradient(top, white 65%, rgba(255,255,255,0));
fea44bb81877 many change
taiki
parents:
diff changeset
27 background: -o-linear-gradient(top, white 65%, rgba(255,255,255,0));
fea44bb81877 many change
taiki
parents:
diff changeset
28 width: 100%;
fea44bb81877 many change
taiki
parents:
diff changeset
29 height: 80px;
fea44bb81877 many change
taiki
parents:
diff changeset
30 padding: 10px 10px 10px 1em;
fea44bb81877 many change
taiki
parents:
diff changeset
31 left: 0;
fea44bb81877 many change
taiki
parents:
diff changeset
32 top: 0;
fea44bb81877 many change
taiki
parents:
diff changeset
33 margin: 0;
fea44bb81877 many change
taiki
parents:
diff changeset
34 }
fea44bb81877 many change
taiki
parents:
diff changeset
35 h1 img {
fea44bb81877 many change
taiki
parents:
diff changeset
36 height: 30px;
fea44bb81877 many change
taiki
parents:
diff changeset
37 vertical-align: middle;
fea44bb81877 many change
taiki
parents:
diff changeset
38 margin-bottom: 8px;
fea44bb81877 many change
taiki
parents:
diff changeset
39 }
fea44bb81877 many change
taiki
parents:
diff changeset
40 a { color: navy; }
fea44bb81877 many change
taiki
parents:
diff changeset
41 pre {
fea44bb81877 many change
taiki
parents:
diff changeset
42 background: #eee;
fea44bb81877 many change
taiki
parents:
diff changeset
43 margin-left: 2em;
fea44bb81877 many change
taiki
parents:
diff changeset
44 padding: 5px;
fea44bb81877 many change
taiki
parents:
diff changeset
45 border-left: 3px solid #ccc;
fea44bb81877 many change
taiki
parents:
diff changeset
46 }
fea44bb81877 many change
taiki
parents:
diff changeset
47 </style>
fea44bb81877 many change
taiki
parents:
diff changeset
48
fea44bb81877 many change
taiki
parents:
diff changeset
49 <h1><img src="images/io2012_logo.png"> HTML5 Slide Template</h1>
fea44bb81877 many change
taiki
parents:
diff changeset
50
fea44bb81877 many change
taiki
parents:
diff changeset
51 ## Configuring the slides
fea44bb81877 many change
taiki
parents:
diff changeset
52
fea44bb81877 many change
taiki
parents:
diff changeset
53 Much of the deck is customized by changing the settings in [`slide_config.js`](slide_config.js).
fea44bb81877 many change
taiki
parents:
diff changeset
54 Some of the customizations include the title, Analytics tracking ID, speaker
fea44bb81877 many change
taiki
parents:
diff changeset
55 information (name, social urls, blog), web fonts to load, themes, and other
fea44bb81877 many change
taiki
parents:
diff changeset
56 general behavior.
fea44bb81877 many change
taiki
parents:
diff changeset
57
fea44bb81877 many change
taiki
parents:
diff changeset
58 ### Customizing the `#io12` hash
fea44bb81877 many change
taiki
parents:
diff changeset
59
fea44bb81877 many change
taiki
parents:
diff changeset
60 The bottom of the slides include `#io12` by default. If you'd like to change
fea44bb81877 many change
taiki
parents:
diff changeset
61 this, please update the variable `$social-tags: '#io12';` in
fea44bb81877 many change
taiki
parents:
diff changeset
62 [`/theme/scss/default.scss`](theme/scss/default.scss).
fea44bb81877 many change
taiki
parents:
diff changeset
63
fea44bb81877 many change
taiki
parents:
diff changeset
64 See the next section on "Editing CSS" before you go editing things.
fea44bb81877 many change
taiki
parents:
diff changeset
65
fea44bb81877 many change
taiki
parents:
diff changeset
66 ## Editing CSS
fea44bb81877 many change
taiki
parents:
diff changeset
67
fea44bb81877 many change
taiki
parents:
diff changeset
68 [Compass](http://compass-style.org/install/) is a CSS preprocessor used to compile
fea44bb81877 many change
taiki
parents:
diff changeset
69 SCSS/SASS into CSS. We chose SCSS for the new slide deck for maintainability,
fea44bb81877 many change
taiki
parents:
diff changeset
70 easier browser compatibility, and because...it's the future!
fea44bb81877 many change
taiki
parents:
diff changeset
71
fea44bb81877 many change
taiki
parents:
diff changeset
72 That said, if not comfortable working with SCSS or don't want to learn something
fea44bb81877 many change
taiki
parents:
diff changeset
73 new, not a problem. The generated .css files can already be found in
fea44bb81877 many change
taiki
parents:
diff changeset
74 (see [`/theme/css`](theme/css)). You can just edit those and bypass SCSS altogether.
fea44bb81877 many change
taiki
parents:
diff changeset
75 However, our recommendation is to use Compass. It's super easy to install and use.
fea44bb81877 many change
taiki
parents:
diff changeset
76
fea44bb81877 many change
taiki
parents:
diff changeset
77 ### Installing Compass and making changes
fea44bb81877 many change
taiki
parents:
diff changeset
78
fea44bb81877 many change
taiki
parents:
diff changeset
79 First, install compass:
fea44bb81877 many change
taiki
parents:
diff changeset
80
fea44bb81877 many change
taiki
parents:
diff changeset
81 sudo gem update --system
fea44bb81877 many change
taiki
parents:
diff changeset
82 sudo gem install compass
fea44bb81877 many change
taiki
parents:
diff changeset
83
fea44bb81877 many change
taiki
parents:
diff changeset
84 Next, you'll want to watch for changes to the exiting .scss files in [`/theme/scss`](theme/scss)
fea44bb81877 many change
taiki
parents:
diff changeset
85 and any new one you add:
fea44bb81877 many change
taiki
parents:
diff changeset
86
fea44bb81877 many change
taiki
parents:
diff changeset
87 $ cd io-2012-slides
fea44bb81877 many change
taiki
parents:
diff changeset
88 $ compass watch
fea44bb81877 many change
taiki
parents:
diff changeset
89
fea44bb81877 many change
taiki
parents:
diff changeset
90 This command automatically recompiles the .scss file when you make a change.
fea44bb81877 many change
taiki
parents:
diff changeset
91 Its corresponding .css file is output to [`/theme/css`](theme/css). Slick.
fea44bb81877 many change
taiki
parents:
diff changeset
92
fea44bb81877 many change
taiki
parents:
diff changeset
93 By default, [`config.rb`](config.rb) in the main project folder outputs minified
fea44bb81877 many change
taiki
parents:
diff changeset
94 .css. It's a best practice after all! However, if you want unminified files,
fea44bb81877 many change
taiki
parents:
diff changeset
95 run watch with the style output flag:
fea44bb81877 many change
taiki
parents:
diff changeset
96
fea44bb81877 many change
taiki
parents:
diff changeset
97 compass watch -s expanded
fea44bb81877 many change
taiki
parents:
diff changeset
98
fea44bb81877 many change
taiki
parents:
diff changeset
99 *Note:* You should not need to edit [`_base.scss`](theme/scss/_base.scss).
fea44bb81877 many change
taiki
parents:
diff changeset
100
fea44bb81877 many change
taiki
parents:
diff changeset
101 ## Running the slides
fea44bb81877 many change
taiki
parents:
diff changeset
102
fea44bb81877 many change
taiki
parents:
diff changeset
103 The slides can be run locally from `file://` making development easy :)
fea44bb81877 many change
taiki
parents:
diff changeset
104
fea44bb81877 many change
taiki
parents:
diff changeset
105 ### Running from a web server
fea44bb81877 many change
taiki
parents:
diff changeset
106
fea44bb81877 many change
taiki
parents:
diff changeset
107 If at some point you should need a web server, use [`serve.sh`](serve.sh). It will
fea44bb81877 many change
taiki
parents:
diff changeset
108 launch a simple one and point your default browser to [`http://localhost:8000/template.html`](http://localhost:8000/template.html):
fea44bb81877 many change
taiki
parents:
diff changeset
109
fea44bb81877 many change
taiki
parents:
diff changeset
110 $ cd io-2012-slides
fea44bb81877 many change
taiki
parents:
diff changeset
111 $ ./serve.sh
fea44bb81877 many change
taiki
parents:
diff changeset
112
fea44bb81877 many change
taiki
parents:
diff changeset
113 You can also specify a custom port:
fea44bb81877 many change
taiki
parents:
diff changeset
114
fea44bb81877 many change
taiki
parents:
diff changeset
115 $ ./serve.sh 8080
fea44bb81877 many change
taiki
parents:
diff changeset
116
fea44bb81877 many change
taiki
parents:
diff changeset
117 ### Presenter mode
fea44bb81877 many change
taiki
parents:
diff changeset
118
fea44bb81877 many change
taiki
parents:
diff changeset
119 The slides contain a presenter mode feature (beta) to view + control the slides
fea44bb81877 many change
taiki
parents:
diff changeset
120 from a popup window.
fea44bb81877 many change
taiki
parents:
diff changeset
121
fea44bb81877 many change
taiki
parents:
diff changeset
122 To enable presenter mode, add `presentme=true` to the URL: [http://localhost:8000/template.html?presentme=true](http://localhost:8000/template.html?presentme=true)
fea44bb81877 many change
taiki
parents:
diff changeset
123
fea44bb81877 many change
taiki
parents:
diff changeset
124 To disable presenter mode, hit [http://localhost:8000/template.html?presentme=false](http://localhost:8000/template.html?presentme=false)
fea44bb81877 many change
taiki
parents:
diff changeset
125
fea44bb81877 many change
taiki
parents:
diff changeset
126 Presenter mode is sticky, so refreshing the page will persist your settings.
fea44bb81877 many change
taiki
parents:
diff changeset
127
fea44bb81877 many change
taiki
parents:
diff changeset
128 ---
fea44bb81877 many change
taiki
parents:
diff changeset
129
fea44bb81877 many change
taiki
parents:
diff changeset
130 That's all she wrote!