[U] Update local install method and contributing note

This commit is contained in:
Hykilpikonna 2022-09-10 01:56:29 -04:00 committed by GitHub
parent c099c9e5f7
commit b955a61ac5
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -12,6 +12,7 @@ This repo also serves as an updated version of the original `neofetch` since the
* Method 2: `npx neowofetch` * Method 2: `npx neowofetch`
* Method 3: `bash <(curl -sL neowofetch.hydev.org)` * Method 3: `bash <(curl -sL neowofetch.hydev.org)`
## Installation ## Installation
### Method 1: Install using Python pip (Recommended) ### Method 1: Install using Python pip (Recommended)
@ -26,43 +27,27 @@ pip install hyfetch
Currently, these distributions have existing packages for HyFetch: Currently, these distributions have existing packages for HyFetch:
* ArchLinux: `yay -S hyfetch` (Thanks to @ Aleksana) * ArchLinux: `yay -S hyfetch` (Thanks to [@Aleksana](https://github.com/Aleksanaa))
* Nix: `nix-env -i hyfetch` (Thanks to @ YisuiDenghua) * Nix: `nix-env -i hyfetch` (Thanks to [@YisuiDenghua](https://github.com/YisuiDenghua))
* Guix: `guix install hyfetch` (Thanks to @ WammKD) * Guix: `guix install hyfetch` (Thanks to [@WammKD](https://github.com/WammKD))
### Method 3: Install using git and python ### Method 3: Install the latest developmental version using git
Install Python >= 3.7 first. Then run the following commands:
Run the following commands:
```sh ```sh
git clone https://github.com/hykilpikonna/hyfetch.git git clone https://github.com/hykilpikonna/hyfetch.git
cd hyfetch cd hyfetch
sudo python setup.py install pip install .
``` ```
## Usage ## Usage
When you run `hyfetch` for the first time, it will prompt you to choose a color system and a preset. Just follow the prompt, and everything should work (hopefully). If something doesn't work, feel free to submit an issue! When you run `hyfetch` for the first time, it will prompt you to choose a color system and a preset. Just follow the prompt, and everything should work (hopefully). If something doesn't work, feel free to submit an issue!
If you want to use the updated `neofetch` without LGBTQ flags, check out [this section](https://github.com/hykilpikonna/hyfetch#running-updated-original-neofetch) If you want to use the updated `neofetch` without LGBTQ flags, check out [this section](https://github.com/hykilpikonna/hyfetch#running-updated-original-neofetch)
## Contributing
### Building Hyfetch
clone the git repository using:
`git clone https://github.com/hykilpikonna/hyfetch.git`
cd into the repository's directory
cd into the "tools" directory
run the following command:
`./buildAndClean.sh`
### Running the build
go into the root of the hyfetch directory and run the following command:
`python runner.py`
## Questions and answers ## Questions and answers
@ -78,6 +63,18 @@ Feel free to experiment with it!
![image](https://user-images.githubusercontent.com/22280294/162614553-eb758e4e-1936-472c-8ca7-b601c696c6eb.png) ![image](https://user-images.githubusercontent.com/22280294/162614553-eb758e4e-1936-472c-8ca7-b601c696c6eb.png)
## Contributing
To make changes to our codebase, you first need to create a fork by clicking the "Fork" button on the top right. Then, you can clone your fork of the source code using `git clone https://github.com/{your username}/hyfetch.git`.
After making changes to the source code, you can run `python -m hyfetch` in the root directory of your repo to test out your changes.
If they work correctly, you can commit and push these changes using git command or Github Desktop. Then, you can create a pull request on Github so that it can go into our next release!
You can also install your version locally by running `pip install .` in the repo root.
## Change Log ## Change Log
### About Notation ### About Notation