2020-02-06 13:17:32 -08:00
|
|
|
# jamestmartin.me
|
2020-08-30 15:26:18 -07:00
|
|
|
This is the source code for my personal website, [jamestmartin.me](https://jamestmartin.me).
|
2020-02-06 13:17:32 -08:00
|
|
|
|
2020-02-06 15:34:02 -08:00
|
|
|
## Installation
|
2020-08-30 15:26:18 -07:00
|
|
|
This project is built using [Jekyll](https://jekyllrb.com/), a static site generator.
|
2020-02-06 15:34:02 -08:00
|
|
|
|
2020-08-30 15:26:18 -07:00
|
|
|
To install this website, you must first [install Jekyll](https://jekyllrb.com/docs/installation/).
|
2020-02-06 15:34:02 -08:00
|
|
|
Next, install all necessary modules with `bundle exec`.
|
|
|
|
|
|
|
|
|
|
To build the site, run `bundle exec jekyll build`.
|
|
|
|
|
To rebuild the site continuously as updates are made,
|
|
|
|
|
run `bundle exec jekyll build --watch`.
|
|
|
|
|
The web root for the website will be `_site/`.
|
|
|
|
|
You may point your web server there and the site will work with no additional effort.
|
|
|
|
|
|
|
|
|
|
To work on the site without installing full web server, use `bundle exec jekyll serve`.
|
|
|
|
|
|
2020-02-06 13:17:32 -08:00
|
|
|
## Code Conventions
|
2020-08-30 15:26:18 -07:00
|
|
|
All of my code is valid HTML5 and CSS3 according to [WHATWG standards](https://html.spec.whatwg.org)
|
2020-02-06 13:17:32 -08:00
|
|
|
|
2020-08-30 15:26:18 -07:00
|
|
|
I follow the [Google HTML/CSS Style Guide](https://google.github.io/styleguide/htmlcssguide.html).
|
2020-02-06 13:17:32 -08:00
|
|
|
Google recommends dropping optional tags wherever possible;
|
2020-08-30 15:26:18 -07:00
|
|
|
I know how to write valid XHTML polyglot as well, but choose not to as per the style guide.
|
