Skip to content

Commit b0a3ccd

Browse files
authored
Update document structure (#75)
* modify documents structure * add docs to structure * exclude models * remove words from the directory page * sqlflow.md new line * update gitsubmodule * add grand_parent
1 parent 77b293e commit b0a3ccd

24 files changed

+287
-80
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,4 @@ Gemfile.lock
55
*~
66
.idea
77
.jekyll-metadata
8+
*.swp

.gitmodules

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,7 @@
1818
path = elasticdl
1919
url = https://github.com/sql-machine-learning/elasticdl
2020
branch = develop
21+
[submodule "models"]
22+
path = models
23+
url = https://github.com/sql-machine-learning/models
24+
branch = develop

_config.yml

Lines changed: 218 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,23 @@
1-
remote_theme: pmarsceill/just-the-docs
1+
title: 'SQLFlow'
2+
description: Bridging Data and AI
23

3-
classes: wide
4+
permalink: pretty
5+
exclude: ['*.sql', '*.go', '.gitignore', '*.sh', '*.proto', '*.y', '*.py']
46

57
search_enabled: true
8+
search_tokenizer_separator: /[\s/]+/
69

7-
title: 'SQLFlow'
8-
9-
ga_tracking: UA-17331483-8
10+
heading_anchors: true
1011

1112
aux_links:
1213
"GitHub":
1314
- "https://github.com/sql-machine-learning/sqlflow"
1415

15-
exclude: ['*.sql', '*.go', '.gitignore', '*.sh', '*.proto', '*.y']
1616

17-
# baseurl: "/sql-machine-learning.github.io/"
17+
remote_theme: pmarsceill/just-the-docs
18+
classes: wide
19+
color_scheme: nil
20+
ga_tracking: UA-17331483-8
1821

1922
defaults:
2023
- scope:
@@ -25,141 +28,293 @@ defaults:
2528
grand_parent: SQLFlow
2629
prefix: '/sqlflow/'
2730
- scope:
28-
path: "sqlflow/doc/installation.md"
31+
path: "models"
32+
values:
33+
layout: "doc"
34+
nav_exclude: true
35+
grand_parent: Models
36+
- scope:
37+
path: "elasticdl"
38+
values:
39+
layout: "doc"
40+
nav_exclude: true
41+
grand_parent: ElasticDL
42+
prefix: '/elasticdl/'
43+
- scope:
44+
path: "pysqlflow"
45+
values:
46+
layout: "doc"
47+
nav_exclude: true
48+
grand_parent: PySQLFlow
49+
prefix: '/pysqlflow/'
50+
- scope:
51+
path: "gohive"
52+
values:
53+
layout: "doc"
54+
nav_exclude: true
55+
grand_parent: GoHive
56+
prefix: '/gohive/'
57+
- scope:
58+
path: "gomaxcompute"
59+
values:
60+
layout: "doc"
61+
nav_exclude: true
62+
grand_parent: GoMaxCompute
63+
prefix: '/gomaxcompute/'
64+
- scope:
65+
path: "sqlflow/doc/run/docker.md"
66+
values:
67+
nav_exclude: false
68+
parent: Get Started
69+
nav_order: 1
70+
- scope:
71+
path: "sqlflow/doc/user_guide.md"
72+
values:
73+
nav_exclude: false
74+
parent: Get Started
75+
nav_order: 2
76+
- scope:
77+
path: "sqlflow/doc/run/repl.md"
78+
values:
79+
nav_exclude: true
80+
parent: Get Started
81+
nav_order: 3
82+
- scope:
83+
path: "sqlflow/doc/run/docker.md"
84+
values:
85+
nav_exclude: false
86+
parent: Installation
87+
nav_order: 1
88+
- scope:
89+
path: "sqlflow/doc/run/gcp.md"
2990
values:
3091
nav_exclude: false
31-
parent: SQLFlow
92+
parent: Install SQLFlow on Cloud
3293
nav_order: 1
3394
- scope:
34-
path: "sqlflow/doc/syntax.md"
95+
path: "sqlflow/doc/run/kubernetes.md"
96+
values:
97+
nav_exclude: false
98+
parent: Install SQLFlow on Cloud
99+
nav_order: 2
100+
- scope:
101+
path: "sqlflow/doc/run_with_mysql.md"
102+
values:
103+
nav_exclude: false
104+
parent: Run SQLFlow with SQL Engines
105+
nav_order: 1
106+
- scope:
107+
path: "sqlflow/doc/run_with_hive.md"
108+
values:
109+
nav_exclude: false
110+
parent: Run SQLFlow with SQL Engines
111+
nav_order: 2
112+
- scope:
113+
path: "sqlflow/doc/run_with_maxcompute.md"
114+
values:
115+
nav_exclude: false
116+
parent: Run SQLFlow with SQL Engines
117+
nav_order: 3
118+
- scope:
119+
path: "sqlflow/doc/tutorial/iris-dnn.md"
120+
values:
121+
nav_exclude: false
122+
parent: Examples
123+
nav_order: 1
124+
- scope:
125+
path: "sqlflow/doc/tutorial/imdb-stackedbilstm.md"
126+
values:
127+
nav_exclude: false
128+
parent: Examples
129+
nav_order: 2
130+
- scope:
131+
path: "sqlflow/doc/tutorial/fraud-dnn.md"
132+
values:
133+
nav_exclude: false
134+
parent: Examples
135+
nav_order: 4
136+
- scope:
137+
path: "sqlflow/doc/tutorial/housing-xgboost.md"
138+
values:
139+
nav_exclude: false
140+
parent: Examples
141+
nav_order: 5
142+
- scope:
143+
path: "sqlflow/doc/tutorial/housing-analyze.md"
144+
values:
145+
nav_exclude: false
146+
parent: Examples
147+
nav_order: 6
148+
- scope:
149+
path: "sqlflow/doc/design/design_alps_submitter.md"
35150
values:
36151
nav_exclude: false
37152
parent: Design
153+
nav_order: 1
38154
- scope:
39-
path: "sqlflow/doc/walkthrough.md"
155+
path: "sqlflow/doc/design/design_analyzer.md"
40156
values:
41157
nav_exclude: false
42158
parent: Design
159+
nav_order: 2
43160
- scope:
44-
path: "sqlflow/doc/sql_parser.md"
161+
path: "sqlflow/doc/design/design_xgboost_on_sqlflow.md"
45162
values:
46163
nav_exclude: false
47164
parent: Design
165+
nav_order: 3
48166
- scope:
49-
path: "sqlflow/doc/database_abstraction_layer.md"
167+
path: "sqlflow/doc/design/design_auth.md"
50168
values:
51169
nav_exclude: false
52170
parent: Design
171+
nav_order: 4
53172
- scope:
54-
path: "sqlflow/doc/pipe.md"
173+
path: "sqlflow/doc/design/design_clustermodel.md"
55174
values:
56175
nav_exclude: false
57176
parent: Design
177+
nav_order: 5
58178
- scope:
59-
path: "sqlflow/doc/build.md"
179+
path: "sqlflow/doc/design/design_customized_model.md"
60180
values:
61181
nav_exclude: false
62-
parent: Contribute
182+
parent: Design
183+
nav_order: 6
63184
- scope:
64-
path: "sqlflow/doc/build-tensorflow.md"
185+
path: "sqlflow/doc/design/design_elasticdl_on_sqlflow.md"
65186
values:
66187
nav_exclude: false
67-
parent: Contribute
188+
parent: Design
189+
nav_order: 7
68190
- scope:
69-
path: "sqlflow/doc/mysql-setup.md"
191+
path: "sqlflow/doc/design/design_feature_derivation.md"
70192
values:
71193
nav_exclude: false
72-
parent: Contribute
194+
parent: Design
195+
nav_order: 8
73196
- scope:
74-
path: "sqlflow/doc/close_producer_from_consumer.md"
197+
path: "sqlflow/doc/design/design_syntax.md"
75198
values:
76199
nav_exclude: false
77-
parent: Contribute
200+
parent: Design
201+
nav_order: 9
78202
- scope:
79-
path: "sqlflow/doc/submitter.md"
203+
path: "sqlflow/doc/build.md"
80204
values:
81205
nav_exclude: false
82-
parent: Contribute
206+
parent: Contributes
207+
nav_order: 1
83208
- scope:
84-
path: "pysqlflow"
209+
path: "sqlflow/doc/walkthrough.md"
85210
values:
86-
prefix: '/pysqlflow/'
211+
nav_exclude: false
212+
parent: Contributes
213+
nav_order: 2
87214
- scope:
88-
path: "pysqlflow/doc/desigin/client_design_doc.md"
215+
path: "models/doc/contribute_models.md"
89216
values:
90217
nav_exclude: false
91-
parent: PySQLFlow
218+
parent: Contributes
219+
grand_parent: SQLFlow
220+
nav_order: 3
92221
- scope:
93-
path: "pysqlflow/doc/desigin/magic_design_doc.md"
222+
path: "gohive/README.md"
94223
values:
95224
nav_exclude: false
96-
parent: PySQLFlow
225+
parent: GoHive
226+
nav_order: 1
97227
- scope:
98-
path: "gomaxcompute"
228+
path: "gohive/doc/design.md"
99229
values:
100-
layout: doc
101-
parent: GoMaxCompute
230+
nav_exclude: false
231+
parent: GoHive
232+
nav_order: 2
102233
- scope:
103-
path: "gohive"
234+
path: "gohive/docker/README.md"
104235
values:
105-
layout: doc
236+
nav_exclude: false
106237
parent: GoHive
107-
prefix: '/gohive/'
108-
109-
238+
nav_order: 3
110239
- scope:
111-
path: "elasticdl"
240+
path: "gomaxcompute/README.md"
112241
values:
113-
nav_exclude: true
114-
prefix: '/elasticdl'
242+
nav_exclude: false
243+
parent: GoMaxCompute
244+
nav_order: 1
115245
- scope:
116-
path: "elasticdl/elasticdl/doc/worker_optimization_design.md"
246+
path: "pysqlflow/doc/design/client_design_doc.md"
117247
values:
118248
nav_exclude: false
119-
parent: ElasticDL
249+
parent: PySQLFlow
250+
nav_order: 1
120251
- scope:
121-
path: "elasticdl/elasticdl/doc/odps_support_design.md"
252+
path: "pysqlflow/doc/design/magic_design_doc.md"
122253
values:
123254
nav_exclude: false
124-
parent: ElasticDL
255+
parent: PySQLFlow
256+
nav_order: 2
257+
- scope:
258+
path: "elasticdl/doc/data_preparation_design.md"
259+
values:
260+
nav_exclude: false
261+
parent: ElasticDL
262+
nav_order: 1
125263
- scope:
126-
path: "elasticdl/elasticdl/doc/model_evaluation_design.md"
264+
path: "elasticdl/doc/distributed_embedding_layer_design.md"
265+
values:
266+
nav_exclude: false
267+
parent: ElasticDL
268+
nav_order: 2
269+
- scope:
270+
path: "elasticdl/doc/tutorials/elasticdl_cloud.md"
271+
values:
272+
nav_exclude: false
273+
parent: ElasticDL
274+
nav_order: 3
275+
- scope:
276+
path: "elasticdl/doc/worker_optimization_design.md"
127277
values:
128278
nav_exclude: false
129279
parent: ElasticDL
280+
nav_order: 4
130281
- scope:
131-
path: "elasticdl/elasticdl/doc/model_building.md"
282+
path: "elasticdl/doc/odps_support_design.md"
132283
values:
133284
nav_exclude: false
134285
parent: ElasticDL
286+
nav_order: 5
135287
- scope:
136-
path: "elasticdl/elasticdl/doc/high-level-api.md"
288+
path: "elasticdl/doc/model_evaluation_design.md"
137289
values:
138290
nav_exclude: false
139291
parent: ElasticDL
292+
nav_order: 6
140293
- scope:
141-
path: "elasticdl/elasticdl/doc/elastic_sync_sgd.md"
294+
path: "elasticdl/doc/model_building.md"
142295
values:
143296
nav_exclude: false
144297
parent: ElasticDL
298+
nav_order: 7
145299
- scope:
146-
path: "elasticdl/elasticdl/doc/elastic_scheduling.md"
300+
path: "elasticdl/doc/high-level-api.md"
147301
values:
148302
nav_exclude: false
149303
parent: ElasticDL
304+
nav_order: 8
150305
- scope:
151-
path: "elasticdl/elasticdl/doc/distributed_embedding_layer_design.md"
306+
path: "elasticdl/doc/elastic_sync_sgd.md"
152307
values:
153308
nav_exclude: false
154309
parent: ElasticDL
310+
nav_order: 9
155311
- scope:
156-
path: "elasticdl/elasticdl/doc/data_preparation_design.md"
312+
path: "elasticdl/doc/elastic_scheduling.md"
157313
values:
158314
nav_exclude: false
159315
parent: ElasticDL
160-
316+
nav_order: 10
161317

162-
163318
footer:
164319
links:
165320
- label: "GitHub"
@@ -173,3 +328,12 @@ plugins:
173328
- jekyll-feed
174329
- jemoji
175330
- jekyll-include-cache
331+
- jekyll-seo-tag
332+
333+
compress_html:
334+
clippings: all
335+
comments: all
336+
endings: all
337+
startings: []
338+
blanklines: false
339+
profile: false

0 commit comments

Comments
 (0)