Membangun CMS: Struktur Dan Styling

By Blok CC 20 Apr, 2020 Post a Comment

English article)

Final product image — What You'll Be Creating

Bagi anda yang familiar dengan CMS seperti wordpress tampilan web pertama anda tidak akan jauh berbeda dengan tampilan sederhana flat desain CMS di atas. Perlu di ingat judul artikelnya membangun CMS namun poinnya adalah bagaimana menstruktur dan mendesain tampilan, tidak berkaitan dengan database. Sebagai gantinya, semua informasi disimpan dalam file teks biasa. Karena banyak virtual private server (VPS) saat ini menggunakan RAM berbasis hard drive, pendekatan ini lebih cepat dan lebih aman.
Dalam seri tutorial ini, saya akan menunjukkan cara untuk membuat flat file sistem CMS anda sendiri menggunakan teknologi web sederhana. Tidak seperti sistem CMS pada umumnya yang sudah jadi dan sudah siap pakai, Ini adalah sistem CMS dasar tetapi tetap apa yang di butuhkan untuk para pemula yang ingin belajar dasar CMS akan di jelaskan disini.
Jika anda punya project dan bila project anda sudah berkembang menjadi project yang besar, maka bersiaplah karena masalah pengornasian file dan folder akan segera menghampiri anda ( Serem kan... hihihi ). Juga, setiap jenis halaman memiliki direktori sendiri difolder situs dengan direktori bagian untuk bagian-bagian kecil dari CMS. Hal ini mempertahankan semuanya pada tempatnya masing-masing dan membuat sebuah sistem fleksibel.

Struktur Folder Utama (Root Folder)

Dalam direktori di mana Anda akan membangun proyek, umumnya anda akan membuat direktori seperti: src, site, dan tema. Folder src untuk menyimpan file yang berkaitan dengan server, folder site untuk menyimpan file halaman yang akan menampilkan informasi seperti halaman beranda, kontak, tentang atau lainnya, dan folder tema untuk menyimpan file layout seperti header dan footer atau yang lebih spesifik lagi navigasi.
Dalam direktori theme, Anda perlu membuat direktori layout dan styling. Direktori layouts akan berisi layout halaman web yang berbeda. Dengan memisahkan informasi layout dari informasi styling, theme menjadi lebih fleksibel. Untuk saat ini, akan ada satu layout bernama SingleCol.
Untuk semua pembuatan styling dan layout, saya menggunakan Sass, Compass, dan Susy. Sass adalah bahasa pengolahan Custom Style Sheet. Ini memberikan cara yang lebih kuat untuk menciptakan CSS style sheet untuk website Anda. Compass adalah ekstensi untuk Sass. Sassy-buttons adalah ekstensi Sass untuk membuat tombol menarik di situs web. Susy juga merupakan ekstensi untuk membuat sistem layout grid untuk situs Anda.
Karena Ruby sudah terpasang di semua Mac, Anda tidak perlu menginstalnya. Untuk menjalankan Ruby di sistem Windows, Anda perlu mendownload Ruby's Windows Installer. Pada Linux, Anda perlu menggunakan Manajer paket sistem Anda untuk menginstal Ruby.
Setelah Ruby ada pada sistem Anda, Anda dapat menginstal Sass, Compass, Sassy-buttons, dan Susy dengan baris perintah ini:

gem install sass

gem install sassy-buttons

gem install compass

gem install susy

Untuk tutorial ini, saya menggunakan Sass 3.4.16, Sassy-buttons 0.2.6, Compass 1.0.3, dan Susy 2.2.5. Tergantung pada konfigurasi sistem Anda, Anda mungkin harus menjalankan perintah ini dengan sudo.

Tata Letak (Layout)

Untuk memulai membuat layout, jalankan perintah ini di direktori SingleCol:

compass init

Ini akan membuat directory sass dan stylesheet dan file bernama config.rb. Karena saya suka menggunakan css untuk direktori stylesheet, ubah nama direktori stylesheet menjadi css. Juga, buat direktori js untuk file JavaScript yang diperlukan untuk layout. Buka file config.rb dan buat terlihat seperti ini:

require 'susy'

http_path = "/"

css_dir = "css"

sass_dir = "sass"

images_dir = "images"

javascripts_dir = "js"

Sekarang, untuk membuat layout dasar website, buat file dalam direktori layout yang disebut template.html. Dalam file ini, tambahkan kode berikut:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">

<head>

  <meta name="generator" content="goPress Servery by Custom Computer Tools.">

    <meta charset="utf-8">

    <title>

        {{{title}}}

    </title>

    <link rel="stylesheet" type="text/css" href="{{{WebAddress}}}/stylesheets.css">

    {{{head}}}

