Go to file
Richard Littauer a6512c41dc Use jekyll-twitter-plugin 2018-12-14 10:17:52 -05:00
_data Add forum and chat to navigation 2018-12-05 14:26:42 -05:00
_includes Use Roboto Slab Bold #17 2018-11-20 12:35:49 -05:00
_layouts Sizing zeal correctly 2018-11-15 11:44:10 -05:00
_posts/blog Use jekyll-twitter-plugin 2018-12-14 10:17:52 -05:00
_sass Use Roboto Slab Bold #17 2018-11-20 12:35:49 -05:00
about Adding anchor tags to sections 2018-11-15 11:45:37 -05:00
assets Adding Open Sans #17 2018-11-15 12:12:42 -05:00
blog Resizing blog titles 2018-11-15 11:45:13 -05:00
community Update Meetup link 2018-09-12 10:47:20 -04:00
governance Add page layouts to all of the governance links 2018-09-11 10:59:38 -04:00
grants Contact form partial #4 2018-10-31 14:58:54 -04:00
images Add temporary SVG #28 2018-12-05 14:26:40 -05:00
meetups Update PDF links for meetup guide 2018-12-05 14:26:42 -05:00
resources Adding onepager 2018-11-15 11:39:30 -05:00
search Revert "Remove all webdev files" 2018-09-14 11:59:13 -04:00
tags Revert "Remove all webdev files" 2018-09-14 11:59:13 -04:00
theme-setup Revert "Remove all webdev files" 2018-09-14 11:59:13 -04:00
zcon Add the Zcon workshop repo 2018-09-11 12:27:56 -04:00
.gitignore Add Gulp and documentation 2018-10-31 14:40:38 -04:00
.ruby-version adds .ruby-version for netlify 2018-12-14 10:17:12 -05:00
CNAME Revert "Remove all webdev files" 2018-09-14 11:59:13 -04:00
Gemfile Use jekyll-twitter-plugin 2018-12-14 10:17:52 -05:00
Gemfile.lock Use jekyll-twitter-plugin 2018-12-14 10:17:52 -05:00
LICENSE Add License 2018-08-21 11:57:36 -04:00
README.md Add Gulp and documentation 2018-10-31 14:40:38 -04:00
_config.yml Use jekyll-twitter-plugin 2018-12-14 10:17:52 -05:00
favicon.png Update favicon to help with #28 2018-12-05 14:24:53 -05:00
gulpfile.js Add a js task 2018-11-15 09:34:16 -05:00
index.html Improved homepage content #30 2018-12-05 14:26:42 -05:00
index.md Improve headings #17 2018-11-15 11:49:39 -05:00
package-lock.json Add a js task 2018-11-15 09:34:16 -05:00
package.json Add a js task 2018-11-15 09:34:16 -05:00
search.json Revert "Remove all webdev files" 2018-09-14 11:59:13 -04:00

README.md

ZCash Foundation Website

General Instructions For Developers

The tl;dr is that almost everything we're currently keeping here: https://github.com/ZcashFoundation/ ...should be part of our Jekyll instance, displayable as normal, non-GitHub interface web pages. That way we can continue using GitHub for workflow, and people who are comfortable with it can navigate our files there, but everyone else is able to look at the regular website. Since we're mostly working with .md files anyway, I think that's pretty doable. For reference, here is the current state of our website: https://github.com/ZcashFoundation/zcashfoundation.github.io

Priorities

My technical priorities for the website:

  • Fast-loading
  • Minimal dependencies
  • Easy to maintain
  • Doesn't break any existing URLs / redirect anything that moves Not breaking URLs is a little tricky because there are a million links to our GitHub repos floating around the internet — perhaps the easiest thing will be to archive everything on GitHub and add disclaimers to each document like "please go look at our website instead because it's the maintained source of truth." Suggestions welcome.

Adding Images

The folder images/src is for the images you get pretty much anywhere - all of the images that you haven't yet optimized for the web. Put them in there, and then run:

# In the main directory
$ gulp

...which will go around shrinking them. As an example, it took the zeal-zcash-foundation-feature-image.jpg and shrunk it down to a fourth of the size that it was before.

If you don't have Gulp installed, you can get it by doing this:

$ npm install --global gulp
# And, in this directory...
$ npm install

Never embed images in images/src in a blogpost; they should always be copied over to images automatically by Gulp, and that will ensure that you're serving up nice issues to your users. The way to embed them is using this syntax:

Look at our zealous zebras!

![Zealous zebras](images/zeal-zcash-foundation-feature-image.jpg)

Note that the path is relative to where the Markdown file is. This will look pretty much like this:

Zealous zebras

You can add images directly to images without running Gulp, but they just won't be as small as your users might like. But that's always an option as needed.

Contribute

Work here is largely being done by @RichardLitt and co. If you really want to help out, open an issue?

Still got questions about how this works?

Ping @RichardLitt if you've got questions about this, on GitHub at @RichardLitt or on Twitter at @richlitt.

License

MIT © 2018 Burnt Fen Creative LLC. For now.