| commit | 5e553e5ea508c4cff337fe97622d48627e04bb5e | [log] [tgz] |
|---|---|---|
| author | Ali Ghassemi <aghassemi@google.com> | Thu Jun 09 11:39:39 2016 -0700 |
| committer | Ali Ghassemi <aghassemi@google.com> | Thu Jun 09 11:39:39 2016 -0700 |
| tree | 0136afb42708fbdb3f37cacfbb2e0cd278857925 | |
| parent | ebdc054dc8f653b95c7cafaa11cacc674be9c085 [diff] |
website: landing page and some polish https://screenshot.googleplex.com/22m8BsSMxVf.png https://screenshot.googleplex.com/deYXS3X4mrx.png https://screenshot.googleplex.com/THrneOaJHJW.png -Add the landing page that separates Syncbase and Vanadium Core -Updated Vanadium Core landing page (mostly UI polish based on existing content) -Increases the width of the page. -Other small UI polish. -Updates obsolete content: -remove device manager concept doc -remove old syncbase concept doc -update example apps for Vanadium Core Change-Id: I7cc09c32f902d4b919da72fdb433d30d89c02deb
This repository contains the source code for generating the static assets for the Vanadium website.
browser - Client-side JS that executes when users visit the websitebuild - Output location for make buildcontent - Markdown content; gets converted to HTML by haikuhelpers.js - JS used by haiku when rendering Markdown filesnode_modules - Disposable directory created by npm installpackage.json - Tells npm install what to installpublic - Static assets, copied directly into the build directorystylesheets - LESS stylesheets, compiled into CSS for the websitetemplates - Mustache templates used by haiku for layouts and partialstools - Tools involved in generating the site's static assetsInstall Vanadium per the installation instructions on the website. Also, install the Node.js profile using jiri profile install v23:nodejs.
You can make and view changes locally by running a development server:
make serve
This command will print out a URL to visit in your browser. It will take a few minutes to run the first time around, but subsequent invocations will be fast.
By default, the running server will not reflect subsequent changes to the website content, since it's just serving the assets in the build directory. Running make build will cause the server to see the new content. Better yet, use the following command to automatically rebuild the assets whenever something changes:
make watch
This command requires the entr program, which can be installed on Debian/Ubuntu using apt-get install entr, and on OS X using brew install entr.
Add or modify Markdown-formatted files in the content directory.
The haiku tool provides some extra flexibility on top of standard Markdown by processing Mustache template variables. For example:
= yaml =
title: My Creative Title
author: Alice
= yaml =
# {{ page.title }}
Author: {{ page.author }}
A common editing workflow is to run make watch, edit Markdown files in a text editor, and refresh the browser to see changes. If you prefer a WYSIWYG editing experience, there are a number of options, e.g.:
For new content, it's common to do initial drafting and editing in Google Docs, and to switch to Markdown at publication time.
The make build task generates public/css/bundle.css and public/js/bundle.js from the files in stylesheets and browser respectively. To modify the website CSS or JS, edit those files, then rebuild the site (or use make watch to have your changes trigger rebuild).
Jenkins automatically deploys to production on every successful build of vanadium-website-site target.