A modern programming language that makes developers happier.

kotlinlang

Hello!
I saw this stale PR about sitemaps in Dokka. Is there any plan about it? I would love to see the feature, and can help if needed
<https://github.com/Kotlin/dokka/pull/2009|https://github.com/Kotlin/dokka/pull/2009>

Hey!
At this moment, there are no plans to support sitemaps
Also, the PR linked above is very outdated, and probably there is no sense in trying to revive it
But, I believe that it should be possible to create a separate Dokka sitemap plugin for HTML format based on the <https://github.com/Kotlin/dokka/tree/1e3c3d833972e231148c983e0ac8d71444db5a79/plugins/sitemap/src/main/kotlin|code in the PR>, which should not require any changes to the internals of Dokka

Thank you! I’ll take a look.
Can you also explain why you don’t plan to support sitemaps natively? I’m okay making a plugin, but I think it’s a real value to have it directly integrated into the original tool.

&gt; Can you also explain why you don’t plan to support sitemaps natively?
I've said that we *currently* don't have plans for it :slightly_smiling_face:
We haven't discussed it, but you can take a look at the <https://github.com/Kotlin/dokka/issues/1305|original issue>, and it feels like there is no demand for it. Additionally, as far as I know, some of the site generators (e.g., Docusaurus) support sitemaps natively (e.g., when integrating API reference inside of it), or it's even possible to do so with some CLI/web/etc app
I also don't see it available out of the box, nor in SwiftDocc, nor in Javadoc tools
So in the end, it was not a priority for us

At this point, I think it would be better to have it as an external plugin

Actually I made [an external GitHub Actions](<https://github.com/marketplace/actions/github-pages-sitemap-generator|https://github.com/marketplace/actions/github-pages-sitemap-generator>) do generate the sitemap before uploading to GitHub Pages:

```yaml
• name: Generate sitemap
  uses: guimauvedigital/generate-sitemap@v1
  with:
    base_url: "<https://kdriver.dev|https://kdriver.dev>"
    output_path: "build/docs/sitemap.xml"
    input_dir: "build/docs"
```

`build/docs` is the folder where I copy the generated Dokka files and other custom markdown files I want to deploy on my website.