8000 Adding docs that will build via Github Pages (#100) · onware/document-api-python@ceb17d3 · GitHub
[go: up one dir, main page]

Skip to content

Commit ceb17d3

Browse files
authored
Adding docs that will build via Github Pages (tableau#100)
* Jekyll Dependencies * First draft of docs -- we'll improve once skeleton is in place * Does not deploy yet, need to do that in github settings page
1 parent d55f126 commit ceb17d3

24 files changed

+1826
-55
lines changed

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,3 +64,6 @@ target/
6464
#Other things
6565
.DS_Store
6666
.idea
67+
68+
#Jekyll
69+
docs/_site

.travis.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
language: python
2+
cache: pip
3+
24
python:
35
- "2.7"
46
- "3.3"

contributing.md

Lines changed: 0 additions & 55 deletions
This file was deleted.

contributing.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
docs/docs/contributing.md

docs/Gemfile

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
source 'https://rubygems.org'
2+
gem 'github-pages', group: :jekyll_plugins
3+

docs/Gemfile.lock

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
GEM
2+
remote: https://rubygems.org/
3+
specs:
4+
activesupport (4.2.6)
5+
i18n (~> 0.7)
6+
json (~> 1.7, >= 1.7.7)
7+
minitest (~> 5.1)
8+
thread_safe (~> 0.3, >= 0.3.4)
9+
tzinfo (~> 1.1)
10+
addressable (2.4.0)
11+
coffee-script (2.4.1)
12+
coffee-script-source
13+
execjs
14+
coffee-script-source (1.10.0)
15+
colorator (0.1)
16+
ethon (0.9.0)
17+
ffi (>= 1.3.0)
18+
execjs (2.7.0)
19+
faraday (0.9.2)
20+
multipart-post (>= 1.2, < 3)
21+
ffi (1.9.10)
22+
ffi (1.9.10-x86-mingw32)
23+
gemoji (2.1.0)
24+
github-pages (80)
25+
github-pages-health-check (= 1.1.0)
26+
jekyll (= 3.1.6)
27+
jekyll-coffeescript (= 1.0.1)
28+
jekyll-feed (= 0.5.1)
29+
jekyll-gist (= 1.4.0)
30+
jekyll-github-metadata (= 1.11.1)
31+
jekyll-mentions (= 1.1.2)
32+
jekyll-paginate (= 1.1.0)
33+
jekyll-redirect-from (= 0.10.0)
34+
jekyll-sass-converter (= 1.3.0)
35+
jekyll-seo-tag (= 1.4.0)
36+
jekyll-sitemap (= 0.10.0)
37+
jemoji (= 0.6.2)
38+
kramdown (= 1.10.0)
39+
liquid (= 3.0.6)
40+
listen (= 3.0.6)
41+
mercenary (~> 0.3)
42+
rouge (= 1.10.1)
43+
terminal-table (~> 1.4)
44+
github-pages-health-check (1.1.0)
45+
addressable (~> 2.3)
46+
net-dns (~> 0.8)
47+
octokit (~> 4.0)
48+
public_suffix (~> 1.4)
49+
typhoeus (~> 0.7)
50+
html-pipeline (2.4.1)
51+
activesupport (>= 2, < 5)
52+
nokogiri (>= 1.4)
53+
i18n (0.7.0)
54+
jekyll (3.1.6)
55+
colorator (~> 0.1)
56+
jekyll-sass-converter (~> 1.0)
57+
jekyll-watch (~> 1.1)
58+
kramdown (~> 1.3)
59+
liq 10000 uid (~> 3.0)
60+
mercenary (~> 0.3.3)
61+
rouge (~> 1.7)
62+
safe_yaml (~> 1.0)
63+
jekyll-coffeescript (1.0.1)
64+
coffee-script (~> 2.2)
65+
jekyll-feed (0.5.1)
66+
jekyll-gist (1.4.0)
67+
octokit (~> 4.2)
68+
jekyll-github-metadata (1.11.1)
69+
octokit (~> 4.0)
70+
jekyll-mentions (1.1.2)
71+
html-pipeline (~> 2.3)
72+
jekyll (~> 3.0)
73+
jekyll-paginate (1.1.0)
74+
jekyll-redirect-from (0.10.0)
75+
jekyll (>= 2.0)
76+
jekyll-sass-converter (1.3.0)
77+
sass (~> 3.2)
78+
jekyll-seo-tag (1.4.0)
79+
jekyll (~> 3.0)
80+
jekyll-sitemap (0.10.0)
81+
jekyll-watch (1.4.0)
82+
listen (~> 3.0, < 3.1)
83+
jemoji (0.6.2)
84+
gemoji (~> 2.0)
85+
html-pipeline (~> 2.2)
86+
jekyll (>= 3.0)
87+
json (1.8.3)
88+
kramdown (1.10.0)
89+
liquid (3.0.6)
90+
listen (3.0.6)
91+
rb-fsevent (>= 0.9.3)
92+
rb-inotify (>= 0.9.7)
93+
mercenary (0.3.6)
94+
mini_portile2 (2.0.0)
95+
minitest (5.9.0)
96+
multipart-post (2.0.0)
97+
net-dns (0.8.0)
98+
nokogiri (1.6.7.2)
99+
mini_portile2 (~> 2.0.0.rc2)
100+
nokogiri (1.6.7.2-x86-mingw32)
101+
mini_portile2 (~> 2.0.0.rc2)
102+
octokit (4.3.0)
103+
sawyer (~> 0.7.0, >= 0.5.3)
104+
public_suffix (1.5.3)
105+
rb-fsevent (0.9.7)
106+
rb-inotify (0.9.7)
107+
ffi (>= 0.5.0)
108+
rouge (1.10.1)
109+
safe_yaml (1.0.4)
110+
sass (3.4.22)
111+
sawyer (0.7.0)
112+
addressable (>= 2.3.5, < 2.5)
113+
faraday (~> 0.8, < 0.10)
114+
terminal-table (1.5.2)
115+
thread_safe (0.3.5)
116+
typhoeus (0.8.0)
117+
ethon (>= 0.8.0)
118+
tzinfo (1.2.2)
119+
thread_safe (~> 0.1)
120+
121+
PLATFORMS
122+
ruby
123+
x86-mingw32
124+
125+
DEPENDENCIES
126+
github-pages
127+
128+
BUNDLED WITH
129+
1.12.5

docs/_config.yml

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Site settings
2+
title: Tableau Document API
3+
email: jdominguez@tableau.com
4+
description: Programmatically update your Tableau workbooks and data sources.
5+
baseurl: "/document-api-python"
6+
permalinks: pretty
7+
defaults:
8+
-
9+
scope:
10+
path: "" # Apply to all files
11+
values:
12+
layout: "default"
13+
14+
# Build settings
15+
markdown: kramdown
16+
highlighter: rouge
17+

docs/_includes/docs_menu.html

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
<div class="well docs-menu col-xs-12 col-sm-4 col-md-3">
2+
<ul class="nav nav-list">
3+
<li>
4+
<a href="{{ site.baseurl }}/docs">Get Started</a>
5+
</li>
6+
<li>
7+
<a href="{{ site.baseurl }}/docs/api-ref">API Reference</a>
8+
</li>
9+
<li>
10+
<a href="{{ site.baseurl }}/docs/dev-guide">Developer Guide</a>
11+
</li>
12+
<li>
13+
<a href="{{ site.baseurl }}/docs/contributing">Contributing</a>
14+
</li>
15+
</ul>
16+
</div>

docs/_includes/footer.html

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<!-- Footer -->
2+
<footer>
3+
<div class="row">
4+
<hr class="footer-hr">
5+
<p>This site is open source. Suggestions and pull requests are welcome on our <a href="https://github.com/tableau/document-api-python">GitHub page</a>.</p>
6+
<p>(c) Copyright 2016 Tableau</p>
7+
</div>
8+
</footer>

docs/_includes/head.html

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
<meta charset="utf-8">
2+
<meta http-equiv="X-UA-Compatible" content="IE=edge">
3+
<meta name="viewport" content="width=device-width, initial-scale=1">
4+
5+
<title>{% if page.title %}{{ page.title | escape }}{% else %}{{ site.title | escape }}{% endif %}</title>
6+
<meta name="description" content="{% if page.excerpt %}{{ page.excerpt | strip_html | strip_newlines | truncate: 160 }}{% else %}{{ site.description }}{% endif %}">
7+
8+
<link rel="shortcut icon" type="image/png" href="{{ site.baseurl }}/assets/logo.png">
9+
10+
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css">
11+
<link rel="stylesheet" href="{{ site.baseurl }}/css/main.css">
12+
<link rel="stylesheet" href="{{ site.baseurl }}/css/github-highlight.css">
13+
14+
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min.js"></script>
15+
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>

docs/_includes/header.html

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
<header class="site-header">
2+
<div class="wrapper">
3+
<nav class="navbar navbar-default navbar-fixed-top">
4+
<div class="container">
5+
<div class="navbar-header">
6+
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
7+
<span class="sr-only">Toggle navigation</span>
8+
<span class="icon-bar"></span>
9+
<span class="icon-bar"></span>
10+
<span class="icon-bar"></span>
11+
</button>
12+
<a class="navbar-brand navbar-brand-logo" href="{{ site.baseurl }}/#">Tableau Document API Python</a>
13+
</div>
14+
<div id="navbar" class="navbar-collapse collapse">
15+
<ul class="nav navbar-nav">
16+
<li><a href="{{ site.baseurl }}/docs/">Docs</a></li>
17+
<li><a href="{{ site.baseurl }}/docs/api-ref">API Reference</a></li>
18+
<li><a target="_blank" href="https://community.tableau.com/community/developers/content">Forum</a></li>
19+
<!-- <li><a href="{{ site.baseurl }}/news/">What's New?</a></li> -->
20+
</ul>
21+
<ul class="nav navbar-nav navbar-right">
22+
<li class="tableauIcon"><a target="_blank" href="http://tableau.com"><img src="{{ site.baseurl }}/assets/logo.png" alt="Tableau Developers" class="logo" /></a></li>
23+
<li><a target="_blank" href="https://github.com/tableau/document-api-python"><span class="icon icon--github" title="Document API on GitHub" alt="Document API on GitHub">{% include icon-github.svg %}</span></a></li>
24+
</ul>
25+
</div>
26+
</div>
27+
</nav>
28+
</div>
29+
</header>

docs/_includes/icon-github.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/_layouts/default.html

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
<!DOCTYPE html>
2+
<html>
3+
4+
<head>
5+
{% include head.html %}
6+
</head>
7+
8+
<body>
9+
<div class="container">
10+
{% include header.html %}
11+
<ul class="blogul">
12+
{% for post in site.posts %}
13+
<div class="row">
14+
<h1>{{ post.title }}</h1>
15+
<hr>
16+
<p><span class="glyphicon glyphicon-time"></span> Posted on {{ post.date | date: "%-d %B %Y" }}</p>
17+
<hr>
18+
<p class="lead">
19+
{{ post.abstract }}
20+
</p>
21+
{% if post.photoname %}
22+
<img class="img-responsive" src="{{ site.baseurl }}/assets/{{ post.photoname}}" alt=""> {% endif %}
23+
<hr>
24+
<div class="blog-content">
25+
{{ post.content }}
26+
</div>
27+
</div>
28+
{% endfor %}
29+
</ul>
30+
{% include footer.html %}
31+
</div>
32+
</body>
33+
34+
</html>

docs/_layouts/docs.html

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
layout: docs
3+
---
4+
5+
<!DOCTYPE html>
6+
<html>
7+
8+
<head>
9+
{% include head.html %}
10+
</head>
11+
12+
<body>
13+
<div class="container">
14+
{% include header.html %}
15+
{% include docs_menu.html %}
16+
17+
<div class="content .col-xs-12 .col-sm-8 .col-md-9">
18+
<h1>{{ page.title }}</h1>
19+
<div class="edit-container">
20+
<a href="https://github.com/tableau/document-api-python/edit/master/{{ page.path }}" class="edit-links"><span class="glyphicon glyphicon-pencil"></span> Edit this page</a>
21+
&nbsp;
22+
<a href="https://github.com/tableau/document-api-python/issues" class="edit-links"><span class="glyphicon glyphicon-flag"></span> Submit an issue</a>
23+
</div>
24+
<br />
25+
{{ content }}
26+
{% include footer.html %}
27+
</div>
28+
</div>
29+
</body>
30+
31+
</html>

docs/_layouts/home.html

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
layout: home
3+
---
4+
<!DOCTYPE html>
5+
<html>
6+
7+
<head>
8+
{% include head.html %}
9+
</head>
10+
11+
<body>
12+
<div class="container">
13+
{% include header.html %}
14+
{{ content }}
15+
{% include footer.html %}
16+
</div>
17+
</body>
18+
19+
</html>

docs/assets/logo.png

2.73 KB
Loading

0 commit comments

Comments
 (0)
0