Revamp Configuration page

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters-select.json

@@ -0,0 +1,29 @@
+{
+  "Configuration": {
+    "Appenders": {
+      "File": {
+        "name": "MAIN",
+        // tag::select[]
+        "Select": {
+          "SystemPropertyArbiter": { // <1>
+            "propertyName": "env",
+            "propertyValue": "dev",
+            "PatternLayout": {}
+          },
+          "DefaultArbiter": { // <2>
+            "JsonTemplateLayout": {}
+          }
+        }
+        // end::select[]
+      }
+    },
+    "Loggers": {
+      "Root": {
+        "level": "INFO",
+        "AppenderRef": {
+          "ref": "MAIN"
+        }
+      }
+    }
+  }
+}

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters-select.properties

@@ -0,0 +1,32 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+appender.0.type = File
+appender.0.name = MAIN
+# tag::select[]
+appender.0.select.type = Select
+
+appender.0.select.0.type = SystemPropertyArbiter # <1>
+appender.0.select.0.propertyName = env
+appender.0.select.0.propertyValue = dev
+appender.0.select.0.layout.type = PatternLayout
+
+appender.0.select.1.type = DefaultArbiter # <2>
+appender.0.select.1.layout.type = JsonTemplateLayout
+# end::select[]
+
+rootLogger.level = INFO
+rootLogger.appenderRef.0.ref = MAIN

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters-select.xml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="
+                   https://logging.apache.org/xml/ns
+                   https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders>
+    <File name="MAIN" fileName="logs/app.log">
+      <!-- tag::select[] -->
+      <Select>
+        <SystemPropertyArbiter propertyName="env" propertyValue="dev"> <!--1-->
+          <PatternLayout/>
+        </SystemPropertyArbiter>
+        <DefaultArbiter> <!--2-->
+          <JsonTemplateLayout/>
+        </DefaultArbiter>
+      </Select>
+      <!-- end::select[] -->
+    </File>
+  </Appenders>
+  <Loggers>
+    <Root level="INFO">
+      <AppenderRef ref="MAIN"/>
+    </Root>
+  </Loggers>
+</Configuration>

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters-select.yaml

@@ -0,0 +1,35 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+Configuration:
+  Appenders:
+    File:
+      name: "MAIN"
+      fileName: "logs/app.log"
+      # tag::select[]
+      Select:
+        SystemPropertyArbiter: # <1>
+          propertyName: "env"
+          propertyValue: "dev"
+          PatternLayout: {}
+        DefaultArbiter: # <2>
+          JsonTemplateLayout: {}
+      # end::select[]
+  Loggers:
+    Root:
+      level: "INFO"
+      AppenderRef:
+        ref: "MAIN"

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters.json

@@ -0,0 +1,33 @@
+{
+  "Configuration": {
+    "Appenders": {
+      "File": {
+        "name": "MAIN",
+        "SystemPropertyArbiter": [
+          // <1>
+          {
+            "propertyName": "env",
+            "propertyValue": "dev",
+            "PatternLayout": {
+              "pattern": "%d [%t] %p %c - %m%n"
+            }
+          },
+          // <2>
+          {
+            "propertyName": "env",
+            "propertyValue": "prod",
+            "JsonTemplateLayout": {}
+          }
+        ]
+      }
+    },
+    "Loggers": {
+      "Root": {
+        "level": "INFO",
+        "AppenderRef": {
+          "ref": "MAIN"
+        }
+      }
+    }
+  }
+}

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters.properties

@@ -0,0 +1,32 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+appender.0.type = File
+appender.0.name = MAIN
+
+appender.0.arbiter[0].type = SystemPropertyArbiter # <1>
+appender.0.arbiter[0].propertyName = env
+appender.0.arbiter[0].propertyValue = dev
+appender.0.arbiter[0].layout.type = PatternLayout
+appender.0.arbiter[0].layout.pattern = %d [%t] %p %c - %m%n
+
+appender.0.arbiter[1].type = SystemPropertyArbiter # <2>
+appender.0.arbiter[1].propertyName = env
+appender.0.arbiter[1].propertyValue = prod
+appender.0.arbiter[1].layout.type = JsonTemplateLayout
+
+rootLogger.level = INFO
+rootLogger.appenderRef.0.ref = MAIN

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="
+                   https://logging.apache.org/xml/ns
+                   https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders>
+    <File name="MAIN" fileName="logs/app.log">
+      <SystemPropertyArbiter propertyName="env" propertyValue="dev"> <!--1-->
+        <PatternLayout pattern="%d [%t] %p %c - %m%n"/>
+      </SystemPropertyArbiter>
+      <SystemPropertyArbiter propertyName="env" propertyValue="prod"> <!--2-->
+        <JsonTemplateLayout/>
+      </SystemPropertyArbiter>
+    </File>
+  </Appenders>
+  <Loggers>
+    <Root level="INFO">
+      <AppenderRef ref="MAIN"/>
+    </Root>
+  </Loggers>
+</Configuration>

src/site/antora/modules/ROOT/examples/manual/configuration/arbiters.yaml

@@ -0,0 +1,34 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+Configuration:
+  Appenders:
+    File:
+      name: "MAIN"
+      fileName: "logs/app.log"
+      SystemPropertyArbiter:
+        - propertyName: "env" # <1>
+          propertyValue: "dev"
+          PatternLayout:
+            pattern: "%d [%t] %p %c - %m%n"
+        - propertyName: "env" # <2>
+          propertyValue: "prod"
+          JsonTemplateLayout: {}
+  Loggers:
+    Root:
+      level: "INFO"
+      AppenderRef:
+        ref: "MAIN"

src/site/antora/modules/ROOT/examples/manual/configuration/logger-properties.json

@@ -0,0 +1,29 @@
+{
+  "Configuration": {
+    "Appenders": {},
+    "Loggers": {
+      // tag::loggers[]
+      "Root": {
+        "Property": {
+          "name": "client.address",
+          "value": "$${web:request.remoteAddress}"
+        }
+      },
+      "Logger": [
+        {
+          "name": "org.hibernate",
+          "Property": {
+            "subsystem": "Database"
+          }
+        },
+        {
+          "name": "io.netty",
+          "Property": {
+            "subsystem": "Networking"
+          }
+        }
+      ]
+      // end::loggers[]
+    }
+  }
+}

src/site/antora/modules/ROOT/examples/manual/configuration/logger-properties.properties

@@ -0,0 +1,32 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+##
+# tag::loggers[]
+rootLogger.property.type = Property
+rootLogger.name = client.address
+rootLogger.value = $${web:request.remoteAddress}
+
+logger.0.name = org.hibernate
+logger.0.property.type = Property
+logger.0.property.name = subsystem
+logger.0.property.value = Database
+
+logger.1.name = io.netty
+logger.1.property.type = Property
+logger.1.property.name = subsystem
+logger.1.property.value = Networking
+# end::loggers[]

src/site/antora/modules/ROOT/examples/manual/configuration/logger-properties.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="
+                   https://logging.apache.org/xml/ns
+                   https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders/>
+  <Loggers>
+    <!-- tag::loggers[] -->
+    <Root>
+      <Property name="client.address" value="$${web:request.remoteAddress}"/>
+    </Root>
+    <Logger name="org.hibernate">
+      <Property name="subsystem" value="Database"/>
+    </Logger>
+    <Logger name="io.netty">
+      <Property name="subsystem" value="Networking"/>
+    </Logger>
+    <!-- end::loggers[] -->
+  </Loggers>
+</Configuration>