update md

j2doll · j2doll · commit 88c9089a9345 · 2026-01-01T00:13:57.000+09:00
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -0,0 +1,87 @@
+cmake_minimum_required(VERSION 3.21)
+project(my_project CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+
+add_executable(hello
+    src/main.cpp
+)
+
+# Find the Boost Config generated by Conan CMakeDeps.
+find_package(Boost REQUIRED CONFIG)
+
+# The target name provided by the Conan/Boost package may vary depending on the environment.
+# The safest way is to try them in order as below.
+if(TARGET Boost::headers)
+    target_link_libraries(hello PRIVATE Boost::headers)
+elseif(TARGET Boost::boost)
+    target_link_libraries(hello PRIVATE Boost::boost)
+else()
+    message(FATAL_ERROR "Boost target not found. Expected Boost::headers or Boost::boost.")
+endif()
+
+target_link_libraries(hello PRIVATE Boost::system)
+
+if(WIN32)
+  target_link_libraries(hello PRIVATE ws2_32)
+endif()
+
+
+##################################
+# Build commands (msvc)
+##################################
+#
+# Build commands when using C:\Users\<user>\.conan2\profiles\msvc_release
+# rmdir /s /q build-msvc # Clear cache
+# conan install . -of build-msvc --build=missing -pr:h msvc_release -pr:b msvc_release
+# cmake -S . -B build-msvc -DCMAKE_TOOLCHAIN_FILE=build-msvc\conan_toolchain.cmake
+# cmake --build build-msvc --config Release
+#
+#
+# Example configuration for C:\Users\<user>\.conan2\profiles\msvc_release
+# [settings]
+# os=Windows
+# arch=x86_64
+# build_type=Release
+# compiler=msvc
+# compiler.version=194  # Check cl.exe version. Take the first two digits (19.40) and convert to integer → 194, VS 2019 (16.x) v142 : 192 , VS 2022 (17.0~17.4) v143 : 193 , VS 2022 (17.5~17.9) v143 : 194
+# compiler.runtime=dynamic
+# compiler.runtime_type=Release
+# compiler.cppstd=17
+# 
+##################################
+# Build commands (mingw)
+##################################
+# 
+# Build commands when using C:\Users\<user>\.conan2\profiles\mingw_gcc
+# rmdir /s /q build-mingw # Clear cache
+# conan install . -of build-mingw --build=missing   -pr:h mingw_gcc -pr:b mingw_gcc   -o boost/*:without_stacktrace=True -o boost/*:without_python=True -v debug
+#  Exclude boost modules that cause issues during build (stacktrace, etc.)
+# cmake -S . -B build-mingw -G Ninja -DCMAKE_TOOLCHAIN_FILE=build-mingw\conan_toolchain.cmake   -DCMAKE_BUILD_TYPE=Release
+# cmake --build build-mingw 
+# 
+#
+# Example configuration C:\Users\<user>\.conan2\profiles\mingw_gcc
+# [settings]
+# os=Windows
+# arch=x86_64
+# build_type=Release
+# compiler=gcc
+# compiler.version=13 # Check version with g++ --version
+# compiler.libcxx=libstdc++11
+# compiler.cppstd=17
+# 
+# [conf]
+# tools.cmake.cmaketoolchain:generator=Ninja
+# tools.build:compiler_executables={"c":"C:/Qt/Tools/mingw1310_64/bin/gcc.exe","cpp":"C:/Qt/Tools/mingw1310_64/bin/g++.exe"}
+#
+
+
+
+
+
+
+
+
diff --git a/README.ko.md b/README.ko.md
@@ -1,69 +1,79 @@
-# C++ 프로젝트용 .gitignore
-
-[English](README.md)
-
----
-
-이 `.gitignore` 파일은 다양한 IDE, 에디터, 빌드 시스템을 포괄하는 **C++ 프로젝트 전용 종합 무시 목록**입니다.
-
-## 포함된 환경
-
-- **IDE / 에디터**:
-  - Visual Studio 2019/2022
-  - Visual Studio Code (VSCode)
-  - CLion / JetBrains IDE
-  - Qt Creator
-  - Eclipse CDT
-  - Xcode
-  - Neovim / Vim
-  - Emacs
-  - Sublime Text
-  - Atom
-  - Code::Blocks
-  - CodeLite
-  - KDevelop
-  - NetBeans (C/C++)
-  - Geany
-  - Dev-C++
-  - JetBrains Fleet
-  - Kate
-
-- **빌드 시스템**:
-  - CMake
-  - Ninja
-  - Meson
-  - SCons
-
-- **패키지 관리자**:
-  - Conan
-  - vcpkg
-  - Hunter
-  - CPM.cmake
-
-- **언어 서버**:
-  - clangd
-  - ccls
-  - gtags / ctags
-
-## 목적
-
-이 `.gitignore`의 목적은 다음과 같습니다:
-- 빌드 과정에서 생성되는 임시 산출물을 저장소에서 제거
-- 로컬 IDE/에디터 설정 파일을 커밋하지 않도록 방지
-- 사용자/PC별로 달라지는 캐시 및 로그 파일 제외
-
-## 사용 방법
-
-C++ 프로젝트의 루트 디렉터리에 `.gitignore` 파일을 배치합니다:
-
-```bash
-curl -o .gitignore https://example.com/path/to/.gitignore
+# Conan CMake 샘플
+
+[English README](README.md)
+
+이 프로젝트는 Conan과 CMake를 사용하여 Boost 의존성을 가진 간단한 C++ 애플리케이션을 빌드하는 방법을 보여줍니다.
+
+## 프로젝트 구조
+
+- `src/main.cpp`: Boost.Asio를 사용하는 최소 예제
+- `CMakeLists.txt`: CMake 빌드 설정
+- `conanfile.txt`: Conan 패키지 요구사항 및 생성기 설정
+
+## 요구 사항
+
+- CMake >= 3.21
+- Conan >= 2.x
+- C++17을 지원하는 컴파일러 (예: MSVC, GCC, Clang)
+
+## 의존성
+
+- Boost 1.83.0 (Conan을 통해 설치)
+
+## 빌드 방법
+
+### 1. Conan으로 의존성 설치
+
+```sh
+conan install . -of build --build=missing
+```
+
+또는, 특정 프로필(MSVC 등) 사용 시:
+
+```sh
+conan install . -of build-msvc --build=missing -pr:h msvc_release -pr:b msvc_release
+```
+
+### 2. CMake로 프로젝트 설정
+
+```sh
+cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake
+```
+
+MSVC 프로필 사용 시:
+
+```sh
+cmake -S . -B build-msvc -DCMAKE_TOOLCHAIN_FILE=build-msvc/conan_toolchain.cmake
+```
+
+### 3. 빌드
+
+```sh
+cmake --build build --config Release
+```
+
+MSVC 프로필 사용 시:
+
+```sh
+cmake --build build-msvc --config Release
+```
+
+## 예제 실행 결과
+
+빌드된 실행 파일을 실행하면 다음과 같은 메시지가 출력됩니다:
+
+```
+Boost.Asio OK
 ```
 
-Git은 `.gitignore`에 명시된 패턴과 일치하는 파일/디렉터리를 자동으로 무시합니다.
+## 참고
 
-## 참고 사항
+- Boost를 header-only로 사용하여 빌드 시간/용량을 줄이고 싶다면, `conanfile.txt`에서 아래 옵션을 주석 해제하여 사용하세요:
+  ```
+  # boost/*:header_only=True
+  ```
+- CMake 설정은 환경에 따라 자동으로 올바른 Boost 타겟을 링크합니다.
 
-- `.gitignore`에 포함되어 있어도 특정 파일을 강제로 추가하려면 `git add -f <file>` 명령을 사용하세요.
-- `Makefile`을 직접 관리하는 경우, `.gitignore`의 `Makefile` 항목을 삭제하세요.
+## 라이선스
 
+이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참고하세요.
diff --git a/README.md b/README.md
@@ -1,70 +1,79 @@
-# C++ Project .gitignore
-
-
-[Korean](README.ko.md)
-
----
-
-This `.gitignore` file is a **comprehensive ignore list** for C++ projects, covering a wide range of IDEs, editors, and build systems.
-
-## Included Environments
-
-- **IDEs / Editors**:
-  - Visual Studio 2019/2022
-  - Visual Studio Code (VSCode)
-  - CLion / JetBrains IDEs
-  - Qt Creator
-  - Eclipse CDT
-  - Xcode
-  - Neovim / Vim
-  - Emacs
-  - Sublime Text
-  - Atom
-  - Code::Blocks
-  - CodeLite
-  - KDevelop
-  - NetBeans (C/C++)
-  - Geany
-  - Dev-C++
-  - JetBrains Fleet
-  - Kate
-
-- **Build systems**:
-  - CMake
-  - Ninja
-  - Meson
-  - SCons
-
-- **Package managers**:
-  - Conan
-  - vcpkg
-  - Hunter
-  - CPM.cmake
-
-- **Language servers**:
-  - clangd
-  - ccls
-  - gtags / ctags
-
-## Purpose
-
-This `.gitignore` aims to:
-- Keep repositories clean from temporary build outputs.
-- Avoid committing local IDE/editor configuration files.
-- Exclude cache and log files that are machine/user-specific.
-
-## Usage
-
-Place the `.gitignore` file in the root of your C++ project:
-
-```bash
-curl -o .gitignore https://example.com/path/to/.gitignore
+# Conan CMake Sample
+
+[Korean README](README.ko.md)
+
+This project demonstrates how to use Conan and CMake to build a simple C++ application with Boost dependencies.
+
+## Project Structure
+
+- `src/main.cpp`: Minimal example using Boost.Asio.
+- `CMakeLists.txt`: CMake build configuration.
+- `conanfile.txt`: Conan package requirements and generator settings.
+
+## Requirements
+
+- CMake >= 3.21
+- Conan >= 2.x
+- A C++17 compatible compiler (e.g., MSVC, GCC, Clang)
+
+## Dependencies
+
+- Boost 1.83.0 (via Conan)
+
+## Building the Project
+
+### 1. Install Dependencies with Conan
+
+```sh
+conan install . -of build --build=missing
+```
+
+Or, for a specific profile (e.g., MSVC):
+
+```sh
+conan install . -of build-msvc --build=missing -pr:h msvc_release -pr:b msvc_release
 ```
 
-Git will automatically ignore files and directories matching the patterns.
+### 2. Configure the Project with CMake
+
+```sh
+cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake
+```
+
+Or for MSVC profile:
+
+```sh
+cmake -S . -B build-msvc -DCMAKE_TOOLCHAIN_FILE=build-msvc/conan_toolchain.cmake
+```
+
+### 3. Build
+
+```sh
+cmake --build build --config Release
+```
+
+Or for MSVC profile:
+
+```sh
+cmake --build build-msvc --config Release
+```
+
+## Example Output
+
+When you run the resulting executable, you should see:
+
+```
+Boost.Asio OK
+```
 
 ## Notes
 
-- If you need to track some files listed in `.gitignore`, use `git add -f <file>` to force-add them.
-- If you are manually managing `Makefile`, remove the `Makefile` entry in this `.gitignore`.
+- To use Boost as header-only (to reduce build time/size), uncomment and use the following option in `conanfile.txt`:
+  ```
+  # boost/*:header_only=True
+  ```
+- The CMake configuration automatically links the correct Boost target depending on your environment.
+
+## License
 
+This project is licensed under the MIT License. See the LICENSE file for details.
diff --git a/conanfile.txt b/conanfile.txt
@@ -0,0 +1,11 @@
+[requires]
+boost/1.83.0
+
+[generators]
+CMakeDeps
+CMakeToolchain
+
+# [options]
+# If needed, e.g., if you want to use boost as header-only (to reduce build time/size)
+# boost/*:header_only=True
+
diff --git a/src/main.cpp b/src/main.cpp
@@ -0,0 +1,9 @@
+#include <boost/asio.hpp>
+#include <iostream>
+
+int main()
+{
+    boost::asio::io_context io;
+    std::cout << "Boost.Asio OK\n";
+    return 0;
+}
