mirror of https://github.com/istio/istio.io.git
New format for FAQ, allowing for deep links to answers and making it easier to browse. (#1013)
This commit is contained in:
Martin Taillefer
GitHub
parent
fd5d4a2cb2
commit
e42f7ed9ba
22
_help/faq.md
22
_help/faq.md
|
|
@ -1,22 +0,0 @@
|
|||
---
|
||||
title: Frequently Asked Questions
|
||||
overview: Frequently Asked Questions about Istio.
|
||||
|
||||
order: 20
|
||||
|
||||
layout: help
|
||||
type: markdown
|
||||
redirect_from:
|
||||
- "/faq"
|
||||
- "/docs/welcome/faq.html"
|
||||
toc: false
|
||||
---
|
||||
{% include home.html %}
|
||||
|
||||
Here are some frequently asked questions about Istio.
|
||||
|
||||
{% include faq.html
|
||||
faq_pages = site.faq
|
||||
faq_category_dirs = 'general,setup,security,mixer,traffic-management'
|
||||
faq_category_names = 'General,Setup,Security,Mixer,Traffic Management'
|
||||
%}
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
title: General
|
||||
overview: General Q&A
|
||||
|
||||
order: 10
|
||||
|
||||
layout: help
|
||||
---
|
||||
{% include faq.html category='general' %}
|
||||
|
|
@ -0,0 +1,50 @@
|
|||
---
|
||||
title: FAQ
|
||||
overview: Frequently Asked Questions about Istio.
|
||||
|
||||
order: 20
|
||||
|
||||
layout: help
|
||||
type: markdown
|
||||
toc: false
|
||||
|
||||
redirect_from:
|
||||
- "/faq"
|
||||
- "/docs/welcome/faq.html"
|
||||
---
|
||||
{% include home.html %}
|
||||
|
||||
You've got questions? We've got answers!
|
||||
|
||||
<div class="faq">
|
||||
<div class="row">
|
||||
{% assign category_dirs = 'general,setup,security,mixer,traffic-management' %}
|
||||
{% assign category_names = 'General,Setup,Security,Mixer,Traffic Management' %}
|
||||
{% assign category_dirs = category_dirs | split: ',' %}
|
||||
{% assign category_names = category_names | split: ',' %}
|
||||
|
||||
{% assign faqs = site.faq | sort: "order" %}
|
||||
|
||||
{% for cat in category_dirs %}
|
||||
<div class="col-sm-6">
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
{{category_names[forloop.index0]}}
|
||||
</div>
|
||||
|
||||
<div class="card-body">
|
||||
{% for q in faqs %}
|
||||
{% assign comp = q.path | split: '/' %}
|
||||
{% assign qcat = comp[1] %}
|
||||
{% if cat == qcat %}
|
||||
{% assign name = q.path | downcase | split: '/' | last | remove: ".md" %}
|
||||
|
||||
<a href="{{qcat}}#{{name}}">{{q.title}}</a><br/>
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
title: Mixer
|
||||
overview: Mixer Q&A
|
||||
|
||||
order: 40
|
||||
|
||||
layout: help
|
||||
---
|
||||
{% include faq.html category='mixer' %}
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
title: Security
|
||||
overview: Security Q&A
|
||||
|
||||
order: 30
|
||||
|
||||
layout: help
|
||||
---
|
||||
{% include faq.html category='security' %}
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
title: Setup
|
||||
overview: Setup Q&A
|
||||
|
||||
order: 20
|
||||
|
||||
layout: help
|
||||
---
|
||||
{% include faq.html category='setup' %}
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
title: Traffic Management
|
||||
overview: Traffic Management Q&A
|
||||
|
||||
order: 50
|
||||
|
||||
layout: help
|
||||
---
|
||||
{% include faq.html category='traffic-management' %}
|
||||
|
|
@ -229,7 +229,7 @@ or [manual]({{home}}/docs/setup/kubernetes/sidecar-injection.html#manual-sidecar
|
|||
Look for errors related to your configuration or your service in the
|
||||
returned logs.
|
||||
|
||||
More on viewing Mixer configuration can be found [here]({{home}}/help/faq.html#mixer-self-monitoring)
|
||||
More on viewing Mixer configuration can be found [here]({{home}}/help/faq/mixer.html#mixer-self-monitoring)
|
||||
|
||||
### Verify Mixer is sending metric instances to the Prometheus adapter
|
||||
|
||||
|
|
|
|||
|
|
@ -1,68 +1,12 @@
|
|||
{% include home.html %}
|
||||
|
||||
<div class="container-fluid faq">
|
||||
<div class="row">
|
||||
{% assign faqs = site.faq | sort: "order" %}
|
||||
{% for q in faqs %}
|
||||
{% assign comp = q.path | split: '/' %}
|
||||
{% assign qcat = comp[1] %}
|
||||
{% if qcat == include.category %}
|
||||
{% assign name = q.path | downcase | split: '/' | last | remove: ".md" %}
|
||||
|
||||
{% assign category_dirs = include.faq_category_dirs | split: ',' %}
|
||||
{% assign category_names = include.faq_category_names | split: ',' %}
|
||||
|
||||
<div class="col-12 col-md-3 col-xl-2">
|
||||
<div class="list-group" role="tablist">
|
||||
{% assign cats = category_dirs %}
|
||||
{% for cat in cats %}
|
||||
{% assign active = "" %}
|
||||
{% if forloop.index == 1 %}
|
||||
{% assign active = "active" %}
|
||||
{% endif %}
|
||||
|
||||
<a class="list-group-item list-group-item-action {{active}}" data-toggle="list" role="tab" href="#tab{{forloop.index}}">
|
||||
{{category_names[forloop.index0]}}
|
||||
</a>
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="col-12 col-md-9 col-xl-10">
|
||||
<div class="tab-content">
|
||||
|
||||
{% assign cats = category_dirs %}
|
||||
{% for cat in cats %}
|
||||
{% assign catIndex = forloop.index %}
|
||||
|
||||
{% assign active = "" %}
|
||||
{% if catIndex == 1 %}
|
||||
{% assign active = "active" %}
|
||||
{% endif %}
|
||||
|
||||
<div class="tab-pane {{active}}" id="tab{{catIndex}}" role="tabpanel">
|
||||
|
||||
{% assign faqs = include.faq_pages | sort: "order" %}
|
||||
{% for q in faqs %}
|
||||
{% assign comp = q.path | split: '/' %}
|
||||
{% assign qcat = comp[1] %}
|
||||
{% if cat == qcat %}
|
||||
{% assign name = q.path | downcase | split: '/' | last | remove: ".md" %}
|
||||
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
<a data-toggle="collapse" href="#{{name}}">
|
||||
<div>
|
||||
{{q.title}}
|
||||
</div>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div id="{{name}}" class="collapse" data-parent="#tab{{catIndex}}">
|
||||
<div class="card-body">
|
||||
{{q.content}}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<h4 id="{{name}}">Q: {{q.title}}</h4>
|
||||
{{q.content}}
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@
|
|||
<nav class="col-12 col-sm-3" role="navigation">
|
||||
<ul>
|
||||
<li><a class="header" href="{{home}}/help">Help</a></li>
|
||||
<li><a href="{{home}}/help/faq.html">FAQ</a></li>
|
||||
<li><a href="{{home}}/help/faq/index.html">FAQ</a></li>
|
||||
<li><a href="{{home}}/help/glossary.html">Glossary</a></li>
|
||||
<li><a href="{{home}}/help/troubleshooting.html">Troubleshooting</a></li>
|
||||
<li><a href="{{home}}/help/bugs.html">Report Bugs</a></li>
|
||||
|
|
|
|||
|
|
@ -1,5 +1,4 @@
|
|||
---
|
||||
layout: compress
|
||||
---
|
||||
{% include home.html %}
|
||||
|
||||
|
|
|
|||
|
|
@ -1,33 +1,12 @@
|
|||
.faq {
|
||||
.card {
|
||||
margin-bottom: .2em;
|
||||
border-color: $boxBorderColor;
|
||||
margin-bottom: 2em;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
.card-body {
|
||||
padding-top: 0;
|
||||
padding-bottom: 0;
|
||||
}
|
||||
|
||||
.card-header {
|
||||
padding: 0;
|
||||
|
||||
div {
|
||||
padding: .75em 1.25em;
|
||||
}
|
||||
}
|
||||
|
||||
.list-group {
|
||||
padding-bottom: 3em;
|
||||
}
|
||||
|
||||
.list-group-item {
|
||||
background-color: $backgroundColor;
|
||||
color: $textColor;
|
||||
border-color: $dividerBarColor;
|
||||
}
|
||||
|
||||
.list-group-item.active {
|
||||
background-color: $mainBrandColor;
|
||||
color: $textBrandColor;
|
||||
background-color: $boxBorderColor;
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in New Issue