</head>

<body>

    <div id='wrap'>

        <div id='headerwrap'>

            <div id='header'>

                {{{header}}}

            </div>

            <div id='navigation'>

                {{{navbar}}}

            </div>

        </div>

        <div id='sidebar'>

            {{{sidebar}}}

        </div>

        <div id='content'>

            {{{content}}}

        </div>

        <div id='footer'>

            {{{footer}}}

        </div>

    </div>

    <script type="text/javascript" src="{{{WebAddress}}}/scripts.js"></script>

</body>

</html>

Template ini menciptakan halaman web standar untuk situs. Setiap halaman memiliki header dengan panel navigasi, sidebar tunggal, area konten, dan area footer. Hal terakhir yang dimuat adalah javascript yang dibutuhkan untuk situs ini.
Setiap bagian diwakili dengan makro Handlebar. Server memperluas macro-nya sebelum menampilkannya kepada pengguna.
Dalam direktori sass, buat sebuah file bernama base.scss dan letakkan kode ini:

@import 'compass/reset';

@import 'susy';

$susy: (

  flow: ltr,

  math: fluid,

  output: float,

  gutter-position: after,

  container: auto,

  container-position: center,

  columns: 16,

  gutters: .25,

  column-width: false,

  global-box-sizing: content-box,

  last-flow: to,

  debug: (

    image: hide,

    color: rgba(#66f, .25),

    output: background,

    toggle: top right,

  ),

  use-custom: (

    background-image: true,

    background-options: false,

    box-sizing: true,

    clearfix: false,

    rem: true,

  )

);

body {

}

#wrap {

  @include container(16);

  width: 1024px;

  display:  block;

}

#headerwrap {

  @include span(16 of 16);

  margin-bottom: 20px;

}

#header {

  margin-top: 20px;

  margin-left: auto;

  margin-right: auto;

  width:    95%;

}

#content {

    @include span(11 of 16);

 }

.col1 {

    @include span(5 of 10);

}

.col2 {

    @include span(last 5 of 10);

}

#footer .col2 {

    width: auto;

}

.box {

  @include span(4 of 10);

}

#sidebar {

  @include span(last 4 of 16);

}

#footer {

  @include span(16 of 16);

}

/** CSS dropdown menu **/

#navigation  {

  margin-top: 20px;

  margin-left: auto;

  margin-right: auto;

  width:    95%;

}

#menuh-container {

  top: 1em;

  left: 1em;

  display: inline;

  width: 100%;

}

#menuh {

  margin-top: 1em;

  display: inline;

  width: 100%;

}

#menuh ul li {

  display: inline-block;

  width: fit-content;

}

#menuh a

  {

  text-align: center;

  display:block;

  white-space:nowrap;

  margin:0;

  padding: 5px;

  text-decoration: none;

  }

#menuh ul

  {

  list-style:none;

  margin: 0px 20px 0px 20px;

  padding: 0px;

  }

#menuh li

  {

  position:relative;

  min-height: 1px;

  vertical-align: bottom; 

  width: fit-content;

  }

#menuh ul ul

  {

  position:  absolute;

  z-index:  500;

  top: 50px;

  left: 20px;

  display:  none;

  padding: 0.5em;

  margin:  -1em 0 0 -1em;

  }

  #menuh ul ul li {

    width: 100%;

  }

#menuh ul ul li  a {

    text-align:  left;

}

#menuh ul ul ul

  {

  left: 90px;

  }

div#menuh li:hover

  {

  cursor:pointer;

  z-index:100;

  }

div#menuh li:hover ul ul,

div#menuh li li:hover ul ul,

div#menuh li li li:hover ul ul,

div#menuh li li li li:hover ul ul

{display:none;}

div#menuh li:hover ul,

div#menuh li li:hover ul,

div#menuh li li li:hover ul,

div#menuh li li li li:hover ul

{display:block;}

/* End CSS Drop Down Menu */

Kode sass ini dimuat dalam style reset compass untuk menetralisir browser default. Kemudian itu memuat and menyiapkan susy untuk membuat grid yang tepat untuk semua elemen di halaman web.
Sistem navigasi css ada setelah halaman aktif. Drop-down yang tersebunyi untuk menu menjadi terlihat dengan definisi "mouse-over". Ini hanya memberikan sistem menu css.
Semua style ini mendefinisikan struktur dasar dari website. Tidak ada satu pun dari hal diatas yang membuat tampilan halaman, hanya posisinya. Semua styling akan ditangani oleh konten styling.

