The icon.community website is the main hub to direct members of the ICON ecosystem to available resources. This site includes blogs, links to other media, and general information about the ICON community!
This repository contains the code and assets for the icon.community site. To preview the site in a local environment, you'll need to install the Hugo static site generator.
Hugo supports multiple platforms including macOS, Windows, and Linux.
For macOS and Linux users, we recommend using Homebrew to install Hugo.
brew install hugo
For Windows users, we recommend using Chocolatey to install Hugo.
choco install hugo -confirm
After installing Hugo, navigate to the project directory and install the npm dependencies with the command below.
npm install
Once the dependencies have been installed, run the command below to start a local Hugo server.
hugo server
Whenever you make a change to the site code or content, Hugo will automatically rebuild the site.
The icon.community site is equipped with a variety of shortcodes that can be used with content files.
This shortcode inserts an anchor element with the href attribute set to an invite link for the ICON Discord.
{{< discord >}}
// Output
<a href="https://discord.com/invite/7a75Hf3cFm">Discord</a>
{{< discord linkText="Join the ICON Discord!" >}}
// Output
<a href="https://discord.com/invite/7a75Hf3cFm">Join the ICON Discord!</a>
This shortcode converts a Markdown table to an HTML table.
{{< table >}}
| Header A | Header B |
|----------|----------|
| Lorem | Ipsum |
| Foo | Bar |
{{< /table >}}
// Output
<div class="overflow-x-auto">
<table>
<thead>
<tr>
<th>Header A</th>
<th>Header B</th>
</tr>
</thead>
<tbody>
<tr>
<td>Lorem</td>
<td>Ipsum</td>
</tr>
<tr>
<td>Foo</td>
<td>Bar</td>
</tr>
</tbody>
</table>
</div>
Redirects are located in the ./static/_redirects file. To add a redirect, simply add a new line containing the old URL, new URL, and HTTP status code (optional). If no HTTP status code is specified, Netlify will automatically use 301 for the status code.
# Redirect /old-url to /new-url with 301 status code.
/old-url /new-url 301
# Redirect /old-url to https://icon.foundation with 302 status code.
/old-url https://icon.foundation
# Redirect /old-file.pdf to /new-file.pdf with 301 status code.
/old-file.pdf /new-file.pdf
If you want to contribute, start working through the icon.community repository, navigate to the Github "issues" tab and start looking through issues. We recommed issues labeled "good first issue". These are issues that we believe are particularly well suited for newcomers. If you decide to start on an issue, leave a comment so that other people know that you're working on it. If you want to help out, but not alone, use the issue comment thread to coordinate.
Please see the ICON Foundation Development Guidelines for information regarding our development standards and practices.
The following is a set of guidelines for contributing to icon.community.
These guidelines are subject to change. Feel free to propose changes to this document in a pull request.
To work on icon.community, you'll need to have a GitHub account, regardless of whether you're contributing to the site, creating content, or fixing issues.
All updates and changes must be made using the GitHub pull request (PR) process. Essentially, you will create a local copy of the website, make your modifications, and request to merge your changes. If you're not familiar with this process, you can find instructions in this icon.community README.md file.
It's not necessary to request permission to work on anything, but it's always smart to inform the main icon.community contributors of your plans. You can do this by commenting on an issue or PR on GitHub, or by reaching out to them on the ICON Discord server.
Decisions regarding ICON's PRs, design evolution, and major upgrades are made by core icon.community contributors, in collaboration with the broader ICON team.
Community input is valued highly and all ICON community members are encouraged to raise any questions or submit PRs.
Discover suggested contributions in the icon.community GitHub Issues tab. Issues labeled with good first issue offer up great suggestions for new contributors to get started with!
For more information on how to contribute to open source projects, check out How to Contribute to Open Source.
The icon.community project is governed by the Contributor Covenant Code of Conduct. Participants are expected to uphold this code.
Note: Github Issues are reserved for feature requests and bug reporting. Please don't create a new Github issue to ask a question.
We have a vibrant developer community and several community resources to ask questions in.