octicons

Crates.ioocticons
lib.rsocticons
version0.2.0
sourcesrc
created_at2017-11-09 19:24:07.580362
updated_at2023-09-22 19:02:54.015806
descriptionA scalable set of icons handcrafted with <3 by GitHub ported for use in Rust.
homepage
repository
max_upload_size
id38767
size97,862
yam (YetAnotherMinion)

documentation

https://docs.rs/octicons/

README

Octicons in Rust

This is a library that will let you easily include svg octicons in your rust server side templates. The icons and their path data are exposed as static variables. Clone the statics and use the builder functions to configure the icon's attributes.

Install

  1. Add this to your Cargo.toml

    octicons = "0.1"
    
  2. Add the crate to your main.rs or lib.rs

    extern crate octicons;
    
  3. Use the static structs in your server side templates

    format!("{}",
        octicons::ARROW_DOWN.clone()
            .xmlns(Some("http://www.w3.org/2000/svg"))
            .width(32)
            .height(32)
            .fill(Some("#ff0"))
            .aria_label(Some("hi"))
            .class(Some("right left"))
    );
    

Documentation

Crate documentation can be found at docs.rs/octicons/

Publishing

If you have access to publish this repository, these are the steps to publishing. If you need access, contact #design-systems.

Before publishing This package relies on the data from octicons. To update to the most recent version, you'll need to run make prepare

  1. Update the CHANGELOG.md with relevant version number and any updates made to the repository.
  2. Update the version in Cargo.toml using the relevant version. The versioning is semver, so version appropriately based on what has changed.
  3. cargo package --allow-dirty Allow including the svg files needed by the build.rs
  4. cargo publish This will build the crate and publish it to crate.io.
  5. git push && git push --tags Push all these changes to origin.

License

(c) 2012-2017 GitHub, Inc.

When using the GitHub logos, be sure to follow the GitHub logo guidelines.

Font License: SIL OFL 1.1
Applies to all font files and SVG files

Code License: MIT
Applies to all other files

Commit count: 0

cargo fmt