delphic-digital.github.io/index.html at master · delphic-digital/delphic-digital.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="chrome=1">
    <title>Delphic-digital.github.io by delphic-digital</title>

    <link rel="stylesheet" href="stylesheets/styles.css">
    <link rel="stylesheet" href="stylesheets/pygment_trac.css">
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <!--[if lt IE 9]>
    <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
    <![endif]-->
  </head>
  <body>
    <div class="wrapper">
      <header>
        <h1>Delphic Digital</h1>
        <h3>FED Bible</h3>
      </header>
      <section>
        <h2>Tools</h2>

<p>First things first, get the tools! Most 3rd party front end tools are based off of <a href="http://nodejs.org/">Node.js</a>. So: </p>
<ul>
<li>Install <a href="http://nodejs.org/">Node.js</a>!</li>
</ul>
<p>Once node is installed, we can install our build and development tools. Open a windows command prompt and enter: </p>
<pre><code>npm install -g volo uglifycss uglify-js</code></pre>
<ul>
  <li><a href="http://volojs.org/">Volo</a>. It's a great way to manage JavaScript libraries and dependencies. It's also used to build (minify and combine), our code. It's <em>almost</em> perfect for our uses, and it's perfect after a couple changes. See below.</li>
  <li><a href="https://github.com/fmarcia/UglifyCSS">UglifyCSS</a>. Minify and Combine CSS.</li>
  <li><a href="https://github.com/mishoo/UglifyJS2">UglifyJS 2</a>. Minify and Combine JavaScript.</li>
</ul>
</section>
<section>
<h2>Volo Modifications</h2>
<p>Volo doesn't allow you to run the <code>create</code> command in a directory that has code in it. This becomes a problem when us FED's get a new site to work on that already has a C# project set up. So lets make some small changes to Volo to fix this:</p>
<p>Comment out the else if starting on line 56 in:<br> <strong>C:\Users\<em>[your username]</em>\AppData\Roaming\npm\node_modules\volo\commands\create.js</strong>.</p>
<pre><code>
/*else if (file.exists(appName)) {
  return new Error(appName + ' already exists.');
}*/</code></pre>
<p>The other problem is that volo is built for JavaScript, so it can't, say...automate where to put a css dependency. Let's change this:</p>
<p>Comment out line 164 in:<br> <strong>C:\Users\<em>[your username]</em>\AppData\Roaming\npm\node_modules\volo\lib\packageJson.js</strong><br> and add  return path.dirname(this.file).</p>
<pre><code>
//return baseDir;
return path.dirname(this.file);
</code></pre>
<p>Modifications done!</p>
      </section>
      <section>
        <h2>CSS</h2>

        <h3>Structure</h3>
        <p>The following is an example of how we structure our CSS:</p>
        <pre>
          <code>
            .selector
            {
              float: left;
              display: block;
              width: 5px;
              height: 5px;
            }
          </code>
        </pre>
        <p>The selector and open/closing brackets are on their own line. Also each property/value declaration is on it's own line.</p>

        <h3>Properties</h3>
        <p>CSS properties are ordered as follows:</p>
        <pre><code>
          overflow
          float
          display
          visibility
          position
          top
          left
          z-index
          margin
          padding
          width
          height
          font-size
          font-weight
          font-style
          text-decoration
          white-space
          letter-spacing
          line-height
          text-align
          vertical-align
          list-style
          cursor
          color
          background
          border
          opacity
          filter

        </code></pre>
        <p><strong>Note:</strong> Any style property that also requires vendor prefixes should be listed at the end of the CSS rule to maintain readability.</p>
      </section>
      <footer>

      </footer>
    </div>
    <script src="javascripts/scale.fix.js"></script>

  </body>
</html>