mirror of
https://github.com/athityakumar/colorls.git
synced 2024-09-12 05:31:14 +02:00
Adds some more markdown files
This commit is contained in:
parent
3d7522c14d
commit
d421ce9ce7
3 changed files with 68 additions and 21 deletions
45
CONTRIBUTING.md
Normal file
45
CONTRIBUTING.md
Normal file
|
@ -0,0 +1,45 @@
|
||||||
|
# Contribution guidelines
|
||||||
|
|
||||||
|
First of all, thanks for thinking of contributing to this project. :smile:
|
||||||
|
|
||||||
|
Before sending a Pull Request, please make sure that you're assigned the task on a GitHub issue.
|
||||||
|
|
||||||
|
- If a relevant issue already exists, discuss on the issue and get it assigned to yourself on GitHub.
|
||||||
|
- If no relevant issue exists, open a new issue and get it assigned to yourself on GitHub.
|
||||||
|
|
||||||
|
Please proceed with a Pull Request only after you're assigned. It'd be sad if your Pull Request (and your hardwork) isn't accepted just because it isn't idealogically compatible.
|
||||||
|
|
||||||
|
# Developing the gem
|
||||||
|
|
||||||
|
1. Install with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone
|
||||||
|
cd colorls
|
||||||
|
gem install bundler
|
||||||
|
bundle install
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Make your changes in a different git branch. These changes can be
|
||||||
|
|
||||||
|
- add better icons to [YAML files](lib/yaml/)
|
||||||
|
- add more flag options to the ruby gem.
|
||||||
|
|
||||||
|
|
||||||
|
3. (Optional) To test whether `lc` is working properly, do
|
||||||
|
```sh
|
||||||
|
rake install
|
||||||
|
lc # start using lc
|
||||||
|
```
|
||||||
|
|
||||||
|
4. (Required for YAML file changes) These are the specifications for the YAML files -
|
||||||
|
|
||||||
|
- `files.yaml`, `folders.yaml` : The keys are sorted alphabetically.
|
||||||
|
- `file_aliases.yaml`, `folder_aliases.yaml` : The values are sorted alphabetically. For each set of keys mapping to a value, those set of keys are also sorted alphabetically.
|
||||||
|
|
||||||
|
5. Check before pushing
|
||||||
|
|
||||||
|
```sh
|
||||||
|
bundle exec rubocop
|
||||||
|
bundle exec rspec
|
||||||
|
```
|
|
@ -1,6 +1,6 @@
|
||||||
The MIT License (MIT)
|
The MIT License (MIT)
|
||||||
|
|
||||||
Copyright (c) 2017 Athitya
|
Copyright (c) 2017 [Athitya Kumar](https://github.com/athityakumar/)
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
of this software and associated documentation files (the "Software"), to deal
|
40
README.md
40
README.md
|
@ -7,9 +7,20 @@
|
||||||
|
|
||||||
A Ruby script that colorizes the `ls` output with color and icons. Here are the screenshots of working example on an iTerm2 terminal (Mac OS), `oh-my-zsh` with `powerlevel9k` theme and `powerline nerd-font + awesome-config` font with the `Solarized Dark` color theme.
|
A Ruby script that colorizes the `ls` output with color and icons. Here are the screenshots of working example on an iTerm2 terminal (Mac OS), `oh-my-zsh` with `powerlevel9k` theme and `powerline nerd-font + awesome-config` font with the `Solarized Dark` color theme.
|
||||||
|
|
||||||
|
# Table of contents
|
||||||
|
|
||||||
|
- [Usage](#usage)
|
||||||
|
- [Installatation](#installation)
|
||||||
|
- [Optional configurations](#optional-configurations)
|
||||||
|
- [Uninstallation](#uninstallation)
|
||||||
|
- [Contribute to this gem](CONTRIBUTING.md)
|
||||||
|
- [License](LICENSE.md)
|
||||||
|
|
||||||
![Example #1](readme/usage1.png)
|
![Example #1](readme/usage1.png)
|
||||||
|
|
||||||
# How to use
|
# Usage
|
||||||
|
|
||||||
|
[Back to top](#table-of-contents)
|
||||||
|
|
||||||
- Just `lc` : Prints all directories, files and dotfiles in current directory.
|
- Just `lc` : Prints all directories, files and dotfiles in current directory.
|
||||||
|
|
||||||
|
@ -38,14 +49,18 @@ A Ruby script that colorizes the `ls` output with color and icons. Here are the
|
||||||
|
|
||||||
![Usage #9](readme/usage9.png)
|
![Usage #9](readme/usage9.png)
|
||||||
|
|
||||||
# Installation steps
|
# Installation
|
||||||
|
|
||||||
|
[Back to top](#table-of-contents)
|
||||||
|
|
||||||
1. Install Ruby (prefably, version > 2.1)
|
1. Install Ruby (prefably, version > 2.1)
|
||||||
2. Install the patched fonts of powerline nerd-font and/or font-awesome.
|
2. Install the patched fonts of powerline nerd-font and/or font-awesome.
|
||||||
3. Install the [colorls](https://rubygems.org/gems/colorls/) ruby gem with `gem install colorls`
|
3. Install the [colorls](https://rubygems.org/gems/colorls/) ruby gem with `gem install colorls`
|
||||||
4. Start using `lc` :tada:
|
4. Start using `lc` :tada:
|
||||||
|
|
||||||
# Tweaking the configurations
|
# Optional configurations
|
||||||
|
|
||||||
|
[Back to top](#table-of-contents)
|
||||||
|
|
||||||
1. To add some flag options by default, add this to your shell configuration file (`~/.bashrc`, `~/.zshrc` or `~/.fishrc`) :
|
1. To add some flag options by default, add this to your shell configuration file (`~/.bashrc`, `~/.zshrc` or `~/.fishrc`) :
|
||||||
```sh
|
```sh
|
||||||
|
@ -59,24 +74,11 @@ subl $(gem which colorls)/../yaml/
|
||||||
|
|
||||||
_NOTE: If you're using iTerm2 on Mac, you may have to enable the nerd-font at iTerm2 > Preferences > Profiles > Text > Non-Ascii font > Knack Regular Nerd Font Complete_
|
_NOTE: If you're using iTerm2 on Mac, you may have to enable the nerd-font at iTerm2 > Preferences > Profiles > Text > Non-Ascii font > Knack Regular Nerd Font Complete_
|
||||||
|
|
||||||
# Uninstallation steps
|
# Uninstall
|
||||||
|
|
||||||
|
[Back to top](#table-of-contents)
|
||||||
|
|
||||||
Want to uninstall and revert back to the old style?
|
Want to uninstall and revert back to the old style?
|
||||||
```sh
|
```sh
|
||||||
gem uninstall colorls
|
gem uninstall colorls
|
||||||
```
|
```
|
||||||
|
|
||||||
# Tweaking this project
|
|
||||||
|
|
||||||
![Pending formats](readme/pending.png)
|
|
||||||
|
|
||||||
There are a couple of formats that aren't recognized yet. Custom file formats and icons can be added by changing the YAML files in this repository. Also, feel free to send a Pull Request here with the added icons. :smile:
|
|
||||||
|
|
||||||
Please feel free to contribute to this project, by
|
|
||||||
- opening an issue for reporting any bug / suggesting any enhancement.
|
|
||||||
- cleaning up the ruby scripts of the gem.
|
|
||||||
- adding support for more icons by editing the [YAML files](lib/yaml/).
|
|
||||||
|
|
||||||
# LICENSE
|
|
||||||
|
|
||||||
MIT License 2017 - [Athitya Kumar](https://github.com/athityakumar/).
|
|
||||||
|
|
Loading…
Reference in a new issue