|
| 1 | +# PY File Editor |
| 2 | + |
| 3 | +This is a simple file editor application built using Python's `tkinter` library. It includes basic features such as opening, saving, and editing text files, with a simple graphical user interface. The editor also includes a line number bar for easy navigation. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- **Open File:** Allows you to open any file and view its content in the text area. |
| 8 | +- **Save File:** Allows you to save the current content of the text area to a file. |
| 9 | +- **Save As:** Allows you to save the current content of the text area as a new file. |
| 10 | +- **Line Numbers:** Displays line numbers next to the text area for easy reference. |
| 11 | +- **Font Change:** Allows you to change the font of the text area (currently only Arial is available). |
| 12 | + |
| 13 | +## Requirements |
| 14 | + |
| 15 | +- Python 3.x |
| 16 | +- `tkinter` library (usually included with Python) |
| 17 | + |
| 18 | +## Installation |
| 19 | + |
| 20 | +1. Clone the repository: |
| 21 | + ```bash |
| 22 | + git clone https://github.com/lorenz-MotionGraphics/python_project.git |
| 23 | + cd python_project |
| 24 | + ``` |
| 25 | + |
| 26 | +2. (Optional) Create a virtual environment: |
| 27 | + ```bash |
| 28 | + python -m venv venv |
| 29 | + source venv/bin/activate # On Windows use `venv\Scripts\activate` |
| 30 | + ``` |
| 31 | + |
| 32 | +3. Install the required packages: |
| 33 | + ```bash |
| 34 | + pip install -r requirements.txt # Currently, there are no external packages required. |
| 35 | + ``` |
| 36 | + |
| 37 | +4. Run the application: |
| 38 | + ```bash |
| 39 | + python editor.py |
| 40 | + ``` |
| 41 | + |
| 42 | +## Usage |
| 43 | + |
| 44 | +1. **Open File:** Go to the `File` menu and click `Open`. Select the file you want to open. |
| 45 | +2. **Save File:** Go to the `File` menu and click `Save` to save changes to the current file. |
| 46 | +3. **Save As:** Go to the `File` menu and click `Save As` to save the content as a new file. |
| 47 | +4. **Change Font:** Go to the `Font` menu and click `Arial` to change the font of the text area to Arial. |
| 48 | + |
| 49 | +## Project Structure |
| 50 | + |
| 51 | +- `editor.py`: The main application script. |
| 52 | +- `icons/`: Directory containing icons used in the application. |
| 53 | +- `requirements.txt`: List of dependencies (currently empty as `tkinter` is included with Python). |
| 54 | + |
| 55 | +## Contribution |
| 56 | + |
| 57 | +I welcome contributions to improve this project! Here are some ways you can help: |
| 58 | + |
| 59 | +- **Feature Requests:** Suggest new features or improvements. |
| 60 | +- **Bug Reports:** Report any bugs you find. |
| 61 | +- **Code Improvements:** Refactor and optimize the code. |
| 62 | +- **Documentation:** Improve this README or add more documentation. |
| 63 | + |
| 64 | +To contribute: |
| 65 | + |
| 66 | +1. Fork the repository. |
| 67 | +2. Create a new branch for your feature/bugfix. |
| 68 | +3. Commit your changes and push them to your branch. |
| 69 | +4. Create a pull request with a description of your changes. |
| 70 | + |
| 71 | +## License |
| 72 | + |
| 73 | +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
| 74 | + |
| 75 | +## Acknowledgements |
| 76 | + |
| 77 | +This project uses the `tkinter` library for the graphical user interface. Special thanks to the contributors of this library. |
| 78 | + |
| 79 | +--- |
| 80 | + |
| 81 | +Thank you for using and contributing to PY File Editor! |
0 commit comments