Restore correct format for HTML docs (istio#267)

sdake · Sep 6, 2019 · 76fab48 · 76fab48
1 parent d6c4df8
commit 76fab48
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 2,391 deletions.
diff --git a/Makefile.core.mk b/Makefile.core.mk
@@ -71,7 +71,7 @@ python_output_path := python/istio_api
 protoc_gen_python_prefix := --python_out=,
 protoc_gen_python_plugin := $(protoc_gen_python_prefix):$(repo_dir)/$(python_output_path)
 
-protoc_gen_docs_plugin := --docs_out=warnings=true,emit_yaml=true,mode=html_page:$(repo_dir)/
+protoc_gen_docs_plugin := --docs_out=warnings=true,mode=html_fragment_with_front_matter:$(repo_dir)/
 
 types_v1alpha2_path := pkg/apis/istio/v1alpha2
 types_v1alpha2_protos := $(wildcard $(types_v1alpha2_path)/*.proto)

diff --git a/pkg/apis/istio/v1alpha2/istio.operator.v1alpha2.pb.html b/pkg/apis/istio/v1alpha2/istio.operator.v1alpha2.pb.html
@@ -1,172 +1,9 @@
-<!DOCTYPE html>
-<html itemscope itemtype="https://schema.org/WebPage">
-<!-- Generated by protoc-gen-docs -->
-<head>
-<meta charset="utf-8'>
-<meta name="viewport' content="width=device-width, initial-scale=1, shrink-to-fit=no">
-
-<style>
-    html {
-        overflow-y: scroll;
-        position: relative;
-        min-height: 100%
-    }
-
-    body {
-        font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif;
-        color: #535f61
-    }
-
-    a {
-        color: #466BB0;
-        text-decoration: none;
-        font-weight: 500
-    }
-
-    a:hover, a:focus {
-        color: #8ba3d1;
-        text-decoration: none;
-        font-weight: 500
-    }
-
-    a.disabled {
-        color: #ccc;
-        text-decoration: none;
-        font-weight: 500
-    }
-
-    table, th, td {
-        border: 1px solid #849396;
-        padding: .3em
-    }
-
-	tr.oneof>td {
-		border-bottom: 1px dashed #849396;
-		border-top: 1px dashed #849396;
-	}
-
-    table {
-        border-collapse: collapse
-    }
-
-    th {
-        color: #fff;
-        background-color: #286AC7;
-        font-weight: normal
-    }
-
-    p {
-        font-size: 1rem;
-        line-height: 1.5;
-        margin: .25em 0
-    }
-
-	table p:first-of-type {
-		margin-top: 0
-	}
-
-	table p:last-of-type {
-		margin-bottom: 0
-	}
-
-    @media (min-width: 768px) {
-        p {
-            margin: 1.5em 0
-        }
-    }
-
-    li, dt, dd {
-        font-size: 1rem;
-        line-height: 1.5;
-        margin: .25em
-    }
-
-    ol, ul, dl {
-        list-style: initial;
-        font-size: 1rem;
-        margin: 0 1.5em;
-        padding: 0
-    }
-
-    li p, dt p, dd p {
-        margin: .4em 0
-    }
-
-    ol {
-        list-style: decimal
-    }
-
-    h1, h2, h3, h4, h5, h6 {
-        border: 0;
-        font-weight: normal
-    }
-
-    h1 {
-        font-size: 2.5rem;
-        color: #286AC7;
-        margin: 30px 0
-    }
-
-    h2 {
-        font-size: 2rem;
-        color: #2E2E2E;
-        margin-bottom: 20px;
-        margin-top: 30px;
-        padding-bottom: 10px;
-        border-bottom: 1px;
-        border-color: #737373;
-        border-style: solid
-    }
-
-    h3 {
-        font-size: 1.85rem;
-        font-weight: 500;
-        color: #404040;
-        letter-spacing: 1px;
-        margin-bottom: 20px;
-        margin-top: 30px
-    }
-
-    h4 {
-        font-size: 1.85rem;
-        font-weight: 500;
-        margin: 30px 0 20px;
-        color: #404040
-    }
-
-    em {
-        font-style: italic
-    }
-
-    strong {
-        font-weight: bold
-    }
-
-    blockquote {
-        display: block;
-        margin: 1em 3em;
-        background-color: #f8f8f8
-    }
-
-	section {
-		padding-left: 2em;
-	}
-
-	code {
-		color: red;
-	}
-
-	.deprecated {
-		background: silver;
-	}
-
-	.experimental {
-		background: yellow;
-	}
-</style>
-
-</head>
-<body>
+---
+title: v1alpha2
+layout: protoc-gen-docs
+generator: protoc-gen-docs
+number_of_entries: 51
+---
 <h2 id="AutoInjectionFeatureSpec">AutoInjectionFeatureSpec</h2>
 <section>
 <p>Configuration options for auto injection feature.</p>
@@ -2215,5 +2052,3 @@ <h2 id="k8sObjectOverlay-PathValue">k8sObjectOverlay.PathValue</h2>
 </tbody>
 </table>
 </section>
-</body>
-</html>