Rewrote README, added build instruction, remove info that is on website

Dieser Commit ist enthalten in:
Reinder Feenstra 2021-05-25 23:03:43 +02:00 committet von GitHub
Ursprung f7b087a562
Commit 4663b4cf1c
Es konnte kein GPG-Schlüssel zu dieser Signatur gefunden werden
GPG-Schlüssel-ID: 4AEE18F83AFDEB23

Datei anzeigen

@ -1,34 +1,66 @@
# Traintastic
# Traintastic - Model railway control software
[![Build](https://github.com/traintastic/traintastic/actions/workflows/build.yml/badge.svg)](https://github.com/traintastic/traintastic/actions/workflows/build.yml) ![GitHub](https://img.shields.io/github/license/traintastic/traintastic)
*Free and open source model railway control software*
## What is Traintastic?
## About The Project
Traintastic is a client/server software application to control a model railway. It is in an early stage of development, it contains very limited functionality.
## Goal?
Develop free and open source software which can control all aspects of a model railway.
- Cross platorm: Windows, Linux and macOS
- Multilingual software and user manual
- Easy to learn for new users
- Manual and automatic train operation
- Extensable by experienced users using scripting
The project goal is to develop open source software that can control everything in your model railway layout. More information can be found using the links below:
## What can it currently do?
- Control locomotive decoders, via LocoNet, XpressNet or Z21.
- Act as WLANmaus controller, so the WLANmaus/Z21 app can be used with any command station.
- [Download Traintastic](https://traintastic.org/download)
- [Traintastic Manual](https://traintastic.org/manual)
- [Traintastic hardware support](https://traintastic.org/supported-hardware)
- [Traintastic development roadmap](https://traintastic.org/roadmap)
### Supported command stations
- LocoNet:
- Digikeijs DR5000
- Uhlenbrock Intellibox
- other LocoNet compatible command stations should work
- XpressNet:
- Digikeijs DR5000 (untested)
- Roco 10764
- other XpressNet compatible command stations should work
- Z21:
- Digikeijs DR5000
- Roco/Fleischmann Z21 (untested)
- other Z21 compatible command stations should work
## Build Traintastic from source
*This section is only for developers, if your just want to use it [download Traintastic](https://traintastic.org/download).*
### Requirements:
- Client:
- C++ compiler: MSVC, GCC or Clang
- Visual Studio 16 2019 (Windows only)
- CMake 3.9+
- Qt 5.15+
- Server:
- C++ compiler: GCC or Clang (MSVC doesn't work yet)
- Visual Studio 16 2019 (Windows only)
- CMake
- liblua5.3 (Linux only)
- Manual:
- Python 3.6+ (older versions untested)
- pycmarkgfm (`pip3 install pycmarkgfm`)
Note: When cloning the source from git, git-lfs is required.
### Build Traintastic client
- From the project root go into the client directory: `cd client`
- Create a build directory: `cmake -E make_directory build`
- Go into the created build directory: `cd build`
- Run CMake:
- Windows: `cmake ../ -G "Visual Studio 16 2019" -A x64 -DCMAKE_BUILD_TYPE=Release`
- Linux: `cmake ../ -DCMAKE_BUILD_TYPE=Release`
- Build traintastic-client: `cmake --build . --config Release`
### Build Traintastic server
- From the project root go into the server directory: `cd server`
- Create a build directory: `cmake -E make_directory build`
- Go into the created build directory: `cd build`
- Configure CMake:
- Windows: `cmake ../ -G "Visual Studio 16 2019" -A x64 -T ClangCL -DCMAKE_BUILD_TYPE=Release -DUSB_XPRESSNET=OFF`
- Linux: `cmake ../ -DCMAKE_BUILD_TYPE=Release -DUSB_XPRESSNET=OFF`
- Build traintastic-server: `cmake --build . --config Release --target traintastic-server`
### Build Traintastic manual
1. From the project root go into the manual directory: `cd manual`
2. Run the build script: `python3 builddoc.py html-single-page --output-dir build`