Skip to content

Commit 189807e

Browse files
jcheng5cpsievert
authored andcommitted
Create two different api doc folders, one for Core and one for Express
1 parent 39bcfdd commit 189807e

File tree

4 files changed

+323
-17
lines changed

4 files changed

+323
-17
lines changed

docs/Makefile

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,8 @@ quartodoc: $(PYBIN) ## Build qmd files for API docs
5151
$(eval export IN_QUARTODOC=true)
5252
. $(PYBIN)/activate \
5353
&& quartodoc interlinks \
54-
&& quartodoc build --config _quartodoc.yml --verbose
54+
&& quartodoc build --config _quartodoc-core.yml --verbose \
55+
&& quartodoc build --config _quartodoc-express.yml --verbose
5556

5657
site: ## Build website
5758
. $(PYBIN)/activate \

docs/_quarto.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,10 @@ website:
1818
pinned: true
1919
search: true
2020
left:
21-
- text: "API"
22-
file: api/index.qmd
21+
- text: "API (Express)"
22+
file: api-express/index.qmd
23+
- text: "API (Core)"
24+
file: api-core/index.qmd
2325
right:
2426
- icon: github
2527
href: https://github.com/posit-dev/py-shiny

docs/_quartodoc-core.yml

Lines changed: 315 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,315 @@
1+
quartodoc:
2+
style: pkgdown
3+
dir: api/core
4+
out_index: index.qmd
5+
package: shiny
6+
rewrite_all_pages: false
7+
sidebar: api/core/_sidebar.yml
8+
dynamic: true
9+
renderer:
10+
style: _renderer.py
11+
show_signature_annotations: false
12+
sections:
13+
- title: Page containers
14+
desc: Create a user interface page container.
15+
contents:
16+
- ui.page_sidebar
17+
- ui.page_navbar
18+
- ui.page_sidebar
19+
- ui.page_fillable
20+
- ui.page_fluid
21+
- ui.page_fixed
22+
- ui.page_bootstrap
23+
- ui.page_auto
24+
- ui.page_output
25+
- title: UI Layouts
26+
desc: Control the layout of multiple UI components.
27+
contents:
28+
- ui.sidebar
29+
- ui.layout_sidebar
30+
- ui.layout_columns
31+
- ui.layout_column_wrap
32+
- ui.card
33+
- ui.card_header
34+
- ui.card_footer
35+
- ui.popover
36+
- ui.tooltip
37+
- ui.accordion
38+
- ui.accordion_panel
39+
- ui.column
40+
- ui.row
41+
- title: UI Inputs
42+
desc: Create UI that prompts the user for input values or interaction.
43+
contents:
44+
- ui.input_select
45+
- ui.input_selectize
46+
- ui.input_slider
47+
- ui.input_date
48+
- ui.input_date_range
49+
- ui.input_checkbox
50+
- ui.input_checkbox_group
51+
- ui.input_switch
52+
- ui.input_radio_buttons
53+
- ui.input_numeric
54+
- ui.input_text
55+
- ui.input_text_area
56+
- ui.input_password
57+
- ui.input_action_button
58+
- ui.input_action_link
59+
- title: Value boxes
60+
desc: Prominently display a value and label in a box that can be expanded to show more information.
61+
contents:
62+
- ui.value_box
63+
- ui.value_box_theme
64+
- ui.showcase_bottom
65+
- ui.showcase_left_center
66+
- ui.showcase_top_right
67+
- title: Navigation (tab) panels
68+
desc: Create segments of UI content.
69+
contents:
70+
- ui.nav_panel
71+
- ui.nav_spacer
72+
- ui.nav_menu
73+
- ui.nav_control
74+
- ui.navset_bar
75+
- ui.navset_tab
76+
- ui.navset_pill
77+
- ui.navset_underline
78+
- ui.navset_card_tab
79+
- ui.navset_card_pill
80+
- ui.navset_card_underline
81+
- ui.navset_pill_list
82+
- ui.navset_hidden
83+
- title: UI panels
84+
desc: Visually group together a section of UI components.
85+
contents:
86+
- ui.panel_absolute
87+
- ui.panel_fixed
88+
- ui.panel_conditional
89+
- ui.panel_title
90+
- ui.panel_well
91+
- title: Uploads & downloads
92+
desc: Allow users to upload and download files.
93+
contents:
94+
- ui.input_file
95+
- ui.download_button
96+
- title: Custom UI
97+
desc: Lower-level UI functions for creating custom HTML/CSS/JS
98+
contents:
99+
- ui.HTML # uses justattributes.rst template
100+
- ui.TagList # uses class.rst template
101+
- name: ui.tags # uses tags.rst template
102+
children: embedded
103+
- ui.markdown
104+
- ui.include_css
105+
- ui.include_js
106+
- ui.insert_ui
107+
- ui.remove_ui
108+
- ui.fill.as_fillable_container
109+
- ui.fill.as_fill_item
110+
- ui.fill.remove_all_fill
111+
# - ui.fill.is_fillable_container
112+
# - ui.fill.is_fill_item
113+
- ui.css.as_css_unit
114+
- ui.css.as_css_padding
115+
- title: Update inputs
116+
desc: Programmatically update input values.
117+
contents:
118+
- name: ui.update_select
119+
dynamic: true
120+
- name: ui.update_selectize
121+
dynamic: true
122+
- name: ui.update_slider
123+
dynamic: true
124+
- ui.update_date
125+
- name: ui.update_date_range
126+
dynamic: true
127+
- name: ui.update_checkbox
128+
dynamic: true
129+
- name: ui.update_checkbox_group
130+
dynamic: true
131+
- name: ui.update_switch
132+
dynamic: true
133+
- name: ui.update_radio_buttons
134+
dynamic: true
135+
- name: ui.update_numeric
136+
dynamic: true
137+
- ui.update_text
138+
- name: ui.update_text_area
139+
dynamic: "shiny.ui.update_text"
140+
- name: ui.update_navs
141+
dynamic: true
142+
- title: Update UI Layouts
143+
desc: ""
144+
contents:
145+
- ui.update_sidebar
146+
- ui.update_tooltip
147+
- ui.update_popover
148+
- ui.update_accordion
149+
- ui.update_accordion_panel
150+
- ui.insert_accordion_panel
151+
- ui.remove_accordion_panel
152+
- title: Rendering outputs
153+
desc: "UI (output_*()) and server (render)ing functions for generating content server-side."
154+
contents:
155+
- ui.output_plot
156+
- ui.output_image
157+
- ui.output_table
158+
- ui.output_data_frame
159+
- ui.output_text
160+
- ui.output_code
161+
- ui.output_text_verbatim
162+
- ui.output_ui
163+
- render.plot
164+
- render.image
165+
- render.table
166+
- render.text
167+
- render.ui
168+
- render.data_frame
169+
- render.DataGrid
170+
- render.DataTable
171+
- kind: page
172+
path: Renderer
173+
flatten: true
174+
summary:
175+
name: "Create output renderers"
176+
desc: "Package author methods for creating new output renderers."
177+
contents:
178+
- render.renderer.Renderer
179+
- name: render.renderer.Jsonifiable
180+
dynamic: false
181+
- name: render.renderer.ValueFn
182+
dynamic: false
183+
- name: render.renderer.AsyncValueFn
184+
dynamic: false
185+
- name: render.renderer.RendererT
186+
dynamic: false
187+
- title: Reactive programming
188+
desc: ""
189+
contents:
190+
- reactive.calc
191+
- reactive.effect
192+
- reactive.value
193+
- reactive.Calc
194+
- reactive.Effect
195+
- reactive.Value
196+
- reactive.event
197+
- reactive.isolate
198+
- reactive.invalidate_later
199+
- reactive.flush
200+
- reactive.poll
201+
- reactive.file_reader
202+
- reactive.lock
203+
- req
204+
- title: Create and run applications
205+
desc: ""
206+
contents:
207+
- run_app
208+
# uses class.rst template
209+
- App
210+
- Inputs
211+
- Outputs
212+
- Session
213+
- title: Display messages
214+
desc: ""
215+
contents:
216+
- ui.help_text
217+
- ui.notification_show
218+
- ui.notification_remove
219+
- ui.modal
220+
- ui.modal_show
221+
- ui.modal_remove
222+
- ui.modal_button
223+
- ui.Progress # uses class.rst
224+
- title: Modules
225+
desc: ""
226+
contents:
227+
# uses class.rst template
228+
- module.ui
229+
- module.server
230+
- title: Developer facing tools
231+
desc: ""
232+
contents:
233+
- session.get_current_session
234+
- session.require_active_session
235+
- session.session_context
236+
- reactive.get_current_context
237+
- name: input_handler.input_handlers
238+
dynamic: true
239+
- title: Types
240+
desc: ""
241+
contents:
242+
- kind: page
243+
path: MiscTypes
244+
flatten: true
245+
summary:
246+
name: "Miscellaneous types"
247+
desc: ""
248+
contents:
249+
- types.MISSING_TYPE
250+
- types.MISSING
251+
- types.FileInfo
252+
- types.ImgData
253+
- types.NavSetArg
254+
- ui.Sidebar
255+
- ui.CardItem
256+
- ui.AccordionPanel
257+
- name: ui.css.CssUnit
258+
dynamic: false
259+
- ui._input_slider.SliderValueArg
260+
- ui._input_slider.SliderStepArg
261+
- kind: page
262+
path: TagTypes
263+
summary:
264+
name: "Tag types"
265+
desc: ""
266+
flatten: true
267+
package: null
268+
contents:
269+
- name: htmltools.Tag
270+
dynamic: false
271+
- name: htmltools.TagAttrs
272+
dynamic: false
273+
- name: htmltools.TagAttrValue
274+
dynamic: false
275+
- name: htmltools.TagChild
276+
dynamic: false
277+
- name: htmltools.TagList
278+
dynamic: false
279+
- kind: page
280+
path: ExceptionTypes
281+
summary:
282+
name: "Exception types"
283+
desc: ""
284+
flatten: true
285+
contents:
286+
- types.SilentException
287+
- types.SilentCancelOutputException
288+
- types.SafeException
289+
- title: Deprecated
290+
desc: ""
291+
contents:
292+
- ui.panel_main
293+
- ui.panel_sidebar
294+
- ui.nav
295+
- render.transformer.resolve_value_fn
296+
- title: Experimental
297+
desc: "These methods are under consideration and are considered unstable. However, if there is a method you are excited about, please let us know!"
298+
contents:
299+
- kind: page
300+
path: ExCard
301+
summary:
302+
name: "Card"
303+
desc: "Cards are a common organizing unit for modern user interfaces (UI). At their core, they're just rectangular containers with borders and padding. However, when utilized properly to group related information, they help users better digest, engage, and navigate through content."
304+
flatten: true
305+
contents:
306+
- name: experimental.ui.card_body
307+
dynamic: false
308+
- name: experimental.ui.card_title
309+
dynamic: false
310+
- name: experimental.ui.card_image
311+
dynamic: false
312+
- name: experimental.ui.ImgContainer
313+
dynamic: false
314+
- name: experimental.ui.WrapperCallable
315+
dynamic: false

docs/_quartodoc.yml renamed to docs/_quartodoc-express.yml

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,15 @@
11
quartodoc:
22
style: pkgdown
3-
dir: api
3+
dir: api/express
44
out_index: index.qmd
55
package: shiny
66
rewrite_all_pages: false
7-
sidebar: api/_sidebar.yml
7+
sidebar: api/express/_sidebar.yml
88
dynamic: true
99
renderer:
1010
style: _renderer.py
1111
show_signature_annotations: false
1212
sections:
13-
- title: Page containers
14-
desc: Create a user interface page container.
15-
contents:
16-
- ui.page_sidebar
17-
- ui.page_navbar
18-
- ui.page_sidebar
19-
- ui.page_fillable
20-
- ui.page_fluid
21-
- ui.page_fixed
22-
- ui.page_bootstrap
23-
- ui.page_auto
24-
- ui.page_output
2513
- title: UI Layouts
2614
desc: Control the layout of multiple UI components.
2715
contents:

0 commit comments

Comments
 (0)