rust-lang-ve/rust-lang-ve.github.io

:octocat: rust-lang-ve's GitHub Page made with Yew because we 💖 Rust!

rust-lang-ve.github.io

rust-lang-ve's GitHub Page made with Yew because we 💖 Rust!

🚴 Development

Requirements

• GitHub Personal Access Token for GPM
• NodeJS (Yarn)
• Cargo

Setting up .npmrc to fetch GPM

This project makes use of a package served by GPM (GitHub Package Manager). In order to fetch this package you must create a .npmrc file in your home directory (touch ~/.npmrc), then go to https://github.com/settings/tokens and clic on Generate new token, create your token with full access to avoid issues fetching the package, copy your token to your clipboard and finally append the following to the .npmrc file you created before.

//npm.pkg.github.com/:_authToken=<YOUR PERSONAL ACCESS TOKEN>

Finally run yarn in the project directory to install packages.

IMPORTANT Do not share your Personal Access Token with anyone! This token grant access to your GitHub profile!

🛠️ Build

When building for the first time, ensure to install dependencies first.

yarn install

yarn run build

🔬 Serve locally

yarn run start

🔋 Batteries Included

• wasm-bindgen for communicating between WebAssembly and JavaScript.
• wee_alloc, an allocator optimized for small code size.

rust-lang-ve.github.io's Issues

Implement About Section

Implement the About section

Layout

About Layout

Functionality

This section have no featured behavior.

Implement Home Section

Implement the Home section

Layout

Home Layout

Functionality

The Home section should have two actions available:

1. Open Telegram group in new tab when clicking on Únete al grupo en Telegram! button.

• Link: https://t.me/rustlangVE

2. Open Rust official website when clicking on Rust linnk

• Link: https://www.rust-lang.org/

Code of Conduct must be a collapsible box

Implement a collapsible box as a Yew component for the Code of Conduct section based on the HTML implemented by rust-lang-ve/design#7.

Implement Projects Section

Implement the Projects section

Layout

Projects Layout

Functionality

The Projects section should fetch the repositories from GitHub and list all of them if more than 10 repositories are available then a toggle should be shown to hide the half of the section.

Design

Section links make the page reload

Currently when clicking on a section link the page reloads instead of just scrolling to the section.

Feature | Issues Tab

Implement the issues tab to display available issues for the organization

Layout

https://github.com/rust-lang-ve/design/blob/main/layout/src/markup/github-radar/issues/index.hbs

Funtionality

The Issues tab must display all available issues for the organization

Implement Contributors Section

Implement the Contributors section

Layout

Contributors Layout

Functionality

The contributors section should fetch contributors from organization through the GitHub API and list them.
Contributors must be shown in random order every time the site refresh.

Design

No support for repositories with no description

Background

Repositories from GitHub are represented by the Repository struct as follows.

pub struct Repository {
  pub description: String,
  pub language: Lang,
  pub name: String,
}

Where description and name expects a String value and language a fixed value from the Lang enum.

Issue

Some repositories may not have a description defined at the moment of fetching repositories from GitHub, breaking the deserialization process and resulting in a call to FetchFailed.

Solution

Add support for repositories with no description, making the description an optional value.