Get microsite publishing

- Add Makefile "publish" target
- Use docs/ghpagesPushSite for publishing (needed for API)
- Fix CSS issues due to bad base url
- Fix missing font resources
- Add v3.0.0 Chisel API docs

Signed-off-by: Schuyler Eldridge <[email protected]>

.gitignore

@@ -7,3 +7,8 @@ build
 
 travis-deploy-key
 travis-deploy-key.pub
+
+test_run_dir
+*.anno.json
+*.v
+*.fir

.travis.yml

@@ -27,6 +27,11 @@ branches:
   only:
     - master
 
+before_script:
+  - git config --global user.email "[email protected]"
+  - git config --global user.name "ucb-bar-jenkins"
+  - git config --global push.default simple
+
 jobs:
   include:
     - stage: "legacy chisel apis"
@@ -48,5 +53,5 @@ jobs:
         - gem install sass
         - gem install jekyll -v 3.8.5
         - make
-        - if [ "$TRAVIS_BRANCH" = "master" -a "$TRAVIS_PULL_REQUEST" = "false" ]; then bash scripts/publishMicrosite.sh; fi
+        - if [ "$TRAVIS_BRANCH" = "master" -a "$TRAVIS_PULL_REQUEST" = "false" ]; then make publish; fi
         - if [ "$TRAVIS_PULL_REQUEST" = "true" ]; then echo "Not in master branch, skipping deploy and release"; fi

Makefile

@@ -34,7 +34,7 @@ api-copy = \
 	$(treadleTags:%=docs/target/site/api/treadle/%/index.html) \
 	$(diagrammerTags:%=docs/target/site/api/diagrammer/%/index.html)
 
-.PHONY: all clean mrproper serve \
+.PHONY: all clean mrproper publish serve \
 	apis-chisel apis-firrtl apis-chisel-testers apis-treadle apis-diagrammer
 .PRECIOUS: \
 	$(subprojects)/chisel3/%/.git $(subprojects)/chisel3/%/target/scala-$(scalaVersion)/unidoc/index.html \
@@ -66,6 +66,10 @@ clean:
 mrproper:
 	rm -rf $(buildDir) target project/target firrtl/target treadle/target diagrammer/target
 
+# Publish Microsite
+publish: all
+	sbt ++$(scalaVersion).$(scalaMinorVersion) docs/ghpagesPushSite
+
 # Start a Jekyll server for the site
 serve: all
 	(cd docs/target/site && jekyll serve)

build.sbt

@@ -23,20 +23,19 @@ val technologies: String =
      | - third: ["FIRRTL", "The FIRRTL circuit compiler starts after Chisel and enables backend (FPGA, ASIC, technology) specialization, automated circuit transformation, and Verilog generation."]
      |""".stripMargin
 
-lazy val docsMappingsAPIDir = settingKey[String]("Name of subdirectory in site target directory for api docs")
-
 lazy val micrositeSettings = Seq(
   scalaVersion := "2.12.6",
   micrositeName := "Chisel/FIRRTL",
   micrositeDescription := "Chisel/FIRRTL\nHardware Compiler Framework",
-  micrositeUrl := "https://chisel.eecs.berkeley.edu",
+  micrositeUrl := "https://freechipsproject.github.io/www.chisel-lang.org",
+  micrositeBaseUrl := "www.chisel-lang.org",
   micrositeAuthor := "the Chisel/FIRRTL Developers",
   micrositeTwitter := "@chisel_lang",
   micrositeGithubOwner := "freechipsproject",
   micrositeGithubRepo := "chisel3",
   micrositeGithubLinks := false,
   micrositeShareOnSocial := false,
-  micrositeDocumentationUrl := "api/chisel3/latest",
+  micrositeDocumentationUrl := "api/chisel3/latest/",
   micrositeDocumentationLabelDescription := "API Documentation",
   /* mdoc doesn't work with extraMDFiles so this is disabled for now */
   // micrositeCompilingDocsTool := WithMdoc,
@@ -87,16 +86,18 @@ lazy val micrositeSettings = Seq(
     "gray-lighter"      -> "#F4F3F4",
     "white-color"       -> "#FFFFFF"),
   autoAPIMappings := true,
-  docsMappingsAPIDir := "api/chisel3",
   ghpagesNoJekyll := false,
   scalacOptions in (ScalaUnidoc, unidoc) ++= Seq(
     "-groups",
     "-sourcepath",
     baseDirectory.in(LocalRootProject).value.getAbsolutePath,
     "-diagrams"
   ),
-  git.remoteRepo := "[email protected]:freechipsproject/chisel3.git",
-  includeFilter in makeSite := "*.html" | "*.css" | "*.png" | "*.jpg" | "*.gif" | "*.js" | "*.swf" | "*.yml" | "*.md" | "*.svg",
+  ghpagesRepository := file("build/gh-pages"),
+  ghpagesBranch := "gh-pages",
+  git.remoteRepo := "[email protected]:freechipsproject/www.chisel-lang.org.git",
+  includeFilter in makeSite := "*.html" | "*.css" | "*.png" | "*.jpg" | "*.gif" | "*.js" | "*.swf" | "*.yml" | "*.md" |
+    "*.svg" | "*.woff" | "*.ttf",
   includeFilter in Jekyll := (includeFilter in makeSite).value
 )
 

docs/src/main/resources/microsite/data/menu.yml

@@ -140,6 +140,8 @@ options:
         url: api/chisel3/v3.0.2/index.html
       - title: v3.0.1
         url: api/chisel3/v3.0.1/index.html
+      - title: v3.0.0
+        url: api/chisel3/v3.0.0/index.html
 
   # Testers Site
   - title: Testers