Styles

Untuk direktori styling, buatlah sebuah direktori bernama Basic. Inisialisasi informasi sass seperti yang dilakukan untuk direktori layouts/SingleCol. Dalam direktori ini, jalankan baris perintah berikut:

compass init

Ini akan membuat direktori sass dan stylesheet dan file bernama config.rb. Karena saya suka menggunakan css untuk direktori stylesheet, ubah nama direktori stylesheet menjadi css. Juga, buat sebuah direktori js untuk setiap JavaScript untuk membuat theme. Buka file config.rb dan buat terlihat seperti ini:

require 'sassy-buttons'

http_path = "/"

css_dir = "css"

sass_dir = "sass"

images_dir = "images"

javascripts_dir = "js"

Untuk mengubah desain tombol di situs web, saya menggunakan sassy-buttons. Karenanya, itu diperlukan dulu, baru kemudian struktur direktori.
Dalam direktori Basic/sass, buat file Basic.scss dengan informasi ini:

// Welcome to Compass.

// In this file you should write your main styles. (or centralize your imports)

// Import this file using the following HTML or equivalent:

// <link href='/stylesheets/screen.css' media='screen, projection' rel='stylesheet' type='text/css' />

//

@import 'compass/css3';

@import 'sassy-buttons';

$style-color1: rgb(247, 237, 222);

$style-color2: #ffedd1;

$style-color3: rgb(245, 213, 166);

$style-color4: #f0d5ad;

//

// Clear Fix

//

.clearfix:after {

    content: '.';

    display: block;

    clear: both;

    visibility: hidden;

    line-height: 0;

    height: 0;

}

.clearfix {

    display: inline-block;

}

html[xmlns] .clearfix {

    display: block;

}

* html .clearfix {

    height: 1%;

}

//

// Main Styling for Wood.

//

@mixin standardsize {

    padding-top: 10px;

    padding-left: 15px;

    font-size: 19px;

    line-height: 1.25em;

}

body {

    background-color: $style-color2;

    input[type='button'] {

        @include sassy-button('shiny', 10px, 16px, $style-color1, darken($style-color1, 20%), #000, bold);

    }

    .button {

        @include sassy-button('shiny', 10px, 16px, $style-color1, darken($style-color1, 20%), #000, bold);

        display: inherit;

        margin-left: auto;

        margin-right: auto;

        margin-top: 10px;

        margin-bottom: 10px;

        text-align: center;

    }

    #wrap {

        background-color: $style-color1;

        @include border-radius(.6em, .6em);

        margin-top: 10px;

        margin-bottom: 10px;

        border: 4px solid $style-color4;

        #header {

            background-color: $style-color2;

            @include border-radius(15px);

            background-repeat: no-repeat;

            border: 2px solid $style-color3;

            height: 130px;

            text-align: left;

            margin-top: 20px;

            font-size: 3em;

            h1 {

                a:link, a:visited {

                    color: #000;

                    text-decoration: none;

                }

                padding-top: 40px;

                padding-left: 20px;

            }

            h6 {

                font-size: .4em;

                font-style: italic;

                padding-left: 20px;

            }

        }

        #sidebar {

            background-color: $style-color2;

            @include border-radius(.6em, .6em);

            padding: .6em;

            vertical-align: text-top;

            overflow: hidden;

            margin-right: .5em;

            border: 2px solid $style-color3;

            hr {

                color: $style-color2;

                background-color: $style-color2;

            }

            p, ul, li {

                @include standardsize;

            }

            ul li {

                list-style-type: disc;

                margin-left: 25px;

                padding: 0;

                border: 0;

                outline: 0;

                font-size: 100%;

                vertical-align: baseline;

                background: transparent;

            }

            li {

                margin-bottom: 10px;

            }

            h1, h2, h3, h4, h5, h6 {

                @include standardsize;

                font-weight: bold;

                margin-top: .25em;

                margin-bottom: .25em;

            }

            h1 {

                font-size: 2.5em;

            }

            h2 {

                font-size: 2em;

            }

            h3 {

                font-size: 1.5em;

            }

            h4 {

                font-size: 1em;

            }

            h5 {

                font-size: .8em;

            }

            h6 {

                font-size: .6em;

            }

            input[type='button'] {

                margin-left: 120px;

                clear: both;

            }

        }

        #content {

            input[type='button'] {

                margin-left: 200px;

                clear: both;

            }

            h1, h2, h3, h4, h5, h6 {

                @include standardsize;

                font-weight: bold;

                margin-top: .25em;

                margin-bottom: .25em;

            }

            h1 {

                font-size: 2.5em;

            }

            h2 {

                font-size: 2em;

            }

            h3 {

                font-size: 1.5em;

            }

            h4 {

                font-size: 1em;

            }

            h5 {

                font-size: .8em;

            }

            h6 {

                font-size: .6em;

            }

            hr {

                margin-top: 30px;

                margin-bottom: 30px;

            }

            p, ul, li, details, summary, pre {

                @include standardsize;

            }

            details {

                p, pre {

                    margin-left: 25px;

                }

            }

            ul li {

                list-style-type: disc;

                margin-left: 25px;

                padding: 0;

                border: 0;

                outline: 0;

                font-size: 100%;

                vertical-align: baseline;

                background: transparent;

            }

            li {

                margin-bottom: 10px;

            }

            .box {

                clear: both;

                background-color: $style-color4;

                float: none;

                margin-left: auto;

                margin-right: auto;

                margin-top: 1.0em;

                margin-bottom: 1em;

                @include border-radius(.6em, .6em);

                display: block;

                padding: .5em;

            }

            img {

                @include border-radius(10px);

                margin: 20px auto 20px auto;

            }

        }

        #footer {

            border-top: 5px;

            border-style: solid;

            border-color: $style-color3;

            @include border-radius(.6em, .6em);

            margin-top: 30px;

            p {

                margin-bottom: .6em;

                @include standardsize;

                margin-right: 15px;

            }

        }

    }

}

