KEYCLOAK-4424 Add shared scripts and book-product.json to toplevel
This commit is contained in:
parent
cf18563e95
commit
783741143a
12 changed files with 297 additions and 13 deletions
10
README.md
10
README.md
|
@ -38,7 +38,7 @@ Keycloak is the basis of [Red Hat Single Sign-On](https://access.redhat.com/prod
|
|||
To build the documentation for RH-SSO go into the directory of the specific guide you want to build. For example to build Server Admin guide run:
|
||||
|
||||
cd server_admin
|
||||
python gitlab-conversion.py
|
||||
python ../gitlab-conversion.py
|
||||
cd target
|
||||
asciidoctor master.adoc
|
||||
|
||||
|
@ -46,6 +46,14 @@ On Linux you can also run build-product.sh DIR. For example:
|
|||
|
||||
./build-product.sh server_admin
|
||||
|
||||
Or build all guides with:
|
||||
|
||||
./build-product.sh
|
||||
|
||||
If you have ccutil available you can build the guides with:
|
||||
|
||||
./build-product.sh -u
|
||||
|
||||
You can then view the documentation by opening server_admin/target/master.html
|
||||
|
||||
This will not create documentation that looks exactly as the official Red Hat Single Sign-On documentation, but the content will be the same.
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Keycloak Documentation
|
||||
|
||||
. link:getting_started/README.adoc[Getting Started]
|
||||
{% include "./getting_started/SUMMARY.adoc" %}
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Authorization Services Guide
|
||||
|
||||
.. link:authorization_services/topics/overview/overview.adoc[Overview]
|
||||
|
||||
|
|
105
book-product.json
Executable file
105
book-product.json
Executable file
|
@ -0,0 +1,105 @@
|
|||
{
|
||||
"gitbook": "2.x.x",
|
||||
"structure": {
|
||||
"readme": "OVERVIEW.adoc"
|
||||
},
|
||||
"plugins": [
|
||||
"toggle-chapters",
|
||||
"ungrey",
|
||||
"splitter",
|
||||
"ga"
|
||||
],
|
||||
"pluginsConfig": {
|
||||
"ga": {
|
||||
"token": "UA-86203452-1"
|
||||
}
|
||||
},
|
||||
|
||||
"variables": {
|
||||
"project": {
|
||||
"name": "Red Hat Single Sign-On",
|
||||
"version": "SNAPSHOT",
|
||||
"versionMvn": "SNAPSHOT",
|
||||
"versionNpm": "SNAPSHOT",
|
||||
"doc_base_url": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/",
|
||||
"doc_info_version_url": "7.1"
|
||||
},
|
||||
"community": false,
|
||||
"product": true,
|
||||
"images": "rhsso-images",
|
||||
|
||||
"adminguide": {
|
||||
"name": "Server Administration",
|
||||
"link": "https://keycloak.gitbooks.io/documentation/content/server_admin/index.html"
|
||||
},
|
||||
"developerguide": {
|
||||
"name": "Server Development",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/SNAPSHOT/html-single/server-developer-guide/"
|
||||
},
|
||||
"installguide": {
|
||||
"name": "Server Installation and Configuration",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/SNAPSHOT/html-single/server-installation-and-configuration-guide/"
|
||||
},
|
||||
"adapterguide": {
|
||||
"name": "Securing Applications and Services Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/SNAPSHOT/html-single/securing-applications-and-services-guide/"
|
||||
},
|
||||
"gettingstarted": {
|
||||
"name": "Getting Started Tutorial",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/SNAPSHOT/html/getting-started-guide/"
|
||||
},
|
||||
"apidocs": {
|
||||
"name": "API Documentation",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-single-sign-on/SNAPSHOT/html-single/api-documentation/"
|
||||
},
|
||||
|
||||
"quickstartRepo": {
|
||||
"name": "Keycloak Quickstarts Repository",
|
||||
"link": "https://github.com/keycloak/keycloak-quickstarts",
|
||||
"dir": "keycloak-quickstarts"
|
||||
},
|
||||
|
||||
"fuseVersion": "JBoss Fuse 6.3.0 Rollup 1",
|
||||
|
||||
"appserver": {
|
||||
"name": "JBoss EAP",
|
||||
"version": "7.0",
|
||||
"admindoc": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/configuration-guide"
|
||||
},
|
||||
"datasource": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#datasource_management"
|
||||
},
|
||||
"network": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#network_and_port_configuration"
|
||||
},
|
||||
"socket": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#network_and_port_configuration"
|
||||
},
|
||||
"loadbalancer": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#configuring_high_availability"
|
||||
},
|
||||
"jgroups": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#cluster_communication_jgroups"
|
||||
},
|
||||
"caching": {
|
||||
"name": "JBoss EAP Configuration Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/configuration-guide/#infinispan"
|
||||
},
|
||||
"jpa": {
|
||||
"name": "JBoss EAP Development Guide",
|
||||
"link": "https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/html-single/development-guide/#hibernate"
|
||||
}
|
||||
},
|
||||
|
||||
"subsystem": {
|
||||
"undertow": "urn:jboss:domain:undertow:3.1"
|
||||
}
|
||||
}
|
||||
}
|
|
@ -16,7 +16,6 @@
|
|||
},
|
||||
|
||||
"variables": {
|
||||
"title": "Keycloak Documentation",
|
||||
"project": {
|
||||
"name": "Keycloak",
|
||||
"version": "SNAPSHOT",
|
||||
|
|
|
@ -1,9 +1,70 @@
|
|||
#!/bin/bash
|
||||
|
||||
TOOL="asciidoctor"
|
||||
|
||||
while getopts "h?auc" opt; do
|
||||
case "$opt" in
|
||||
h|\?)
|
||||
echo "Usage: build-guide.sh [OPTION] [GUIDE]"
|
||||
echo ""
|
||||
echo " -a use asciidoctor (default)"
|
||||
echo " -u use ccutil"
|
||||
echo " -c delete built guides"
|
||||
echo ""
|
||||
echo "If guide is not specified all guides are built. GUIDE should be the directory"
|
||||
echo "name of the specific guide to build."
|
||||
exit 0
|
||||
;;
|
||||
a) TOOL="asciidoctor"
|
||||
;;
|
||||
u) TOOL="ccutil"
|
||||
;;
|
||||
c) TOOL="clean"
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
shift $((OPTIND-1))
|
||||
[ "$1" = "--" ] && shift
|
||||
|
||||
GUIDE=$1
|
||||
|
||||
cd $GUIDE
|
||||
python gitlab-conversion.py
|
||||
cd target
|
||||
asciidoctor master.adoc
|
||||
function buildGuide
|
||||
{
|
||||
GUIDE=$1
|
||||
CURRENT_DIRECTORY=$(pwd)
|
||||
|
||||
echo "***********************************************************************************************************"
|
||||
echo "$TOOL: $GUIDE"
|
||||
echo ""
|
||||
|
||||
cd $GUIDE
|
||||
rm -rf build
|
||||
rm -rf target
|
||||
|
||||
python ../gitlab-conversion.py
|
||||
|
||||
if [ "$TOOL" = "asciidoctor" ]; then
|
||||
asciidoctor -dbook -a toc -o target/master.html target/master.adoc
|
||||
echo ""
|
||||
echo "Built file://$CURRENT_DIRECTORY/$GUIDE/target/master.html"
|
||||
fi
|
||||
|
||||
if [ "$TOOL" = "ccutil" ]; then
|
||||
ccutil compile --lang en_US --format html-single --main-file target/master.adoc
|
||||
echo ""
|
||||
echo "Built file://$CURRENT_DIRECTORY/$GUIDE/build/tmp/en-US/html-single/index.html"
|
||||
fi
|
||||
|
||||
cd ..
|
||||
}
|
||||
|
||||
if [ "$GUIDE" = "" ]; then
|
||||
for i in authorization_services getting_started securing_apps server_admin server_development server_installation; do
|
||||
buildGuide $i
|
||||
done
|
||||
else
|
||||
buildGuide $GUIDE
|
||||
fi
|
||||
|
||||
echo "***********************************************************************************************************"
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Getting Started Guide
|
||||
|
||||
.. link:getting_started/topics/overview.adoc[Overview]
|
||||
.. link:getting_started/topics/first-boot.adoc[Installing and Booting]
|
||||
|
|
111
gitlab-conversion.py
Executable file
111
gitlab-conversion.py
Executable file
|
@ -0,0 +1,111 @@
|
|||
import sys, os, re, json, shutil, errno
|
||||
|
||||
def transform(root, f, targetdir):
|
||||
full = os.path.join(root, f)
|
||||
input = open(full, 'r').read()
|
||||
dir = os.path.join(targetdir, root)
|
||||
if not os.path.exists(dir):
|
||||
os.makedirs(dir)
|
||||
output = open(os.path.join(dir, f), 'w')
|
||||
input = applyTransformation(input)
|
||||
output.write(input)
|
||||
|
||||
|
||||
def applyTransformation(input):
|
||||
for variable in re.findall(r"\{\{(.*?)\}\}", input):
|
||||
tmp = variable.replace('.', '_')
|
||||
input = input.replace(variable, tmp)
|
||||
input = input.replace('{{', '{').replace('}}', '}')
|
||||
input = re.sub(r"<<fake.+#", "<<", input)
|
||||
for variable in re.findall(r"[ ]*{% if (.*?) %}", input):
|
||||
tmp = variable.replace('.', '_')
|
||||
input = input.replace(variable, tmp)
|
||||
exp = re.compile("[ ]*{% if (.*?) %}(.*?)[ ]*{% endif %}", re.DOTALL)
|
||||
input = re.sub(exp, "ifeval::[{\g<1>}==true]\g<2>endif::[]", input)
|
||||
input = re.sub(r"image:(\.\./)*", "image:", input)
|
||||
input = re.sub(r"image::(\.\./)*", "image::", input)
|
||||
return input
|
||||
|
||||
|
||||
indir = 'topics'
|
||||
targetdir = 'target'
|
||||
if len(sys.argv) > 1:
|
||||
targetdir = sys.argv[1]
|
||||
|
||||
if os.path.exists(targetdir):
|
||||
shutil.rmtree(targetdir)
|
||||
|
||||
if os.path.isdir('images'):
|
||||
shutil.copytree('images',os.path.join(targetdir, 'images'))
|
||||
if os.path.isdir('keycloak-images'):
|
||||
shutil.copytree('keycloak-images',os.path.join(targetdir, 'keycloak-images'))
|
||||
if os.path.isdir('rhsso-images'):
|
||||
shutil.copytree('rhsso-images',os.path.join(targetdir, 'rhsso-images'))
|
||||
|
||||
shutil.copyfile('metadata.ini', os.path.join(targetdir, 'metadata.ini'));
|
||||
shutil.copyfile('master-docinfo.xml', os.path.join(targetdir, 'master-docinfo.xml'));
|
||||
|
||||
tmp = os.path.join(targetdir, 'topics')
|
||||
if not os.path.exists(tmp):
|
||||
os.makedirs(tmp)
|
||||
|
||||
# transform files
|
||||
for root, dirs, filenames in os.walk(indir):
|
||||
for f in filenames:
|
||||
transform(root,f,targetdir)
|
||||
|
||||
# Create master.doc includes
|
||||
input = open('SUMMARY.adoc', 'r').read()
|
||||
output = open(os.path.join(targetdir, 'master.adoc'), 'w')
|
||||
|
||||
output.write("""
|
||||
:toc:
|
||||
:toclevels: 3
|
||||
:numbered:
|
||||
|
||||
include::document-attributes.adoc[]
|
||||
""")
|
||||
|
||||
input = re.sub(r"[ ]*\.+\s*link:[^/]+/(.*)\[(.*)\]", "include::\g<1>[]", input)
|
||||
input = applyTransformation(input)
|
||||
output.write(input)
|
||||
|
||||
# parse book-product.json file and create document attributes
|
||||
with open('../book-product.json') as data_file:
|
||||
data = json.load(data_file)
|
||||
|
||||
variables = data['variables']
|
||||
|
||||
def makeAttributes(variables, variable, list):
|
||||
for i in variables.keys():
|
||||
if variable is None:
|
||||
tmp = i
|
||||
else:
|
||||
tmp = variable + '_' + i
|
||||
if isinstance(variables[i],dict):
|
||||
makeAttributes(variables[i], tmp, list)
|
||||
elif isinstance(variables[i],bool):
|
||||
boolval = 'false'
|
||||
if variables[i]:
|
||||
boolval = 'true'
|
||||
list.append({tmp: boolval})
|
||||
else:
|
||||
list.append({tmp: str(variables[i])})
|
||||
|
||||
|
||||
attributeList = []
|
||||
makeAttributes(variables, None, attributeList)
|
||||
|
||||
output = open(os.path.join(targetdir, 'document-attributes.adoc'), 'w')
|
||||
for attribute in attributeList:
|
||||
for k in attribute.keys():
|
||||
output.write(':book_' + k + ": " + attribute[k] + "\n")
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Securing Applications and Services Guide
|
||||
|
||||
.. link:securing_apps/topics/overview/overview.adoc[Overview]
|
||||
... link:securing_apps/topics/overview/what-are-client-adapters.adoc[What are Client Adapters?]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Server Administration Guide
|
||||
|
||||
.. link:server_admin/topics/overview.adoc[Overview]
|
||||
... link:server_admin/topics/overview/features.adoc[Features]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Server Developer Guide
|
||||
|
||||
.. link:server_development/topics/preface.adoc[Preface]
|
||||
.. link:server_development/topics/admin-rest-api.adoc[Admin REST API]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
= {{book.title}}
|
||||
= Server Installation Guide
|
||||
|
||||
.. link:server_installation/topics/overview.adoc[Overview]
|
||||
... link:server_installation/topics/overview/recommended-reading.adoc[Recommended Reading]
|
||||
|
|
Loading…
Reference in a new issue