diff --git a/HowToSetProject.ko.md b/HowToSetProject.ko.md new file mode 100644 index 0000000..bc4f3b9 --- /dev/null +++ b/HowToSetProject.ko.md @@ -0,0 +1,132 @@ + +## QXlsx 프로젝트 설정하는 방법 + +> *Read this in other languages: [English](HowToSetProject.md), :kr: [한국어](HowToSetProject.ko.md)* + +- QXlsx를 적용하는 쉬운 방법은 다음과 같습니다. +- Windows에 적용하는 방법을 설명합니다. +- Linux 또는 Mac에 적용하는 방법도 비슷하므로 추가 요청이 있으면 도움을 요청할 것입니다. + +## 설정 단계 + +:one: github에서 소스 코드를 clone 합니다 + +```sh +git clone https://github.com/j2doll/QXlsx.git +``` + +![](markdown.data/01.jpg) + +

+ +:two: QtCreator를 실행합니다 + +![](markdown.data/02.jpg) + +* QtCreator의 사용방법을 모르시면, Qt Company 싸이트를 참조하세요. [https://www.qt.io/qt-features-libraries-apis-tools-and-ide/](https://www.qt.io/qt-features-libraries-apis-tools-and-ide/) + +

+ +:three: 여러분의 Qt 프로젝트를 생성하세요 + +![](markdown.data/03.jpg) + +

+ +:four: 예제는 콘솔 어플리케이션입니다 + +![](markdown.data/04.jpg) + +

+ +:five: 프로젝트 이름을 정하세요. 현재 프로젝트 이름은 HelloQXlsx 입니다. + +![](markdown.data/05.jpg) + +

+ +:six: HelloQXlsx 프로젝트가 생성되었습니다 + +![](markdown.data/06.jpg) + +

+ +:seven: 현재 경로 + +![](markdown.data/07.jpg) + +

+ +:eight: QXlsx 코드를 여러분의 Qt 프로젝트에 복사하세요. (윈도우즈 탐색기로 복사하셔도 됩니다) + +![](markdown.data/08.jpg) + +```cmd +xcopy c:\workspace\github\QXlsx\QXlsx c:\workspace\HelloQXlsx /s /e +``` + +

+ +:nine: 현재 디렉토리 및 파일들 + +![](markdown.data/09.jpg) + +

+ +:keycap_ten: 여러분의 Qt 프로젝트(*.pro)에 QXlsx 코드를 추가하세요 + +![](markdown.data/10.jpg) + +```qmake +# QXlsx code for Application Qt project +QXLSX_PARENTPATH=./ # current QXlsx path is . (. means curret directory) +QXLSX_HEADERPATH=./header/ # current QXlsx header path is ./header/ +QXLSX_SOURCEPATH=./source/ # current QXlsx source path is ./source/ +include(./QXlsx.pri) +``` + +

+ +:one::one: 헤더 파일과 네임스페이스를 설정하세요. 그리고 예제를 위한 코드를 추가하세요 + +![](markdown.data/11.jpg) + +```cpp +// main.cpp + +#include + +#include "xlsxdocument.h" +#include "xlsxchartsheet.h" +#include "xlsxcellrange.h" +#include "xlsxchart.h" +#include "xlsxrichstring.h" +#include "xlsxworkbook.h" +using namespace QXlsx; + +int main(int argc, char *argv[]) +{ + QCoreApplication a(argc, argv); + + QXlsx::Document xlsx; + xlsx.write("A1", "Hello Qt!"); // write "Hello Qt!" to cell(A,1). it's shared string. + xlsx.saveAs("Test.xlsx"); // save the document as 'Test.xlsx' + + return 0; + // return a.exec(); +} +``` + +

+ +:one::two: 프로젝트를 빌드하고 실행하세요 + +![](markdown.data/12.jpg) + +

+ +:one::three: 실행 파일(*.exe)과 엑셀 파일(*.xlsx) 파일이 생성되었습니다 + +![](markdown.data/13.jpg) + +

diff --git a/HowToSetProject.md b/HowToSetProject.md index 22486a0..1ffe61a 100644 --- a/HowToSetProject.md +++ b/HowToSetProject.md @@ -1,6 +1,8 @@ ## How to setup QXlsx project +> *Read this in other languages: [English](HowToSetProject.md), :kr: [한국어](HowToSetProject.ko.md)* + - Here's an easy way to apply QXlsx. - Describes when to apply to Windows. - The method of applying it on Linux or Mac is similar, and I will write help if there is an additional request. @@ -72,7 +74,7 @@ xcopy c:\workspace\github\QXlsx\QXlsx c:\workspace\HelloQXlsx /s /e

-10. Append code for QXlxs library on your Qt project(*.pro) +:keycap_ten: Append code for QXlxs library on your Qt project(*.pro) ![](markdown.data/10.jpg) @@ -86,7 +88,7 @@ include(./QXlsx.pri)

-11. Set heaer files and namespace for sample. Then append hello world code. +:one::one: Set heaer files and namespace for sample. Then append hello world code. ![](markdown.data/11.jpg) @@ -118,13 +120,13 @@ int main(int argc, char *argv[])

-12. Build and Run a project +:one::two: Build and Run a project ![](markdown.data/12.jpg)

-13. Execute file and Excel file(xlsx) is created. +:one::three: A execute file(*.exe) and a excel file(xlsx) is created. ![](markdown.data/13.jpg) diff --git a/README.ko.md b/README.ko.md index 6d1b1f8..f447c61 100644 --- a/README.ko.md +++ b/README.ko.md @@ -44,42 +44,8 @@ else qDebug() << row << " " << var; ``` -## 빌드하는 방법 -* :one: Qt 5 설치. [Qt Company](https://www.qt.io) (2017-) -* :two: github 소스 코드 클론 -```sh - git clone https://github.com/j2doll/QXlsx.git -``` -* :three: QXlsx 프로젝트 빌드 -```sh - cd QXlsx - qmake QXlsx.pro - make debug (you may use 'make release'.) -``` -* :four: TestExcel 빌드 -```sh - cd TestExcel - qmake TestExcel.pro - make -``` -* :five: TestExcel 실행 -```sh - ./TestExcel -``` -* :pushpin: 자신만의 Qt 프로젝트를 위한 QXlsx.pri 를 include 하고 QXlsx 경로값을 설정하세요. -```qmake -# default relative path (you may not set this value. then default value will be used.) -QXLSX_PARENTPATH=./ -QXLSX_HEADERPATH=./header/ -QXLSX_SOURCEPATH=./source/ - -# abs. directory sample -# QXLSX_PARENTPATH=/hello/world/ -# QXLSX_HEADERPATH=/hello/world/header/ -# QXLSX_SOURCEPATH=/hello/world/source/ - -include(../QXlsx/QXlsx.pri) -``` +## 설정하는 방법 +* [QXlsx 프로젝트 설정하는 방법](HowToSetProject.ko.md)을 참조하세요. ## 테스트 환경 테스트된 환경은 다음과 같습니다. diff --git a/README.md b/README.md index 7188dcc..38eb66c 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ else qDebug() << row << " " << var; ``` -## How to build +## How to set up * See [How to setup QXlsx project](HowToSetProject.md) ## Test environment