mirror of
https://github.com/saitohirga/WSJT-X.git
synced 2024-11-05 08:51:19 -05:00
Fix contribute link, some more info
This commit is contained in:
parent
369e479f48
commit
47f244a8fd
@ -6,7 +6,7 @@ This file describes a path to contribute to this project.
|
|||||||
|
|
||||||
If you have encountered a problem with QDarkStyle or have an idea for a new
|
If you have encountered a problem with QDarkStyle or have an idea for a new
|
||||||
feature, please submit it to the
|
feature, please submit it to the
|
||||||
[issue tracker](https://github.com/ColinDuquesnoy/QDarkStyleSheet/issues)
|
[issue tracker](https://github.com/ColinDuquesnoy/QDarkStyleSheet/issues).
|
||||||
|
|
||||||
## Contributing to QDarkStyle
|
## Contributing to QDarkStyle
|
||||||
|
|
||||||
@ -119,11 +119,11 @@ These are the basic steps needed to start developing on QDarkStyle.
|
|||||||
Inside modules we provided a logging that should be used to inform the user.
|
Inside modules we provided a logging that should be used to inform the user.
|
||||||
Please, follow the levels bellow.
|
Please, follow the levels bellow.
|
||||||
|
|
||||||
- debug: for debug information, high detailed one, directed to programers
|
- debug: for debug information, high detailed one, directed to programers;
|
||||||
- info: something important for common user to know
|
- info: something important for common user to know;
|
||||||
- warning: something that should not be a big problem or a desicision changed
|
- warning: something that should not be a big problem or a desicision changed;
|
||||||
- error: some error, but not capable of stop program
|
- error: some error, but not capable of stop program;
|
||||||
- critical: something that stops the running program
|
- critical: something that stops the running program.
|
||||||
|
|
||||||
## Guide to QDarkStyle
|
## Guide to QDarkStyle
|
||||||
|
|
||||||
@ -133,15 +133,15 @@ widget provided by Qt - common ones. Feel free to add more to them.
|
|||||||
To simplify the structure, there are separated files in
|
To simplify the structure, there are separated files in
|
||||||
[example.ui](.example/ui/) folder.
|
[example.ui](.example/ui/) folder.
|
||||||
|
|
||||||
- `dw_buttons.ui`: all types of buttons
|
- `dw_buttons.ui`: all types of buttons;
|
||||||
- `dw_containers_no_tabs.ui`: all types of containers except for tabs
|
- `dw_containers_no_tabs.ui`: all types of containers except for tabs;
|
||||||
- `dw_containers_tabs.ui`: all containers tabs
|
- `dw_containers_tabs.ui`: all containers tabs;
|
||||||
- `dw_displays.ui`: all types of displays
|
- `dw_displays.ui`: all types of displays;
|
||||||
- `dw_inputs_fields.ui`: all types of inputs with fields
|
- `dw_inputs_fields.ui`: all types of inputs with fields;
|
||||||
- `dw_inputs_no_fields.ui`: all types of inputs without fields
|
- `dw_inputs_no_fields.ui`: all types of inputs without fields;
|
||||||
- `dw_views.ui`: all types of views
|
- `dw_views.ui`: all types of views;
|
||||||
- `dw_widgets.ui`: all types of widgets
|
- `dw_widgets.ui`: all types of widgets;
|
||||||
- `mw_menus.ui`: main window with all menus and toolbars
|
- `mw_menus.ui`: main window with all menus and toolbars.
|
||||||
|
|
||||||
*Obs.: `dw` stands for dock widget and `mw` for main window.*
|
*Obs.: `dw` stands for dock widget and `mw` for main window.*
|
||||||
|
|
||||||
@ -151,7 +151,7 @@ see its documentation.
|
|||||||
|
|
||||||
### Modifying UI Files
|
### Modifying UI Files
|
||||||
|
|
||||||
Feel free to modify `.ui` files with Qt Designer and recompile UI using
|
Feel free to modify [ui](./example/ui) files with Qt Designer and recompile UI using
|
||||||
[process_ui.py](./script/process_ui.py) script, inside script folder, using:
|
[process_ui.py](./script/process_ui.py) script, inside script folder, using:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -162,7 +162,7 @@ It will generate all `_ui.py` files for PyQt4, PyQt5, PySide, QtPy, PyQtGraph.
|
|||||||
|
|
||||||
### Modifying QSS File
|
### Modifying QSS File
|
||||||
|
|
||||||
If you are changing the [stylesheet](.qdarkstyle/style.qss) , you will need
|
If you are changing the [stylesheet](.qdarkstyle/style.qss), you will need
|
||||||
to recompile the QRC files using [process_qrc.py](./script/process_qrc.py)
|
to recompile the QRC files using [process_qrc.py](./script/process_qrc.py)
|
||||||
script, inside script folder.
|
script, inside script folder.
|
||||||
|
|
||||||
@ -182,7 +182,7 @@ python run_ui_css_edition.py
|
|||||||
```
|
```
|
||||||
|
|
||||||
This creates a loop that restarts the application, process ui and css
|
This creates a loop that restarts the application, process ui and css
|
||||||
files.
|
files.
|
||||||
|
|
||||||
For more information about those scripts, see their documentation.
|
For more information about those scripts, see their documentation.
|
||||||
|
|
||||||
@ -201,20 +201,23 @@ Create good palettes with these tools. For example, on paletton, choose
|
|||||||
bit of the main color, so it is nice to change it if you change the main
|
bit of the main color, so it is nice to change it if you change the main
|
||||||
color.
|
color.
|
||||||
|
|
||||||
- [Paletton](http://paletton.com/)
|
- [Paletton.com](http://paletton.com/)
|
||||||
- [Coolors.co](https://coolors.co/)
|
- [Coolors.co](https://coolors.co/)
|
||||||
|
|
||||||
## Unit Testing and Fix Preview
|
## Unit Testing and Fix Preview
|
||||||
|
|
||||||
It is a good practice, if you are writing functions to QDarkStyle or fixing
|
It is a good practice, if you are writing functions to QDarkStyle or fixing
|
||||||
something related to those functions (not style), that you provide a test
|
something related to those functions (not style), that you provide a test
|
||||||
for it. This will keep our implementation stable.
|
for it.
|
||||||
|
|
||||||
If you are fixing something about style, please, provide an screenshot
|
If you are fixing something about style, please, at least, provide an
|
||||||
before and after the fix to comparison. This could be inserted in the issue
|
screenshot before and after the fix to comparison. This could be inserted
|
||||||
tracker, as a message.
|
in the issue tracker, as a message. Better than that, use modules provided
|
||||||
|
in test folder to create a GUI test, creating a new file for it.
|
||||||
|
|
||||||
|
Check [test](./test) files to more details. Tests will keep our application stable.
|
||||||
|
|
||||||
## If You Are a Mantainer, Go Ahead
|
## If You Are a Mantainer, Go Ahead
|
||||||
|
|
||||||
We create a guide to create and upload this package to PyPI, follow the
|
We create a guide to create and upload this package to PyPI, follow the
|
||||||
instructions in [PRODUCTION](.PRODUCTION.md).
|
instructions in [PRODUCTION](./PRODUCTION.md).
|
Loading…
Reference in New Issue
Block a user