Question about documentation.

[Igor-san]

Question about documentation.
Hi guys! Is this example (https://nicegui.io/documentation/page#modularize_with_apirouter) intended to be like this or is there some missing code? Like this:

def api_router_demo():
    # from nicegui import APIRouter, app
    #
    # router = APIRouter(prefix='/sub-path')
    #
    # @router.page('/')
    # def page():
    #     ui.label('This is content on /sub-path')
    #
    # @router.page('/sub-sub-path')
    # def page():
    #     ui.label('This is content on /sub-path/sub-sub-path')
    #
    # ui.link('Visit sub-path', '/sub-path')
    # ui.link('Visit sub-sub-path', '/sub-path/sub-sub-path')
    #
    # app.include_router(router)
    # END OF DEMO
    ui.label('Shows up on /sub-path')

from nicegui import APIRouter, app

router = APIRouter(prefix='/sub-path')

@router.page('/')
def page():
    ui.label('This is content on /sub-path')

@router.page('/sub-sub-path')
def page():
    ui.label('This is content on /sub-path/sub-sub-path')

ui.link('Visit sub-path', '/sub-path')
ui.link('Visit sub-sub-path', '/sub-path/sub-sub-path')

app.include_router(router)

nicegui/website/documentation/content/page_documentation.py

Line 92 in 134c330

def api_router_demo():

[evnchn]

The content of the function is not copied verbatim into the documentation website. Instead, a complex extraction process happens.

https://github.com/zauberzeug/nicegui/blob/134c3308bcd0c8dd7d1d5e932b637f32f3dcbc12/website/documentation/code_extraction.py

In this case, commented code => displayed code.

[Igor-san]

But now it is displayed like this:

And I think it should be like this:

[evnchn]

I think the point of the demo written like this, is so we don't run APIRouter on the NiceGUI documentation website, and we ask whoever to want to see the demo to run it themselves.

In a sense, https://nicegui.io/sub-path leads to 404, so does https://nicegui.io/sub-path/sub-sub-path

[falkoschindler]

@evnchn You're right. The tab title "/sub-path" indicates that this should be the result when visiting /sub-path.
Actually, the label should be "This is content on /sub-path". I fixed it in 786d568.