Bootstrap use of common Gradle docs infrastructure for a native-samples site

build.gradle.kts

@@ -1,4 +1,47 @@
+import org.asciidoctor.gradle.AsciidoctorTask
+
 // This root project is simply a container of sample builds
 plugins {
+    `java-library`
+    `kotlin-dsl`
+    id("org.asciidoctor.convert") version "1.5.3"
     id("org.gradle.samples.wrapper")
 }
+
+repositories {
+    jcenter()
+    maven { url = uri("https://repo.gradle.org/gradle/libs-releases") }
+}
+
+dependencies {
+    testImplementation("org.gradle:sample-check:0.7.0")
+    testImplementation(gradleTestKit())
+    asciidoctor("org.gradle:docs-asciidoctor-extensions:0.6.0")
+}
+
+tasks {
+    getByName<AsciidoctorTask>("asciidoctor") {
+        inputs.dir("cpp/application")
+        sourceDir = file("cpp/application")
+        outputDir = file("docs")
+        backends("html5")
+
+        attributes(
+                mapOf("source-highlighter" to "prettify",
+                        "imagesdir" to "images",
+                        "stylesheet" to null,
+                        "linkcss" to true,
+                        "docinfodir" to ".",
+                        "docinfo1" to "",
+                        "nofooter" to true,
+                        "icons" to "font",
+                        "sectanchors" to true,
+                        "sectlinks" to true,
+                        "linkattrs" to true,
+                        "encoding" to "utf-8",
+                        "idprefix" to "",
+                        "toc" to "auto",
+                        "toclevels" to 1)
+        )
+    }
+}

cpp/application/index.adoc

@@ -0,0 +1,19 @@
+= C++ Application
+:description: A description of the sample
+
+.Assembling and running the C++ application
+====
+[.testable-sample,dir="cpp/application"]
+=====
+[.sample-command,allow-additional-output=true]
+----
+$ ./gradlew assemble
+----
+
+[.sample-command]
+----
+$ ./build/install/main/debug/app
+Hello, World!
+----
+=====
+====

src/test/java/org/gradle/samples/EmbeddedSamplesRunnerIntegrationTest.java

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed 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.
+ */
+package org.gradle.samples;
+
+import org.gradle.samples.test.runner.GradleEmbeddedSamplesRunner;
+import org.gradle.samples.test.runner.SamplesRoot;
+import org.junit.runner.RunWith;
+
+@RunWith(GradleEmbeddedSamplesRunner.class)
+@SamplesRoot("cpp/application")
+public class EmbeddedSamplesRunnerIntegrationTest {
+}