Skip to content

Commit fa23f04

Browse files
authored
Contributing Steps and Dev Env Setup
1 parent 9e1e9c3 commit fa23f04

1 file changed

Lines changed: 16 additions & 3 deletions

File tree

CONTRIBUTING.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
## Contributing
22

3+
### Contributing Steps
4+
1. **Fork the repository**: Click the "Fork" button in the top-right corner of the repository page.
5+
2. **Clone your fork and make changes to it**.
6+
3. **Open a pull request**: On GitHub, go to your forked repository, select your branch, and click the "New pull request" button.
7+
38
### Project Structure & file description
49
The project is structured as follows:
510
```
@@ -41,16 +46,24 @@ cmdCompass/
4146
├── __init__.py
4247
└── utils.py # Contains utility functions for various tasks.
4348
```
49+
### Development Environment
50+
Set up Python environment by:
51+
```
52+
pip install -r requirements.txt
53+
```
54+
For Mac users, you will want to have `groof` installed to be able to convert man pages to HTML. Please install `groff` by:
55+
```
56+
brew install groff
57+
```
58+
You can then run `main.py` from the `cmdcompass` directory to start the program in your IDE.
59+
4460
### Main GUI Classes Breakdown
4561
<img width="703" alt="Screenshot 2024-05-30 at 3 05 12 PM" src="https://github.com/johnwangwyx/cmdCompass/assets/78456315/99e2d354-18ca-4564-a483-c273309fa23b">
4662

4763
### Customtkinter
4864
The application utilizes the [customtkinter](https://github.com/TomSchimansky/CustomTkinter) library, a modern and visually appealing toolkit for creating graphical user interfaces (GUIs) with Python.
4965
CustomTkinter provides a set of themed widgets that are designed to look modern and consistent across different operating systems.
5066

51-
### Main Application Entry Point (main.py)
52-
The main entry point for the application is the `cmdcompass/main.py` file. This file initializes the MainWindow class, which is responsible for setting up the entire user interface (UI) of the application.
53-
5467
### Man Page Loading Process
5568
Below are the steps that cmdCompass retrieves the package containing the man page, downloads the package, extract it, and convert the man page to HTML.
5669

0 commit comments

Comments
 (0)