
= Authorization Services Guide

image:images/keycloak_logo.png[alt="Keycloak"]

{{book.project.name}} {{book.project.version}}

http://www.keycloak.org


== Test the Product Build

Follow the steps below to test that this documentation for the product build.

. In a terminal, navigate to the root folder of this project source.
. Convert the content by running the following Python command.
+
[source,options="nowrap"]
----
$ python gitlab-conversion.py
----
. This command puts the converted content in the `target/` directory.
. Copy the `buildGuide.sh` script from the root of the project folder to the `target/` directory.
+
[source,options="nowrap"]
----
cp buildGuide.sh target/
----
. Navigate to the `target/` directory and build the documentation to be sure there are no errors.
+
[source,options="nowrap"]
----
./buildGuide.sh
----
. Open the link provided as a result of the build and visually check the guide to make sure it is correctly formatted.
* Search for '<<' to find links that were not converted.
* Search for '==' to find titles that are not rendered correctly.
