dlab-berkeley / dlab-berkeley.github.io Goto Github PK

• Jekyll automatically compiles SASS in addition to the markdown -> HTML step
• In particular, we are using the bourbon and neat libraries.
• I believe I also stole the responsive header from bitters.

• What is a static site?
• Jekyll Docs
• Orientation to the D-Lab's static site (hosted right here in this repo!)

First as truly static, if that flies, then try dynamic generation with GitHub API / JS.

Can you use your own domain (instead of *.github.io)?

If yes, what DNS do we point the domain to?

• "Vanilla Python" - Pandas and friends
• Savio / Slurm
• PySpark
• High Performance Python (e.g., Numba, Dask)
• BidMat

Cross cutting issues - pros / cons, how-to, and benchmarks.

• Get those files from the github repo
• Just copy them into the dlab-berkeley site (in an appropriate place - don't edit them at first!)
• Make any necessary tweaks

• Clarify conventions about the command line (what does $ signify?)
• Note that you have to open http://localhost:4000 in your browser
• If you're running the default ruby, you need to sudo gem install github-pages

The site is a bit jumbled, let's have a look and "clean things up a little," shall we?

How would folks like to take a tour of the site?

• As a live website?
• Looking at the tree below?
• On the GitHub view of the repo?
• The current layout of our site:

.
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── _config.yml
├── _includes
│   ├── head.html
│   └── info.html
├── _layouts
│   └── default.html
├── _sass
│   ├── base
│   │   ├── _base.scss
│   │   ├── _buttons.scss
│   │   ├── _forms.scss
│   │   ├── _grid-settings.scss
│   │   ├── _lists.scss
│   │   ├── _tables.scss
│   │   ├── _typography.scss
│   │   └── _variables.scss
│   ├── bourbon
│   │   ├── <installed libraries you don't need to mess with!>
│   ├── neat
│   │   ├── <ditto - nothing to see here>
├── _site
│   ├── <contains the *compiled* version of our site - **don't edit these files!**>
├── about.md
├── css
│   └── dlab.scss
├── index.md
├── jekyll.md
├── jobs.md
├── js
│   ├── jquery-2.1.4.min.js
│   └── nav.coffee
└── learning.md

• Look at the brief instructions on our about page. For now, even if you have permissions, please make a fork first.
• That content is written in markdown (actually, kramdown).
  • Note the metadata at the top
  • The "real" file can be viewed with the "Raw" button
• There are lots of fussy details managed via a file called _config.yaml (e.g., why do pages show up as folders?) - but don't worry about this for now!
• Find a page you'd like to improve, delete, merge with another, etc. And make the change! Please push your changes to your fork.

"You can't do both?"

Then what do I do?

cc @rive-crc

How would folks like to take a tour of the site?

• As a live website?
• Looking at the tree below?
• On the GitHub view of the repo?
• The current layout of our site:

.
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── _config.yml
├── _includes
│   ├── head.html
│   └── info.html
├── _layouts
│   └── default.html
├── _sass
│   ├── base
│   │   ├── _base.scss
│   │   ├── _buttons.scss
│   │   ├── _forms.scss
│   │   ├── _grid-settings.scss
│   │   ├── _lists.scss
│   │   ├── _tables.scss
│   │   ├── _typography.scss
│   │   └── _variables.scss
│   ├── bourbon
│   │   ├── <installed libraries you don't need to mess with!>
│   ├── neat
│   │   ├── <ditto - nothing to see here>
├── _site
│   ├── <contains the *compiled* version of our site - **don't edit these files!**>
├── about.md
├── css
│   └── dlab.scss
├── index.md
├── jekyll.md
├── jobs.md
├── js
│   ├── jquery-2.1.4.min.js
│   └── nav.coffee
└── learning.md