removed cruft from the API website generation and now have a separate JS API build (as it fails right now)
This commit is contained in:
@@ -0,0 +1,70 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project
|
||||||
|
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
|
||||||
|
xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
|
||||||
|
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
|
||||||
|
<parent>
|
||||||
|
<groupId>org.jetbrains.kotlin.docs</groupId>
|
||||||
|
<artifactId>docs</artifactId>
|
||||||
|
<version>1.0-SNAPSHOT</version>
|
||||||
|
</parent>
|
||||||
|
|
||||||
|
<artifactId>jsdoc</artifactId>
|
||||||
|
|
||||||
|
<properties>
|
||||||
|
<js.lib.dir>${basedir}/../../../js/js.libraries</js.lib.dir>
|
||||||
|
</properties>
|
||||||
|
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.jetbrains.kotlin</groupId>
|
||||||
|
<artifactId>stdlib</artifactId>
|
||||||
|
<version>${project.version}</version>
|
||||||
|
</dependency>
|
||||||
|
<dependency>
|
||||||
|
<groupId>junit</groupId>
|
||||||
|
<artifactId>junit</artifactId>
|
||||||
|
<version>${junit-version}</version>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
|
||||||
|
<build>
|
||||||
|
<plugins>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.jetbrains.kotlin</groupId>
|
||||||
|
<artifactId>kdoc-maven-plugin</artifactId>
|
||||||
|
<version>${project.version}</version>
|
||||||
|
<configuration>
|
||||||
|
<sources>
|
||||||
|
<source>${js.lib.dir}/src/core</source>
|
||||||
|
<source>${js.lib.dir}/src/html5</source>
|
||||||
|
<source>${js.lib.dir}/src/jquery</source>
|
||||||
|
<source>${js.lib.dir}/src/raphael</source>
|
||||||
|
</sources>
|
||||||
|
<title>Kotlin JavaScript API (${project.version})</title>
|
||||||
|
<ignorePackages>
|
||||||
|
<ignorePackage>com</ignorePackage>
|
||||||
|
<ignorePackage>sun</ignorePackage>
|
||||||
|
<ignorePackage>java</ignorePackage>
|
||||||
|
<ignorePackage>jet</ignorePackage>
|
||||||
|
<ignorePackage>junit</ignorePackage>
|
||||||
|
<ignorePackage>org</ignorePackage>
|
||||||
|
</ignorePackages>
|
||||||
|
|
||||||
|
</configuration>
|
||||||
|
|
||||||
|
<executions>
|
||||||
|
<execution>
|
||||||
|
<id>apidoc</id>
|
||||||
|
<phase>install</phase>
|
||||||
|
<goals>
|
||||||
|
<goal>apidoc</goal>
|
||||||
|
</goals>
|
||||||
|
</execution>
|
||||||
|
</executions>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
|
</build>
|
||||||
|
</project>
|
||||||
+12
-48
@@ -17,67 +17,31 @@ class GenerateSiteTest : TestCase() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
fun testCopyApiDocs(): Unit {
|
fun testCopyApiDocs(): Unit {
|
||||||
val outDir = File(siteOutputDir, "versions/$versionDir/apidocs")
|
|
||||||
println("Generating library KDocs to $outDir")
|
|
||||||
|
|
||||||
copyDocResources(outDir)
|
|
||||||
|
|
||||||
val apidocDir = File(siteOutputDir, "../../../apidoc/target/site/apidocs")
|
val apidocDir = File(siteOutputDir, "../../../apidoc/target/site/apidocs")
|
||||||
assertTrue(apidocDir.exists(), "Directory does not exist ${apidocDir.getCanonicalPath()}")
|
assertTrue(apidocDir.exists(), "Directory does not exist ${apidocDir.getCanonicalPath()}")
|
||||||
|
|
||||||
|
val outDir = File(siteOutputDir, "versions/$versionDir/apidocs")
|
||||||
|
println("Copying API docs to $outDir")
|
||||||
|
|
||||||
|
copyDocResources(outDir)
|
||||||
copyRecursive(apidocDir, outDir)
|
copyRecursive(apidocDir, outDir)
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
fun testCopyJSApiDocs(): Unit {
|
||||||
fun testGenerateStdlibKDoc(): Unit {
|
val apidocDir = File(siteOutputDir, "../../../jsdoc/target/site/apidocs")
|
||||||
val outDir = File(siteOutputDir, "versions/$versionDir/apidocs")
|
//assertTrue(apidocDir.exists(), "Directory does not exist ${apidocDir.getCanonicalPath()}")
|
||||||
println("Generating library KDocs to $outDir")
|
if (!apidocDir.exists()) {
|
||||||
|
println("WARNING - no JS API docs available. Though they don't work right now so are optional :)")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
copyDocResources(outDir)
|
|
||||||
val args = KDocArguments()
|
|
||||||
args.setModule("../kdoc/ApiDocsModule.kt")
|
|
||||||
args.setOutputDir("target/classes-stdlib")
|
|
||||||
|
|
||||||
val config = args.docConfig
|
|
||||||
config.docOutputDir = outDir.getCanonicalPath()!!
|
|
||||||
config.title = "Kotlin API ($version)"
|
|
||||||
config.version = version
|
|
||||||
config.ignorePackages.add("kotlin.support")
|
|
||||||
config.ignorePackages.add("org.jetbrains.kotlin")
|
|
||||||
config.ignorePackages.add("java")
|
|
||||||
config.ignorePackages.add("jet")
|
|
||||||
config.ignorePackages.add("junit")
|
|
||||||
config.ignorePackages.add("sun")
|
|
||||||
config.ignorePackages.add("org")
|
|
||||||
|
|
||||||
val compiler = KDocCompiler()
|
|
||||||
compiler.exec(System.out, args)
|
|
||||||
}
|
|
||||||
|
|
||||||
fun testGenerateJsKDoc(): Unit {
|
|
||||||
val outDir = File(siteOutputDir, "versions/$versionDir/jsdocs")
|
val outDir = File(siteOutputDir, "versions/$versionDir/jsdocs")
|
||||||
println("Generating JS KDocs to $outDir")
|
println("Copying JavaScript API docs to $outDir")
|
||||||
|
|
||||||
copyDocResources(outDir)
|
copyDocResources(outDir)
|
||||||
val args = KDocArguments()
|
|
||||||
args.setModule("../../js/js.libraries/module.kt")
|
|
||||||
args.setOutputDir("target/classes-js")
|
|
||||||
|
|
||||||
val config = args.docConfig
|
copyRecursive(apidocDir, outDir)
|
||||||
config.docOutputDir = outDir.getCanonicalPath()!!
|
|
||||||
config.title = "Kotlin JS API ($version)"
|
|
||||||
config.version = version
|
|
||||||
config.ignorePackages.add("java")
|
|
||||||
config.ignorePackages.add("jet")
|
|
||||||
config.ignorePackages.add("junit")
|
|
||||||
config.ignorePackages.add("org")
|
|
||||||
config.ignorePackages.add("sun")
|
|
||||||
|
|
||||||
val compiler = KDocCompiler()
|
|
||||||
compiler.exec(System.out, args)
|
|
||||||
}
|
}
|
||||||
*/
|
|
||||||
|
|
||||||
fun copyDocResources(outDir: File): Unit {
|
fun copyDocResources(outDir: File): Unit {
|
||||||
val sourceDir = File(srcDir, "../apidocs")
|
val sourceDir = File(srcDir, "../apidocs")
|
||||||
|
|||||||
Reference in New Issue
Block a user