773304 - KumaScript: Add page.subpages() to get a list of sub pages of a page

Status: RESOLVED DUPLICATE of bug 810019

(developer.mozilla.org Graveyard :: Editing, defect, P1)

Description

[Florian Scholz (Open Web Docs)]

In some docs we want to be able to get a list of all sub pages of a page. (e.g. to build our own TOC for a set of docs). In Deki there is an API (page.subpages) for that, I think we don't have it in KumaScript yet.

Template:
https://developer-new.mozilla.org/en-US/docs/Template:ListSubpages

For example, we want to list all project sub pages here: 
https://developer-new.mozilla.org/en-US/docs/Project:en

Not a launch priority at all, imo.

Comment 1

[Florian Scholz (Open Web Docs)]

Marking this as DUPE of bug 775527 since we got more thoughts over there already.

Comment 2

[Eric Shepherd [:sheppy]]

This is actually not quite a dupe; this gets a tree of subpages as JSON or other data structure you can manipulate in code; wiki.tree() just dumps a <ul> block of text of the pages as links.

Comment 3

[Jeremie Patonnier :Jeremie]

The following templates currently need this feature :

https://developer-new.mozilla.org/en-US/docs/Template:ListSubpages
https://developer-new.mozilla.org/en-US/docs/Template:subpagesSummary

Comment 4

[Les Orchard [:lorchard]]

Hmm, I think we're confused... if this isn't a dupe of bug 775527, it is at least dependent upon it.

Comment 5

[Eric Shepherd [:sheppy]]

These are not the same things. One returns a data structure you can parse that contains a list of the subpages; on MindTouch, this was a tree implemented using a Map, IIRC. That's what the page.subpages() method does on MindTouch.

Wiki.tree(), on the other hand, simply returns an HTML <ol> block containing a nested list of all the subpages as links, for embedding into pages. This lets us very easily create quick and dirty temporary landing pages, for example, by simply saying {{wiki.tree()}} to get a list of all subpages of the current page, or {{wiki.tree("some/page/path", depth)}} or whatever.

You should compare these two in the MindTouch docs.

Comment 6

[John Karahalis [:openjck]]

Removing the s= tag to work around Scrumbugs issue 99:

https://github.com/mozilla/scrumbugz/issues/99

Comment 7

[John Karahalis [:openjck]]

Doing a little bug reorganization here. This bug is superseded by bug 810019, which we are working on now.