// CSS dropdown menu

#navigation {

    text-align: left;

    border: 2px solid $style-color3;

    background-color: $style-color2;

    @include border-radius(15px);

}

#menuh {

    font-size: 1.3em;

    font-family: arial, helvetica, sans-serif;

    background-color: $style-color1;

}

#menuh ul {

    background-color: $style-color2;

}

#menuh ul ul {

    background-color: $style-color2;

    @include border-radius(15px);

    border: 2px solid $style-color3;

}

#menuh a {

    background-color: $style-color2;

    color: #000;

}

#menuh a:link, #menuh a:visited, #menuh a:active {

    color: #000;

    background-color: $style-color2;

}

#menuh a:hover {

    color: #000;

    background-color: $style-color4;

    @include border-radius(5px);

}

// End CSS Drop Down Menu

// Misc classes

.picture {

    border: 3px solid $style-color3;

    @include border-radius(8px);

    float: left;

    margin: 5px 15px 15px 15px;

}

a:link, a:visited {

    color: darken($style-color1, 50);

    text-decoration: none;

}

strong {

    font-weight: bold;

}

table {

    margin: 20px;

    border: 3px solid;

    @include border-radius(10px);

    border-color: lighten($style-color2, 6);

    th {

        text-align: center;

        font-weight: bold;

        padding: 10px 0 10px 0;

    }

    tbody {

        td {

            padding: 10px;

        }

        tr:nth-child(2n+1) {

            background-color: darken($style-color2, 5);

        }

        tr:nth-child(even) {

            background-color: lighten($style-color2, 2.5);

        }

    }

}

#commentSpacer {

    width: 100%;

    margin-top: 20px;

    margin-left: 15px;

}

.tutorial_excerpt {

    margin-left: 20px;

}

.tutorial_thumbnail {

    float: left;

    margin-right: 20px;

    margin-left: 20px;

    margin-bottom: 20px;

}

.tutorial_wrap {

    margin-bottom: 50px;

    float: left;

}

img.wp-post-image {

    -moz-border-radius: 15px;

    border-radius: 15px;

    box-shadow: 10px 10px 5px gray;

}

.showcode {

    margin: 20px auto 20px 30px;

    -moz-border-radius: 15px;

    border-radius: 15px;

    border: $style-color4 3px;

    border-style: solid;

    background: white;

}

#socialmedia {

    width: 700px;

    margin-top: 20px;

    margin-left: 15px;

}

#socialbuttons {

    margin: auto;

}

#socialbuttons a {

    opacity: 0.8;

    filter: alpha(opacity = 80);

    -webkit-transition: all ease-in-out 0.2s;

    -moz-transition: all ease-in-out 0.2s;

    -ms-transition: all ease-in-out 0.2s;

    -o-transition: all ease-in-out 0.2s;

    transition: all ease-in-out 0.2s;

}

#socialbuttons a:hover {

    opacity: 1;

    filter: alpha(opacity = 100);

}

#socialbuttons a {

    display: inline-block;

    height: 28px;

    width: 30px;

    background-image: url(/images/ico-subscribe-social.png);

    background-repeat: no-repeat;

}

