⚠️ This project is ARCHIVED. Learn more
A simple website for the SMI specification - smi-spec.io
smi-spec.io is a static site. The landing page content can be edited at themes/smi/layouts/index.html, and the rest under /content. Post, tag, and category taxonomy is available in Hugo should we want to expand in the future.
If you'd like to submit an SMI-related blog post to the site, please follow these guidelines:
- Blog posts should be useful and informative for readers, who won't need to buy specific commercial offerings in order to learn something
- Blog posts do not need to exclusively cover open source software, but also should not be primarily product pitches
- Blog posts should disclose and link to the employer of the person writing the blog post
Blog posts are created via pull requests, and should be approved by two reviewers (at least one of whom should work for a different employer than the blog post submitter). You can test locally with hugo and/or see the preview after submitting the pull request.
Add a new file to the content/blog/ directory whose name is the published date and the title. The files must be markdown formatted. See the existing titles for examples of the format. Add the header meta-data to the file using this format (note the permalink structure). Recommended but optional fields are authorname which should be name(s); these are displayed verbatim. authorlink is the link used by authorname.
---
title: "A Fancy Title"
slug: "fancy-title"
authorname: "Captain Awesome"
authorlink: "https://example.com"
date: "2020-03-15T09:00:00+08:00"
---
Add the content below the --- as Markdown. The title does not need to be included in this section. Any images should be placed in the /content/blog/images/ directory. Images should be losslessly compressed to reduce their size. Tools, such as ImageOptim, can be used.
To summarize the content on the blog index page, insert a <!--more--> break in your markdown. This will truncate the content with a Read More link.
To add the logo of your company or organization to the landing page:
- Add your logo to the
themes/smi/static/img/logosdirectory and name itlogo-*.pngwhere*is a slug for your org name (e.g.logo-acme.png). - Add an entry to either the
ecosystemorpartnerslist indata/logos.yaml. Include the following information: an org title, a website URL, and the filename of the logo.
- built with the Hugo static site generator
- custom smi theme uses Paper as a base, with Foundation on top and the SMI custom sass
- deployed to Netlify via merges to main. (@flynnduism, @lachie83 and @bridgetkromhout are admins)
- metrics tracked via Google Analytics
- Hugo installation guide
- packages are installed by running
yarn
// rebuild the site (to compile latest css/js)
hugo
// or serve the site for local dev
hugo serve
The site auto deploys the main branch via Netlify. Once pull requests are merged the changes will appear at smi-spec.io after a couple of minutes. Check the logs for details.
hugo serve will run the site locally at localhost:1313
Service Mesh Interface follows the CNCF Code of Conduct.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent