1
0
mirror of https://github.com/SimonPistache/famfamfam-silk-svg.git synced 2025-09-10 22:26:28 +02:00

Improve presentation (#188)

* feat: Init Contribution and fill Readme

* docs: Add illustrations to readme, write contribution

Add more details on the various sections of the ReadMe and illustrations. Complete the Contribution file with descriptions and more guidelines. Contains changes for milestones 2.

* docs: Merge CONTRIBUTING and README

To start small, I don't think I need a CONTRIBUTING, CODE_OF_CONDUCT and CHANGELOG files. All should fit in the README for now.

* refactor: Update Readme with link to CC docs.

Also remove the `thumb up` and `thumb down` icons, as they are not completed yet.

* fix: Remove references to the Figma UI Kit.

The Figma Kit will be linked back here when it will be published on the Community.

* refactor: Update readme

* refactor: Update ReadMe

Change some illustration from PNG to SVG.

* fix: backlinks not working on github

* fix: backlink not respecting file Capitalization

* style(identity): decorate headers with icons

Replace emojis with icons (because why not)

* fix(identity): remove inline css in imgs

Github eat custom inline CSS in the style attributes to put its own. It's better to have icons on the right for now.

* fix(identity): fix a header issue in ReadMe

* fix(identity): Reduce icons size to match github headers hights

* Revert "fix(identity): Reduce icons size to match github headers hights"

This reverts commit 2ae463bdbb.
This commit is contained in:
Simon Pistache
2025-01-31 17:53:22 +01:00
committed by GitHub
parent c8fd547e07
commit 7cf5468035
10 changed files with 251 additions and 29 deletions

View File

@@ -1,16 +1,86 @@
# famfamfam-silk-svg
A recreation of the iconic iconset of the 2010s era from Marc James, remade in SVG and as a figma UI kit for todays developpers and designers needs.
<img align="center" src="./public/github-cover.png">
## License
# FamFamFam Silk as SVG
> The iconic iconset of the 2010s era from Mark James, remade in SVG for todays needs.
I have not settled on the right licence for this product, so as for now I'll follow Mark James' Create Commons Attribution. He used 2.5, but I picked version 4.
I would like a more protective licence, one that could permit company and users to pick stuff here and use them in commercial products and marketing material, but prevent "stealing" stuff or changing ownership over minimal visual changes.
This project contains ~1000 icons in SVG. SVG is lightweight, scalable compared to PNG — and open format, allowing anyone to edit it to his/her needs. I aim to have all the original icons remastered, but also create more up-to-date versions (Smartphones was not a thing back in 2008). Plus, most icons can be mixed with decorators (bullets) to get more meaning.
## Contribution
Scale: <img height=16px src="icons/Cup.svg"> <img height=24px src="icons/Cup.svg"> <img height=32px src="icons/Cup.svg"> <img height=48px src="icons/Cup.svg"> <img height=64px src="icons/Cup.svg">
- All enhancement are welcomed
- Contributions must be in form of a PR to the main branch
Mix: ![Cup of caffee](<public/Cup of caffe.svg>) + ![Bullet delete](<icons/Bullet delete.svg>) = ![A cup of caffe with a delete bullet at its bottom right](<public/I should stop caffe.svg>)
Contributions can be
- fixes or improvements over the existing icons
- new icons in the strict aestetics of the original work
Customize: ![Cup of caffee](<public/Cup of caffe.svg>) ![Cup of Matcha latte](<public/Cup of matcha.svg>) ![Cup of Tea](<public/Cup of tea.svg>) ![Cup of water](<public/Cup of water.svg>)
## How to use <img height=30px src="icons/Accept.svg">
* Clone or fork the repository.
* Download files from the [icons](./icons/) folder.
![All available icons](./public/available-icons.png)
### <img height=24px src="icons/Date.svg"> Roadmap
* (Soon) Designers: Get the Figma UI Kit
* (Soon) Access to more decorators
* (Soon) Access to variants
* (Soon) Access to parts
## Contributing <img height=30px src="icons/Paintbrush.svg">
Reports, Requests and Contributions are welcomed to this project! I believe that healthy debate and disagreement are essential to a healthy project and community. However, it is never ok to be disrespectful.
### <img height=24px src="icons/Bug.svg">  I would like to report a bug or suggest something!
The issue section is the right place for you to describe your problem. Specific rules applies, and not following them may result in the closing of the issue.
* Issue must have a label related to your topic
* Issue must be sufficiently described, clear and not misleading
* Issue may be flagged as _duplicate_ if the topic is already discussed on another issue.
* There is no garanties that an Issue will be resolved. I have limited bandwidth.
### <img height=24px src="icons/Wand.svg">  Can I create an icon too?
Sure! Please *Fork**Create**Push**Pull Request*, follow the [Pull Request & commits guidelines](#pull-request-and-commit-guidelines), and the [Icon Design guidelines](#icon-design-guidelines) below.
### <img height=24px src="icons/Wrench.svg">  I have fixed this icon, how can I give it back?
Thank you! Please *Fork**Patch**Push**Pull Request* and follow the [Pull Request & commits guidelines](#pull-request-and-commit-guidelines), and the [Icon Design guidelines](#icon-design-guidelines) below.
### Pull Request and Commit Guidelines
- It should stick to the [community's best practices](https://github.com/kubernetes/community/blob/master/contributors/guide/pull-requests.md#best-practices-for-faster-reviews) as close as possible
- It must follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/#summary) principles in commit and PR names.
- It must be related to an issue in this project.
- Authors of contribution are credited (via the Contributor section of Github)
### Icon Design Guidelines
- Icons must be in the **style and spirit of the original work** from Mark James.
- Icons must be in **SVG**.
- Icons must be designed to be **legible in any size from 16×16px to 64×64px**. It must have the right balance between too much details and too little. I recommand using a grid of 16×16 to help.
- Icon improvement based on existing icons must be as close as possible to the original design, especially at 16×16px.
- Icon must render without visual artefact in today's broswer such as WebKit, Blink, Gecko. (Test your icons)
## License <img height=30px src="icons/Report.svg">
This project is licensed under the [**Creative Commons BY 4**](https://creativecommons.org/licenses/by/4.0/) license. This content is distributed in the hope that it will be useful, but **without any warranty**; without even the implied warranty of **merchantability** or **fitness for a particular purpose**.
## Acknowlegements <img height=30px src="icons/Heart.svg">
The Original *FamFamFam Silk* icon pack ([github](https://github.com/markjames/famfamfam-silk-icons) • [website](http://www.famfamfam.com/lab/icons/silk/)) remains the property of Mark James. Mark, please have my thanks and salute for your great work.
#### Fonts
- [Fira Mono](https://github.com/mozilla/Fira)
- [Fira Sans](https://github.com/mozilla/Fira)
- [Fira Sans Condensed](https://github.com/mozilla/Fira)
- [Love Ya Like a Sister](https://fonts.google.com/specimen/Love+Ya+Like+A+Sister) by [Kimberly Geswein](https://kimberlygeswein.com/)
- [Segoe UI](https://learn.microsoft.com/en-us/typography/font-list/segoe-ui) (for Office logos)
- [Hind](https://fonts.google.com/specimen/Hind) by the [Indian Type Foundry](https://www.indiantypefoundry.com/)
#### Softwares
- [Figma](https://www.figma.com) as the SVG design software
- [Firefox](https://www.mozilla.org/firefox/new/)
- [Gitea](https://about.gitea.com/), an awesome self-hosted github alternative
- [VSCodium](https://vscodium.com/), a community-driven, freely-licensed binary distribution of Microsofts editor VS Code
#### About me
Hi I'm Simon. Computer enthousiast, I have recently switch to become a Product.UX.UI Designer, and used to be a Quality Engineer. I love to create stuff and share it.
[linkedin](https://www.linkedin.com/in/simonpriet/) • [behance](https://www.behance.net/SimonPistache#) • [dribbble](https://dribbble.com/SimonPistache) • [github](https://github.com/SimonPistache)