#socialbuttons a.twitter {

    background-position: -30px 0;

}

#socialbuttons a.facebook {

    background-position: -60px 0;

}

#socialbuttons a.googleplus {

    background-position: -210px 0;

}

dl {

    margin-left: 20px;

    margin-top: 20px;

    margin-bottom: 20px;

    font-size: 19px;

    line-height: 1.25em;

}

dt {

    margin-left: 20px;

    margin-bottom: 20px;

    font-weight: bold;

}

dd {

    margin-left: 40px;

    margin-bottom: 20px;

}

Code ini mendefinisikan bagaimana website terlihat. Itu juga mendefinisikan background, pewarnaan, font, dsb. Yang membentuk styling untuk website pada umumnya.
Direktori Styling/Basic berisi berkas yang diperlukan untuk tampilan default halaman 404, header, footer, dan bagian sidebar situs web. Oleh karena itu, buat sebuah file bernama 404.html dan tempatkan kode ini:

<h2>404 Page</h2>

<p>Sorry, we could not find the page.</p>

Ini adalah halaman error 404 dasar. Anda harus berhati-hati dengan informasi yang diberikan di sini, karena Anda tidak ingin mengungkapkan terlalu banyak informasi tentang bagaimana situs Anda bekerja. Karena ini akan ditempatkan dibagian content halaman, akan mudah bagi pengguna untuk bernavigasi darinya.
Berikutnya, buat file header.html dengan konten berikut:

<h1><a href='/'>Test Site</a></h1>

<h6>A New Approach</h6>

<br>

Ini hanya sebuah header dasar tanpa deskripsi, tetapi memberikan CMS sesuatu untuk ditampilkan.
Selanjutnya, buat file footer.html dengan konten ini:

<footer>

[Column1]

    <p>Copyrighted 2012 by <a href="{{{WebAddress}}}/">Your Company</a>

[/Column1]

[Column2]

    <p>Running on a flat CMS server!</p>

[/Column2]

</footer>

Selanjutnya, buat file sidebar.html yang dengan konten ini:

<h3>A Sidebar</h3>

<p>This is a basic sidebar that can have other times.</p>

Sekali lagi, ini adalah placeholder. Semua file tersebut disalin ke direktori site/parts dan diubah sesuai kebutuhan situs. Tujuannya agar server memiliki nama untuk digunakan seandainya pengguna lupa membuatnya.

Struktur Situs

Dengan theme dan layout yang didefinisikan, saatnya untuk menciptakan konten dasar dan struktur untuk situs sebenarnya. Dalam direktori site, buat direktori parts, pages, posts, images, css, js.

Parts (bagian)

Direktori parts akan berisi potongan kecil html/css/javascript yang akan membuat satu unit ditempatkan di beberapa lokasi situs web. Bagian ini masuk ke server dan digabungkan dengan isi halaman jika diperlukan. Untuk situs demo kita, buat bagian berikut:

footer.html dengan code ini:

<footer>

    <p style="float: left;">Copyrighted 2012 by <a href="{{{WebAddress}}}/">Your Company</a>

    <p style="float: right;">Running on a flat CMS server!</p>

</footer>

<script type="text/javascript">

window.PageName = "{{{PageName}}}";

</script>

header.html dengan code berikut:

<link rel="shortcut icon" href="{{{WebAddress}}}/images/favicon.ico" />

headr.html dengan code berikut:

<h1><a href='{{{ServerAddress}}}/'>Test Site</a></h1>

<h6>Flat File System CMS</h6>

navbar.html dengan code berikut:

<div  id="menuh-container">

 <div id="menuh">

    <ul>

     <li>

         <a class="top_parent">Pages</a>

         <ul>

             <li>

                 <a href="{{{WebAddress}}}/flatcms">Flat CMS</a>

             </li>

         </ul>

     </li>

     <li>

        <a href="{{{WebAddress}}}/posts/blogs/flatcms">Blog</a>

     </li>

     <li>

         <a href="{{{WebAddress}}}/posts/news/flatcms"  class="top_parent">News</a>

     </li>

     <li>

         <a href="{{{WebAddress}}}/about"  class="top_parent">About</a>

     </li>

 </ul>

</div>

</div>

sidebar.html dengan code ini:

<h2>Side Bar</h2>

<hr>

socialmedia.html dengan code ini:

<div id="socialmedia">

    <div id="socialbuttons">

        <a href="" class="twitter" title="Twitter"></a>

        <a href="" class="googleplus" title="Google+"></a>

    </div>

    <div id="commentSpacer" class="clearfix"></div>

    <!-- Put other Social Media items here (ie: Disqus, etc.); -->

