Skip to content

Commit c69285e

Browse files
committed
Update the documentations
1 parent c5a4a85 commit c69285e

File tree

2 files changed

+109
-27
lines changed

2 files changed

+109
-27
lines changed

INSTALL.md

+96
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
Building GCodeWorkShop
2+
======================
3+
4+
GCodeWorkShop is written in C++ using the Qt5 framework. In general,
5+
the following steps are needed to build it:
6+
7+
- Install the C++11 compiler supported by [Qt SDK][1]. You should also
8+
install the make utility.
9+
- Install Qt utilities such as qmake, moc, lrelease and the resource packer.
10+
- Install the Qt5 framework with version 5.6 or higher.
11+
- Obtain and unzip the GCodeWorkShop source code.
12+
- Create a build folder and navigate to it.
13+
- Run qmake specifying the path to GCodeWorkShop sources.
14+
- Run make to build the application.
15+
16+
17+
Building in Debian
18+
------------------
19+
20+
Install the following packages.
21+
22+
```
23+
apt update
24+
apt install build-essential qtbase5-dev qttools5-dev-tools libqt5serialport5-dev
25+
```
26+
27+
Switch to the folder with sources. Now you can either build the application
28+
step by step or use the script to automatically build the application and
29+
create an installation package.
30+
31+
32+
### Step-by-step build
33+
34+
```sh
35+
mkdir -p build
36+
cd build
37+
qmake -r ..
38+
make lrelease -j $(nproc)
39+
qmake -r ..
40+
make -j $(nproc)
41+
```
42+
43+
44+
### Automatically build and create an package
45+
46+
Run script:
47+
48+
```sh
49+
install/deb-build.sh
50+
```
51+
52+
The script creates a .deb package in the current folder and does not require
53+
root privileges.
54+
55+
56+
Building in windows with MSYS2
57+
------------------------------
58+
59+
Install the following packages.
60+
61+
```sh
62+
pacman -Syu
63+
pacman -S make mingw-w64-x86_64-gcc mingw-w64-x86_64-nsis \
64+
mingw-w64-x86_64-qt5-tools mingw-w64-x86_64-qt5-translations \
65+
mingw-w64-x86_64-qt5-base mingw-w64-x86_64-qt5-serialport
66+
```
67+
68+
Switch to the folder with sources. Now you can either build the application
69+
step by step or use the script to automatically build the application and
70+
create an installer.
71+
72+
73+
### Step-by-step build
74+
75+
```sh
76+
mkdir -p build
77+
cd build
78+
qmake -r ..
79+
make lrelease -j $(nproc)
80+
qmake -r ..
81+
make -j $(nproc)
82+
```
83+
84+
85+
### Automatically build and create an installer
86+
87+
Run script:
88+
89+
```sh
90+
install/win-msys2-build.sh
91+
```
92+
93+
The script creates a .exe installer in the current folder.
94+
95+
96+
[1]: https://doc.qt.io/qt-5/supported-platforms.html "Qt5 doc: supported platforms"

README.md

+13-27
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ GCodeWorkShop
44
This is a fork of [EdytorNC](https://github.com/artur3/EdytorNC), a text editor
55
for CNC programmers.
66

7+
- [Some features](#some-features)
8+
- [Some shotcuts](#some-shotcuts)
9+
- [Getting GCodeWorkShop](#getting-gcodeworkshop)
10+
- [Command line options](#command-line-options)
11+
712

813
Some features
914
------------
@@ -49,35 +54,16 @@ Some shotcuts
4954
`SQRT(x)` `SQR(x)` `ABS(x)` `TRUNC(x)` `PI`
5055

5156

57+
Getting GCodeWorkShop
58+
---------------------
59+
60+
On the [release page](https://github.com/GCodeProjects/GCodeWorkShop/releases/latest)
61+
you can find binary builds for Debian, Ubuntu and Windows. For building the
62+
application yourself, the [build instructions](INSTALL.md) may be useful.
63+
64+
5265
Command line options
5366
------------------
5467

5568
- open file -> `gcodeworkshop file.nc`
5669
- diff two files -> `gcodeworkshop -diff file1.nc file2.nc`
57-
58-
59-
Compile GCodeWorkShop
60-
-------------------
61-
62-
63-
### Ubuntu
64-
65-
run terminal
66-
```
67-
sudo apt install qt5-default qtbase5-dev-tools qt5-qmake
68-
cd ~
69-
git clone https://github.com/GCodeProjects/GCodeWorkShop
70-
cd GCodeWorkShop
71-
qmake -r [CONFIG+=debug] [PREFIX=/usr/ | PREFIX=~/.local/bin/]
72-
make
73-
make lrelease
74-
```
75-
76-
77-
### Windows
78-
79-
- [Install Qt5](http://www.qt.io/download-open-source)
80-
- download latest version of GCodeWorkShop [source files](https://github.com/GCodeProjects/GCodeWorkShop/archive/master.zip)
81-
- unzip downloaded file
82-
- open gcodeworkshop.pro in Qt Creator
83-
- press Ctrl+R

0 commit comments

Comments
 (0)