From 88ec7d88d1b77a407fd1050d107f3c58ab1804da Mon Sep 17 00:00:00 2001 From: "Mark D. Blackwell" Date: Sat, 1 Oct 2016 22:19:22 -0400 Subject: [PATCH] docs: Improve home page Organize CSS and Javascript files into directories, separating vendor source code from home-grown. Separate new properties and selectors in Bootstrap CSS (already edited for Hugo) from: 1. Original property values; and 2. Changed property values. For the home page: 1. Clarify the English text; 2. Add some element names to classes in CSS selectors (to speed loading); 3. Document the Owl Carousel and Highlight.js versions; 4. Add Owl Carousel's license; 5. Restore HTML comments to browser source views; 6. Make the beginning GitHub button transparent on focus (like the others); 7. For the final, colored Twitter and Github buttons: a. Remove the dotted box on focus; and b. Color them green on active. 8. To increase (layout/) source readability: a. Place `class` attributes before `href` attributes; b. In `class` attributes, place more-specific class names before less-specific; and c. Comment the beginnings and ends of Bootstrap rows. 9. To increase understandability during development: a. Document the meaning of CSS file, `HPstyles` by renaming it to `home-page-style`; b. Move inline styling to CSS stylesheets; c. Separate @media queries to a file; d. Separate the inline Owl Carousel custom Javascript to a file; e. Use regular Owl Carousel CSS files instead of minified ones; and f. Rename the wide, landscape desk background image filename from `desk-long` to `desk-wide`. --- docs/layouts/index.html | 263 ++++++++------ docs/layouts/partials/footer.html | 9 +- docs/layouts/partials/header.html | 9 +- .../static/css/bootstrap-additions-gohugo.css | 65 ++++ docs/static/css/bootstrap-changes-gohugo.css | 136 +++++++ ...hugo.css => bootstrap-stripped-gohugo.css} | 126 ++++--- .../static/css/home-page-style-responsive.css | 44 +++ .../css/{HPstyles.css => home-page-style.css} | 332 +++++++----------- docs/static/css/owl.carousel.min.css | 1 - docs/static/css/owl.theme.default.min.css | 1 - .../img/{desk-long.jpg => desk-wide.jpg} | Bin docs/static/js/owl.carousel-custom.js | 16 + docs/static/vendor/OwlCarousel2/LICENSE | 22 ++ .../OwlCarousel2}/css/owl.carousel.css | 0 .../OwlCarousel2}/css/owl.theme.default.css | 0 .../OwlCarousel2}/js/owl.carousel.min.js | 0 docs/static/vendor/OwlCarousel2/notes.txt | 12 + .../dieulot}/js/instantclick.min.js | 0 .../flesler}/js/jquery.scrollTo.min.js | 0 .../font-awesome/css/font-awesome.min.css | 0 .../font-awesome/fonts/FontAwesome.otf | Bin .../fonts/fontawesome-webfont.eot | Bin .../fonts/fontawesome-webfont.svg | 0 .../fonts/fontawesome-webfont.ttf | Bin .../fonts/fontawesome-webfont.woff | Bin .../fonts/fontawesome-webfont.woff2 | Bin .../highlightjs}/css/monokai-sublime.css | 0 .../highlightjs}/js/highlight.pack.js | 0 docs/static/vendor/highlightjs/notes.txt | 13 + .../jquery}/js/jquery-2.1.4.min.js | 0 .../{ => vendor/twitter}/js/bootstrap.min.js | 0 31 files changed, 679 insertions(+), 370 deletions(-) create mode 100644 docs/static/css/bootstrap-additions-gohugo.css create mode 100644 docs/static/css/bootstrap-changes-gohugo.css rename docs/static/css/{bootstrap-gohugo.css => bootstrap-stripped-gohugo.css} (92%) create mode 100644 docs/static/css/home-page-style-responsive.css rename docs/static/css/{HPstyles.css => home-page-style.css} (51%) delete mode 100644 docs/static/css/owl.carousel.min.css delete mode 100644 docs/static/css/owl.theme.default.min.css rename docs/static/img/{desk-long.jpg => desk-wide.jpg} (100%) create mode 100644 docs/static/js/owl.carousel-custom.js create mode 100644 docs/static/vendor/OwlCarousel2/LICENSE rename docs/static/{ => vendor/OwlCarousel2}/css/owl.carousel.css (100%) rename docs/static/{ => vendor/OwlCarousel2}/css/owl.theme.default.css (100%) rename docs/static/{ => vendor/OwlCarousel2}/js/owl.carousel.min.js (100%) create mode 100644 docs/static/vendor/OwlCarousel2/notes.txt rename docs/static/{ => vendor/dieulot}/js/instantclick.min.js (100%) rename docs/static/{ => vendor/flesler}/js/jquery.scrollTo.min.js (100%) rename docs/static/{assets => vendor}/font-awesome/css/font-awesome.min.css (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/FontAwesome.otf (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/fontawesome-webfont.eot (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/fontawesome-webfont.svg (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/fontawesome-webfont.ttf (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/fontawesome-webfont.woff (100%) rename docs/static/{assets => vendor}/font-awesome/fonts/fontawesome-webfont.woff2 (100%) rename docs/static/{ => vendor/highlightjs}/css/monokai-sublime.css (100%) rename docs/static/{ => vendor/highlightjs}/js/highlight.pack.js (100%) create mode 100644 docs/static/vendor/highlightjs/notes.txt rename docs/static/{ => vendor/jquery}/js/jquery-2.1.4.min.js (100%) rename docs/static/{ => vendor/twitter}/js/bootstrap.min.js (100%) diff --git a/docs/layouts/index.html b/docs/layouts/index.html index 54739159..293dd71e 100644 --- a/docs/layouts/index.html +++ b/docs/layouts/index.html @@ -5,155 +5,198 @@ - Hugo :: A fast and modern static website engine - - + {{ "" | safeHTML }} + - - - - - - - - - + {{ "" | safeHTML }} + + + {{ "" | safeHTML }} + + + + + {{ "" | safeHTML }} + + + + + + - - + {{ "" | safeHTML }}
- + + +
- Docs - Install - Community - GitHub + + Docs + + + Install + + + Community + + + GitHub +
- + {{ "" | safeHTML }} + {{ "" | safeHTML }}
- + + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