</div>

Server memuat bagian ini dengan menggunakan nama tanpa ekstensinya dalam template Handlebar untuk perluasan. Sebagai contoh, dimana pun socialmedia.html perlu ditempatkan, Anda menempatkan makro {{{socialmedia}}} disana. Juga, bagian ini dapat berupa HTML, Markdown, atau format apapun yang dapat ditangani oleh server. Dalam server, saya akan membuat file-file pendukung yaitu HTML, Jade/Amber, dan Markdown. Saya akan membahas detail ini di tutorial pembuatan server yang sebenarnya.

Pages (halaman)

Semua halaman untuk situs akan ditempatkan dalam direktori pages. Untuk saat ini, buat file-file berikut dengan konten-nya masing-masing:

main.html dengan code ini:

<h3>Flat CMS Test Site</h3>

<p>This is the Main page of the test site.</p>

flatcms.md dengan code ini:

### Flat CMS Server

This is a page about the flat CMS server.

about.md dengan code ini:

### About

This would be a standard about page.

Ini adalah halaman demo untuk situsnya. Satu-satunya file wajib adalah main.html karena server akan memuat konten halaman ini kedalam memory dan menyediakan dari memory. Ini membantu mempercepat pemuatan halaman depan website. Dua halaman lainnya memiliki ekstensi md karena mereka dalam format Markdown. Server akan menterjemahkan konten ke HTML sebelum menyematkannya di halaman layout.
Umumnya, halaman berisi informasi yang tidak banyak berubah sepanjang waktu. Itu memberikan pemirsa informasi tentang situs, tujuannya dan sasarannya.
Halaman bisa bersifat hirarkis dengan membuat direktori dan subdirektori dengan halaman. Nama direktori ini membuat alamat ke halaman direktori ini.

Posts

Tidak seperti page, post adalah item yang ditambahkan secara regular, misalnya, posting blog harian/mingguan/bulanan dan item berita. Area ini diharapkan untuk sering diupdate. Dalam direktori posts, buat dua direktori baru: blogs dan news. Dimasing-masing direktori tersebut, buat direktori flatcms. Ini akan berisi postingan blog dan item berita untuk website Flat CMS.
Pada direktori posts/blogs/flatcms, buat file-file berikut:

index.amber dengan konten ini:

h3 Flat CMS Blog

p This is a rambling blog about a flat CMS.

mixin article($title, $link, $excerpt, $date)

    div.entry

        div.tutorial_wrap

            div.tutorial_div

                a[href=$link]

                    h3 #{$title}

                h5 #{$date}

                p.tutorial_excerpt #{$excerpt}

    div.clear

+article("Flat CMS Running", "/posts/blogs/flatcms/flatcms", "Flat CMS Test Server is Running!", "August 12, 2015")

flatcms.md dengan konten ini:

The New Server is Running

----

After much work and programming, the flat CMS server is running.  Stay tuned for more news!

{{{socialmedia}}}

Index.amber adalah template Jade untuk menentukan berbagai post yang berbeda di blog. Sistem template HTML Jade memudahkan menambahkan konten baru dengan format yang tepat. Parameter ke makro membentuk item yang berbeda. Anda bisa menemukan lebih banyak informasi tentang Jade di Tuts+.
Di sini, ekstensi yang digunakan adalah amber karena Go language yang setara dengan Jade adalah Amber. Karena di situlah saya memulai, begitulah cara saya membuatnya. Jika Anda ingin mengubah ekstensi, ingatlah untuk mengubahnya dalam kode server yang sesuai juga.
Di direktori posts/news/flatcms, buat file berikut ini:

index.amber dengan konten ini:

h3 Flat CMS News

p Here is where all the news about what I am doing is found. Please come back often to check it out!

mixin article($title, $link, $excerpt, $date)

    div.entry

        div.tutorial_wrap

            div.tutorial_div

                a[href=$link]

                    h3 #{$title}

                h5 #{$date}

                p.tutorial_excerpt #{$excerpt}

    div.clear

+article("Flat CMS is Running", "/posts/news/flatcms/flatcms", "The Flat CMS Test Server is Running!", "August 12, 2015")

flatcms.md dengan konten ini:

The New Server is Running

----

After much work and programming, I finally have everything moved over to a goPress server that I wrote myself. I will be making this available for you too. Stay tuned!

{{{socialmedia}}}

