과목 이수체계도를 그려주는 프로그램을 오픈소스SW개발 수강생 모두가 함께 참여하며 개발하는 프로젝트입니다.
onboarding 디렉토리의 문서들을 참고해 주세요
- Codespace를 실행한 뒤 터미널에 './install_fonts.sh' 실행
- 실행 완료 후 실행했던 Codespace의 중지 후 재부팅 <== 이거는 안해도 되는데 혹시 안될때 해보라는 겁니다.
- 중지하려는 Codespace의 오른쪽에 있는 줄임표(...)를 클릭
- Codespace 중지를 클릭
- Codespace를 다시 재시작
- Codespace 실행 후 정상적으로 작동하는지 확인 'python coursegraph data/input.yaml -o out.png' 명령어 실행
- https://jstar0525.tistory.com/264 이 사이트에 들어가서 make 명령어를 설치하라는 대로 설치한다(설치할 때 주소를 복사해놓기).
- 윈도우 검색에서 시스템 환경 변수 설정에 들어가 환경변수의 path에 설치할 때 주소를 저장한다.
- cmd 창에서 'make-v' 명령어를 수행한다.
수행 명령어 = make test (윈도우 버전)삭제 명령어 = make clean_w (Mac, Linux버전)삭제 명령어 = make clean_m
다음과 같이 coursegraph/__main__.py를 파이썬으로 실행시켜 활용한다.
oss2024hnu/coursegraph-py$ python coursegraph --help
usage: coursegraph [-h] [-o OUTPUT] [-f {graph,table}] [-s SIZE] input
A CLI utility for processing data.
positional arguments:
input Specify the input YAML data file path. (required)
options:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Specify the output image file path. (optional).
-f {graph,dot,table}, --format {graph,dot,table}
Specify the output format (graph, table). Defaults to graph.
-s SIZE, --size SIZE Specify the size of the output image in format WIDTH,HEIGHT. Example: -s 20,10
-v {0,1,2}, --verbose {0,1,2}
Set the verbose level (optional) 0 - Minium output, option for end user 1 - Standard output, informational message 2 - Debug output,
detailed information
Enjoy using the CLI utility!
-o혹은--output옵션에는 생성할 이미지 파일의 이름을 제공하여 이미지를 생성하도록 할 수 있는데, 제공하지 않는 경우 팝업 다이얼로그 창으로 이미지를 띄워서 보여주려고 할 것임 (다만 그래픽을 지원하지 않는 환경에서는 작동하지 않음).-f graph혹은--format graph옵션을 제공하면 이수체계도를 방향그래프 형태로 보여줌.-f혹은--foramt옵션을 제공하지 않은 경우도 graph 모드로 동작.-f table혹은--format table옵션을 주었을 경우, yaml 파일의 전체 내용을 한꺼번에 보기 좋은 표의 형태로 보여준다.-f dot혹은--format dot옵션을 주었을 경우, yaml 파일의 내용을 .dot 형태로 보여준다.- '-s WIDTH,HEIGHT' 혹은 '--size WIDTH,HEIGHT' 옵션을 제공했을 경우 이미지의 크기를 가로,세로의 입력값으로 지정해준다.
'-s' 혹은 '--size' 옵션을 제공하지 않은 경우에는 이미지의 크기는 10,20 으로 지정된다.
-v {0,1,2}혹은--verbose {0,1,2}옵션을 제공했을 경우 출력되는 정보의 상세 수준을 지정한다. 0은 최소한의 출력, 1은 요약 정보, 2는 상세 디버그 정보를 출력한다. '-v' 혹은 '--verbose' 옵션을 제공하지 않는 경우에는 최소한의 출력으로 보여준다.
python coursegraph data/input.yaml -f dot -o out.dot
출력된 .dot 파일 또는 .svg 파일을 http://magjac.com/graphviz-visual-editor/ 해당 사이트와 같은 graphviz 시각화 사이트에 입력
- using graphviz software (권장하지 않음) 해당사이트 참조 본인 운영체제에 알맞은 방식으로 graphviz 설치 https://www.graphviz.org/download/
% dot -Tpng [dot 파일 이름].dot > [출력할 파일 이미지의 이름].png
coursegraph-py/coursegraph로 이동한 다음 'python gui.py'를 터미널에 넣고 실행하면 gui화면이 나온다. 현재 사용가능한 기능은 파일 열기, 다른이름으로 저장하기, 연 이미지를 초기화 시키는 기능이 있다. 파일 열기와 다른 이름으로 저장하기는 오른쪽위에 있는 파일을 클릭하면 기능을 사용할 수 있다. 이미지를 초기화하는 기능은 아래에 이미지 초기화 버튼이 있는데 클릭하면 이미지가 초기화됩니다. gui파일에 대해서 사람들의 생각이 다르기 때문에 어떤 기능이나 내용을 추가할지 온보딩에 그림을 이용해서 의견을 공유하면 어떤 내용이 필요한지 보기 편할 것 같습니다.
PyQt5 desiner 사용법
-
Windows (터미널)
-
pip install pyqt5
-
pip install pyqt5-tools
-
이후 본인 python 설치 폴더 내부 \Lib\site-packages\qt5_applications\Qt\bin 내부에 있는 designer 실행
-
MacOS (터미널 OR VScode)
-
pip install pyqt
-
pip install pyqt5-tools
-
이후 본인 python 설치 폴더 내부 \Lib\site-packages\qt5_applications\Qt\bin 내부에 있는 designer 실행
-
데비안 계열(우분투 등) Linux (터미널)
-
pip3 install pyqt5(시스템에 따라서는 pip3가 아니라 pip로 실행해도 되는 경우도 있음) -
sudo apt install python3-pyqt5 -
sudo apt install pyqt5-dev-tools -
sudo apt install qttools5-dev-tools -
이후 터미널에서
designer로 실행
PyQt5 desiner 주의사항
- PyQt5는 파이썬 3.9까지만 지원가능함.
- 파이썬 3.10 이상버전에서는 https://www.riverbankcomputing.com/software/pyqt/download 해당경로에서 다운로드 받아서 직접 경로에 넣거나 3.9로 다운그레이드 요망
- 매우 복잡한 UI는 Designer에서 관리하기 어렵습니다. 이 경우 UI를 여러 개의 작은 .ui 파일로 나누어 관리하거나, Python 코드에서 UI를 동적으로 생성하는 것이 좋습니다.
- Qt Designer에서는 디자인 미리보기를 제공하지만, 실제 실행 시와 다를 수 있으므로 항상 변환된 Python 코드로 실행해보는 것이 좋습니다.
- Designer에서 설정한 이미지나 리소스의 경로는 정적 경로로 설정됩니다. 경로가 상대 경로로 설정되어야 배포 시 문제가 발생하지 않습니다.
- pr과 이슈를 연결하는 법 github docs 링크: https://docs.github.com/ko/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue