Code for DIF main site, located at: https://identity.foundation
If you're interested in making a commit to the site, or are forking the repo to use it for something else, the following will provide an overview of how to get started, build the site, and run it.
The site was intended to be as easy as possible for folks to extend and contribute to, so we selected a simple approach that requires as little experience with frameworks and build configurations:
/templates/pages
directory.{% extends "base.html" %}
{% block content %}
// YOUR CONTENT HERE
{% endblock %}
{% block scripts %}
// PAGE-SPECIFIC SCRIPTS HERE
{% endblock %}
The site's base file is composed of a handful of page skeletons and partial templates that are shared across all pages. Each pertains to a given part of the base template (i.e. head, nav, footer, etc.), and editing them will change their content across all pages that include them. The partial templates can be found the directory /templates
.
In order to include a list of active repos in your Working Group pages (see the "All Repositories" section here for an example: DID Comms WG), you need to add tags (e.g. wg-<wg_name_here>
) in GitHub for all the repos you want included in the list. After that, ensure the tag you used is included in Gulp file list of tags the renderer uses to pull in content from: Gulp file tag list.
Site content is rendered to the /docs
directory, which is served via GH Pages.
npm install
, to setup dependencies.gulp watch
, which will compile changes every time you save a file and output the completed static pages.serve
package installed, install it globally with npm -g install serve
./docs
directory (cd docs
) and run the serve
command. This will start a local server that allows you to view the site via a localhost
port.