Ini membuat item news untuk demo situs. Di situs saya, saya menggunakan struktur yang sama untuk tutorial dan demo halaman code.

Images

Semua website punya gambar. Dalam konfigurasi ini, semua gambar ada di direktori site/images. Untuk keperluan demo, hanya icon social media yang diletakkan di sini. Anda bisa mendapatkan file gambar dari file download.

Site CSS

Bahkan dengan layout css dan styling css, akan ada waktu dimana Anda ingin aturan css khusus. Direktori site/css berisi semua file css yang menempatkan sentuhan akhir di situs web. Semua layout, styling, dan site/css akan dikompilasi bersama ke dalam satu file css. Karena itu, buatlah direktori site/css/final untuk menempatkan file yang dikompilasi ini. Sekarang, buat file site/css/site.css dengan konten berikut:

.clear {

  clear: both;

  height: 0px;

}

Tidak banyak di sini—hanya definisi untuk class clear. Anda bisa menambahkan apapun yang Anda mau, tapi harus sesuatu yang tidak berkaitan dengan layout atau kategori styling.

Site Scripts

direktori site/js berisi semua file JavaScript spesial untuk situs. Ini akan disusun bersama-sama dan diminimalkan agar memuat halaman situs menjadi lebih cepat. Untuk sekarang, buat direktori site/js/final untuk script yang dikompilasi dan file site/js/01-site.js dengan isi berikut:

;

//

// File:         Site.js

//

// Description:   The JavaScript file for the site.

//

jQuery(document).ready(function () {

    //

    // Code here will be ran once a page is loaded.

    //

});

Tidak banyak di sini, untuk sekarang. Tapi, karena Anda membutuhkan JavaScript kustom, itu bisa diletakkan di sini.
Karena script akan disusun bersama, saya memasukkannya sesuai urutan yang dibutuhkan untuk pemuatan. Aturan untuk mengkompilasi script bersama-sama akan memuat script dalam urutan numerik.

Otomatisasi Dengan Gulp

Cara termudah untuk mempercepat load halaman web adalah dengan memiliki request HTTP sedikit mungkin. Karenanya, lebih baik untuk menggabungkan semua CSS dan JavaScript file ke dalam satu file. Cara terbaik untuk mengkompilasi file ini adalah dengan membuat script. Melakukan hal itu setiap kali server menerima request adalah buang-buang waktu pemrosesan.
Pilihan saya untuk otomatisasi script adalah Gulp. Gulp berjalan pada Node.js. Oleh karena itu, pergi ke website Node.js dan download programnya untuk sistem Anda. Setelah Anda menginstal Node.js, Anda dapat menginstal Gulp dengan ini:

npm install --global gulp

npm install --global gulp

npm install --global gulp-compass

npm install --global gulp-autoprefixer

npm install --global gulp-compressor

npm install --global gulp-concat

Ini akan menginstal Gulp dan Modul Gulp yang saya gunakan di script yang dibuat. Sekarang, di bagian atas direktori Anda, buat file gulpfile.js yang berisi konten berikut:

// Requirements

var gulp = require('gulp'),

     compass = require('gulp-compass'),

     prefix = require('gulp-autoprefixer'),

     compressor = require('gulp-compressor'),

     concat = require('gulp-concat');

// Defines path to sass

var Theme = "Basic";

var Layout = "SingleCol";

var themesassRoot = 'themes/styling/' + Theme;

var layoutsassRoot = 'themes/layouts/' + Layout;

// Gulp task

gulp.task('theme-compass-to-css', function(){

    return gulp.src(themesassRoot+'/sass/Basic.scss')

             .pipe(compass({

                config_file: themesassRoot + '/config.rb',

                css: themesassRoot + '/css',

                sass: themesassRoot + '/sass',

                require: 'sassy-buttons'

                }))

             .pipe(prefix("last 3 versions"))

             .pipe(gulp.dest(themesassRoot + '/css'))

});

gulp.task('layout-compass-to-css', function(){

    return gulp.src(layoutsassRoot+'/sass/base.scss')

             .pipe(compass({

                config_file: layoutsassRoot + '/config.rb',

                css: layoutsassRoot + '/css',

                sass: layoutsassRoot + '/sass',

                require: 'susy'

                }))

             .pipe(prefix("last 3 versions"))

             .pipe(gulp.dest(layoutsassRoot + '/css'))

});

gulp.task('watch-compass', function(){

    // What to watch

    gulp.watch(themesassRoot + '/sass/Basic.scss', function(){

        // What to run

        gulp.run('theme-compass-to-css');

    });

    gulp.watch(layoutsassRoot + '/sass/Basic.scss', function(){

        // What to run

        gulp.run('layout-compass-to-css');

    });

});

