What is Jekyll?#

Jekyll is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through a converter (like Markdown) and our Liquid renderer, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server.

What is front matter?#

The front matter is where Jekyll starts to get really cool. Any file that contains a YAML front matter block will be processed by Jekyll as a special file. The front matter must be the first thing in the file and must take the form of valid YAML set between triple-dashed lines

What is a static file?#

A static file is a file that does not contain any YAML front matter. These include images, PDFs, and other un-rendered content.

What is a collection?#

Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.

What is a data file?#

In addition to the built-in variables available from Jekyll, you can specify your own custom data that can be accessed via the Liquid templating system. Jekyll supports loading data from YAML, JSON, and CSV files located in the _data directory. Note that CSV files must contain a header row.

## Which links should I bookmark? * RealmJoin Admin Console * RealmJoin Uploader / Package Request * Gitlab Packages * Documentation ## Am I able to maintain my own packages and updates Yes. RealmJoin offers packageing-as-a-service but you may also check in ready-to-use packages. In addition it is possible to use additional deployment repositories completely maintained independently. ## Which platforms are supported? RealmJoin v4 is only available for Windows 10. ## I do not see my groups in the Admin Console The sync between Azure AD and RealmJoin is scheduled every 15 minutes and based on your custom pattern ruleset. ## How to enter the *Debug Mode* in RealmJoin client? Click on the RealmJoin tray icon while pressing STRG and Shift on the Keyboard. For a detailed description of the *debug mode* see chapter *troubleshooting*. ## I accidentally uninstalled software using the Windows Apps control Force reinstall by using the *debug mode*. ## Can I get rid of Bloatware using RealmJoin? TBD ## Is RealmJoin providing an uninstall of software? A general uninstall feature is currently not implemented. Choco packages provide a generic uninstall component which would be usable for RealmJoin, but because of the volatile history of unattends and the sometimes unpredictable issues with incomplete uninstalls we have decided against using it. In real world there are typically three reasons to uninstall software: * The license should be re-used for a different user. In this case it's easy to just create a package to enable/disable a license for a user. * The software needs to be removed because of [choose your reason]. In this case a dedicated remove-software-package can be created. * There is a newer version of the software. This is not a reason to use an uninstall command but instead it is a common practice for every software package used by RealmJoin to 'clean' any precursory binaries or settings. ## Should I use the applications internal auto updater or not? TBD ## How can I manage the RJ Tenants? TBD ## Re-Install failed software installations RealmJoin tries to redo failed installations on the next three logons. If the installations still fails the package is marked as permanent-failed. To reinstall it at a later time use "Retry base installation" in *debug mode*. ## Since the packages are based on open protocols, can others access my packages? Yes. NuGet and Chocolatey repositories are based on open protocols. Using search commands one is able to find all repositories that are hosted on the GK tenant. Since packages **should not** contain personalized information like licenses or user specific data, there is no potential harm in e.g. installing a Office package with a different companies name in the package description. It is in principle possible to host the RealmJoin ## What Firewall/Proxy settings do I have to configure? Please check chapter *Technical* section *Requirements* for detailed information on the RealmJoin connections.