Make the Web Fun Again

- Introducing Hugo, a new idea around making website creation simple again. - Hugo flexibly works with many formats and is ideal for + Introducing Hugo, a new idea for making website creation simple again. + Hugo works flexibly with many formats, and is ideal for blogs, docs, portfolios and much more. Hugo’s speed fosters - creativity and makes building a website fun again. + creativity—it makes building a website fun again.

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

Run Anywhere

- Hugo is quite possibly the easiest to install software you’ve ever used, - simply download and run. Hugo doesn’t depend on administrative privileges, databases, runtimes, interpreters - or external libraries. Sites built with Hugo can be deployed on S3, GitHub Pages, Dropbox or any web host. + Hugo is quite possibly the easiest software to install you’ve ever used: + simply download and run! + + Hugo doesn’t depend on administrative privileges, databases, runtimes, + interpreters or external libraries. + + Sites built with Hugo can be deployed on S3, GitHub Pages, Dropbox or any web host.

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

Fast & Powerful

- - Hugo is written for speed and performance. Great care has been - taken to ensure that Hugo build time is as short as possible. - We’re talking milliseconds to build your entire site for most setups. - + Hugo is designed for speed and performance. Great care has been + taken to ensure build time with Hugo is as short as possible. + We’re talking milliseconds to build your entire site—for most setups!

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

Flexible

- - Hugo is designed to work how you do. + Hugo is designed to work the way you do. Organize your content however you want with any URL structure. - Declare your own content types. - Define your own meta data in YAML, TOML or JSON. - Use indexes to group your content however you want. - Best of all this is all done with virtually no configuration, Hugo + Group your content using your own indexes and categories. + Define your own metadata in any format: YAML, TOML or JSON. + Best of all, Hugo handles all these variations + with virtually no configuration. Hugo just works. -

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

+ {{ "" | safeHTML }} + + {{ "" | safeHTML }}
-
- +
+ + {{ "" | safeHTML }}
- {{ partial "quotes.html" ((where $.Site.Data.references.quotes "date" "ge" ($.Now.AddDate -2 0 0) | shuffle )) }} +{{ partial "quotes.html" ((where $.Site.Data.references.quotes "date" "ge" ($.Now.AddDate -2 0 0) | shuffle )) }}
+ {{ "" | safeHTML }} +
-
+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - +
+ {{ "" | safeHTML }} + + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+

Open and Free

@@ -161,70 +204,96 @@

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
+
-

Built with

+

Built with

Hugo is developed with love by spf13 and friends. We welcome all contributions. - New to Go? Not a problem, we will help you. - Not a developer? Help with docs, testing and themes. + New to Go? We’ll help you. + Not a developer? No problem! Help + with docs, testing + and themes.

+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - + {{ "" | safeHTML }}
+ + {{ "" | safeHTML }}
-
-

Getting Started

- Download - Quickstart Guide +
+

Getting Started

+ + Download + + + + Quickstart Guide +

 

Using Homebrew?

brew update && brew install hugo
+ {{ "" | safeHTML }} +
- + {{ "" | safeHTML }} - -