Add content for 'C++ and Lua' article

Author: MartinHelmut

.gitignore

@@ -4,4 +4,6 @@
 /lua
 /*.rock
 /*.sublime-workspace
+
+build
 profile.json

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "src/cpp/cmake_git_submodule/lua"]
+	path = src/cpp/cmake_git_submodule/lua
+	url = https://github.com/lua/lua.git

src/cpp/README.md

@@ -0,0 +1,30 @@
+# Lua with C++
+
+This folder contains a set of examples from my article [C++ and Lua](https://martin-fieber.de/blog/cpp-and-lua) as part of the [Lua series](https://martin-fieber.de/series/lua).
+
+## Examples
+
+| Folder                     | Contents                                            |
+| -------------------------- | --------------------------------------------------- |
+| `cmake_find_package/`      | Include Lua in a project via CMake `find_package`   |
+| `cmake_external_project/`  | Include Lua in a project via CMake external project |
+| `cmake_git_submodule/`     | Include Lua in a project via Git submodule          |
+| `example-read-config/`     | All about reading data from Lua                     |
+| `example-functions/`       | Calling Lua functions from C++                      |
+| `example-cpp-to-lua/`      | Calling a C++ from Lua                              |
+| `example-custom-module`    | Define a custom Lua module from C++                 |
+| `example-override-builtin` | Override built-in Lua functions                     |
+
+## Setup
+
+Every example is set up the same, using CMake to build. Setting any example folder as current working directory, run the following command to create the CMake build configuration.
+
+```shell
+cmake -B build
+```
+
+The next command will build the executable into the folder `build`.
+
+```shell
+cmake --build build
+```

src/cpp/cmake_external_project/CMakeLists.txt

@@ -0,0 +1,34 @@
+cmake_minimum_required(VERSION 3.18)
+
+# Setup a CMake project for C++
+project(
+  LuaWithCMakeExternalProject
+  VERSION 1.0
+  LANGUAGES CXX)
+
+# Add an executable based on one source file
+add_executable(ProgramName main.cpp)
+
+# Include the fetch content module
+include(FetchContent)
+
+# Fetch Lua from git mirror
+FetchContent_Declare(
+  lua
+  GIT_REPOSITORY "https://github.com/lua/lua.git"
+  GIT_TAG v5.5.0
+)
+
+# Make content available
+FetchContent_MakeAvailable(lua)
+
+# Setup Lua library target with include directories
+add_library(Lua::Lua INTERFACE IMPORTED)
+target_include_directories(
+  Lua::Lua
+  INTERFACE "${lua_SOURCE_DIR}")
+
+# Link Lua library to the executable
+target_link_libraries(
+  ProgramName
+  PRIVATE Lua::Lua)

src/cpp/cmake_external_project/README.md

@@ -0,0 +1,17 @@
+# Lua, CMake, FetchContent
+
+Using Lua with CMake and the `FetchContent` module. Lua will be fetched from source.
+
+## Setup
+
+With the folder containing this file as current working directory, run the following command to create the CMake build configuration.
+
+```shell
+cmake -B build
+```
+
+The next command will build the executable into the folder `build`.
+
+```shell
+cmake --build build
+```

src/cpp/cmake_external_project/main.cpp

@@ -0,0 +1,7 @@
+#include <lua.hpp>
+
+int main() {
+  // More to come ...
+
+  return 0;
+}

src/cpp/cmake_find_package/CMakeLists.txt

@@ -0,0 +1,29 @@
+cmake_minimum_required(VERSION 3.18)
+
+# Setup a CMake project for C++
+project(
+  LuaWithCMakeFindPackage
+  VERSION 1.0
+  LANGUAGES CXX)
+
+# Add an executable based on one source file
+add_executable(ProgramName main.cpp)
+
+# Try to find the Lua package on the system
+find_package(Lua)
+
+# If Lua was found and target is not set up
+if(Lua_FOUND AND NOT TARGET Lua::Lua)
+  # Setup Lua library target
+  add_library(Lua::Lua INTERFACE IMPORTED)
+
+  # Set include directories
+  target_include_directories(
+    Lua::Lua
+    INTERFACE "${LUA_INCLUDE_DIR}")
+endif()
+
+# Link Lua library to the executable
+target_link_libraries(
+  ProgramName
+  PRIVATE Lua::Lua)

src/cpp/cmake_find_package/README.md

@@ -0,0 +1,17 @@
+# Lua, CMake, find_package
+
+Using Lua with CMake and find_package. This requires Lua to already be installed/available on the system.
+
+## Setup
+
+With the folder containing this file as current working directory, run the following command to create the CMake build configuration.
+
+```shell
+cmake -B build
+```
+
+The next command will build the executable into the folder `build`.
+
+```shell
+cmake --build build
+```

src/cpp/cmake_find_package/main.cpp

@@ -0,0 +1,7 @@
+#include <lua.hpp>
+
+int main() {
+  // More to come ...
+
+  return 0;
+}

src/cpp/cmake_git_submodule/CMakeLists.txt

@@ -0,0 +1,21 @@
+cmake_minimum_required(VERSION 3.18)
+
+# Setup a CMake project for C++
+project(
+  LuaWithGitSubmodules
+  VERSION 1.0
+  LANGUAGES CXX)
+
+# Add an executable based on one source file
+add_executable(ProgramName main.cpp)
+
+# Setup Lua library target with include directories
+add_library(Lua::Lua INTERFACE IMPORTED)
+target_include_directories(
+  Lua::Lua
+  INTERFACE "lua")
+
+# Link Lua library to the executable
+target_link_libraries(
+  ProgramName
+  PRIVATE Lua::Lua)