gulp.task('all-compass', ['theme-compass-to-css', 'layout-compass-to-css']);

// js compressor

gulp.task('js', function () {

    gulp.src([ layoutsassRoot +'/js/*.js', themesassRoot + '/js/*.js', 'site/js/*.js'])

        .pipe(compressor())

        .pipe(concat("final.js"))

        .pipe(gulp.dest('site/js/final'));

});

// css compressor

gulp.task('css', ['all-compass'], function () {

    gulp.src([layoutsassRoot +'/css/*.css', themesassRoot + '/css/*.css', 'site/css/*.css'])

        .pipe(compressor())

        .pipe(concat("final.css"))

        .pipe(gulp.dest('site/css/final'));

});

gulp.task('default', ['all-compass', 'js', 'css']);

Ini akan menggabungkan semua CSS dan JavaScript ke dalam satu file: di dalam file site/css/final/final.css untuk CSS, dan di dalam file site/js/final/final.js untuk JavaScript. Ini juga akan menambahkan aturan prefix browser untuk CSS Jalankan di direktori utama perintah berikut:

gulp

Gulp akan mengkompilasi semua file kita dan menempatkan mereka di lokasi yang tepat. Setiap tugas yang didefinisikan dalam gulpfile.js dapat dijalankan secara terpisah dengan memberikan nama tugas setelah perintah gulp. Anda bisa mempelajari lebih jauh tentang Gulp di Tuts+.

File Configuration Server

Semua server memerlukan informasi konfigurasi. Karena itu, di root direktori, buat file server.json dengan informasi ini:

{

    "CurrentLayout": "SingleCol",

    "CurrentStyling": "Basic",

    "ServerAddress": "localhost:8080",

    "SiteTitle": "Flat CMS Test Site",

    "Sitebase": "./site/",

    "TemplatBase": "./themes/",

    "Cache": false,

    "MainBase": ""

}

File json ini mendeskripsikan informasi tentang layout yang digunakan, styling yang digunakan, tujuan respon alamat dan port server, nama utama untuk situs dengan sub judul, caching untuk dijalankan dan dimatikan cache untuk keperluan debugging, dan lokasi direktori yang berbeda digunakan untuk situs. Dengan memberikan informasi ini ke server dalam file json, server bisa fleksibel, dengan informasi yang tidak butuh terlalu banyak code.

Mengupload Situs ke Server

Kebanyakan orang menggunakan klien FTP untuk menyalin file ke server mereka. Hal ini mudah dilakukan, tetapi sangat bervariasi mengenai sistem dan program yang digunakan. Tetapi ada beberapa alternatif.
Anda dapat menyiapkan daemon Dropbox untuk memuat situs Anda dari akun Dropbox Anda. Dropbox Wiki punya instruksi detail untuk menyiapkannya. Satu-satunya masalah adalah file secara otomatis terupload ke server ketika Anda membuat perubahan. Kadang-kadang, Anda ingin membuat perubahan tanpa mengupdate ke server. Jika hal ini terjadi, miliki lokasi bebas-Dropbox dari semua file situs dan lokasi Dropbox juga. Ketika selesai, buat tugas di file Gulp Anda untuk menyalin file situs baru ke lokasi Dropbox.

Dropzone 3 Setup for CMS Uploading — Menyiapkan Dropzone 3 Untuk Mengupload CMS

Pendekatan pilihan saya adalah dengan menggunakan Dropzone 3. Anda dapat memprogram Dropzone 3 dengan Ruby atau Python untuk menjalankan file yang dipasangkan padanya. Dropzone 3 juga memiliki banyak fungsi bawaan. Ada file action yang dibangun di untuk meng-upload ke situs FTP/SFTP. Aku membuat satu target Dropzone 3 untuk masing-masing direktori utama di situs saya. Kemudian, ketika saya ingin mengubah atau menambahkan file, saya cukup menyeretnya ke direktori yang sesuai untuk target dropzone. Anda dapat mempelajari lebih lanjut tentang Dropzone 3 dengan tutorial saya Writing Dropzone 3 Actions.

Kesimpulan

File-file dasar ini akan membuat sebuah website yang terlihat seperti ini:

Demo Site in Browser — Situs demo di Browser

Ini adalah hanya permulaan! Sekarang, dengan struktur situs yang ditata, sekarang saatnya untuk mulai membangun server web. Bergabung dengan saya di mana saya akan membangun server web berbasis Go language untuk situs demo ini tutorial selanjutnya.