Separate by folder

[fulldecent]

I am using phpDocumentor on a large project, Moodle. It generates over 10GB of website output.

https://github.com/fulldecent/phpdoc/actions/runs/8655960879/job/23735714726

One specific issue with Moodle is that a lot of code is top-level functions that are not namespaced. So the current index page of docs (now at https://fulldecent.github.io/phpdoc/) is too big to load. And search freezes the browser.

Other pages work great.

So maybe there is some way to suppress part of the index page or maybe there is some way to break down sections of the documentation automatically based on the folder structure.

Just putting ideas here. Maybe someone has a practical workaround.

[jaapio]

Thanks for your interest in phpDocumentor and your kind words.

The easiest solution for this would be to overwrite the index template. We do already render all file separately, like you can see here: https://fulldecent.github.io/phpdoc/indices/files.html

You could try to use the template extension. This allows you to create even more custom pages. So you can make a selection of functions for example on alphabetic order. Right now we do not have a system documented that would allow you to do this more automated.

The template extension feature will be part of the new 3.4 release that will be coming soon. ™️

Regarding the search functionality, I do not have a very good solution right now.

I hope this helps you a bit.

[fulldecent]

Also some discussion of template modification at #2865

---

Thank you! I can close this here and I will look out for the 3.4 release.