|
1 | 1 | ## Contributing |
2 | 2 |
|
| 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 | + |
3 | 8 | ### Project Structure & file description |
4 | 9 | The project is structured as follows: |
5 | 10 | ``` |
@@ -41,16 +46,24 @@ cmdCompass/ |
41 | 46 | ├── __init__.py |
42 | 47 | └── utils.py # Contains utility functions for various tasks. |
43 | 48 | ``` |
| 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 | + |
44 | 60 | ### Main GUI Classes Breakdown |
45 | 61 | <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"> |
46 | 62 |
|
47 | 63 | ### Customtkinter |
48 | 64 | 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. |
49 | 65 | CustomTkinter provides a set of themed widgets that are designed to look modern and consistent across different operating systems. |
50 | 66 |
|
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 | | - |
54 | 67 | ### Man Page Loading Process |
55 | 68 | 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. |
56 | 69 |
|
|
0 commit comments