This repository contains the sources for the DB Systel Tech-Blog called "Tech Stories".
All code is licensed under Apache-2.0, Copyright 2023 by DB Systel GmbH.
For any usage outside of Deutsche Bahn websites and applications you must remove or replace any Deutsche Bahn brand and design assets as well as protected characteristics and trademarks.
-
Make sure you have
wgetinstalled.
To work with DocToolchain for building the Microsite, you need to have Java installed. The Following command load the latest compatible Java version and installs it locally in path that’s accessible by DocToolchain.
./dtcw getJavaTo quickly build the documentation with a docker container, use:
arch ./dtcw docker generateSite
arch ./dtcw docker previewSiteYou can also run a local build and preview:
arch ./dtcw docker generateSite
arch ./dtcw docker previewSiteWhen writing an article, the first thing you need is an author profile (if not already exist).
You will find the profiles in /src/docs/blog/profiles.
If you already have a profile, be sure it’s up-to-date and probably refresh the information in it.
If you don’t have a profile, you can scaffold a new profile using the generator which prompts you for some base information needed.
./dtcw local createAuthorAfter you answered all questions, a new profile .adoc is created.
Please check the content and add some additional information about you.
Once your profile created and is up-to-date (see section above), you can create the Tech Story with it’s content. Therefore you can make use of the generator as well by running:
./dtcw local createStoryThe generator will prompt you for the base information needed for a Tech Story. Once you filled out everything, the AsciiDoc File with all meta information is generated and you can directly start writing your content. Happy writing!