Publishing documentation: issues with wiki (.html) and webpage ("_" in workspace id)
Asked by rossella gamba:

Hello,

We have some code hosted on a Bitbucket [repo](https://bitbucket.org/eob_ihes/teobresums/src/master/) for which we'd like to publish doxygen documentation (.html files) to be easily accessed from the web.  
Unfortunately, we cannot push these files to the [webpage](https://bitbucket.org/eob_ihes/teobresums.bitbucket.io/src/master/) linked to the workspace, since due to the underscore appearing in its name and id ("eob_ihes", the WS was created around 2018) the page does not display properly.  
Similarly, the wiki does not support html/xml files, and the conversion xml--\>md does not work very well.  

What is the best way to proceed in this situation? In particular:

* Does Bitbucket plan to allow for pushing .html files to the wiki of the repo? (related [issue](https://jira.atlassian.com/browse/BCLOUD-12719) )
* Alternatively, would it be possible to change the workspace id from "eob_ihes" to "eob-ihes", and have the old URL point/redirect to the new one? This repo has a rather long history, and there exists a large body of published papers that link to the current address. Simply modifying the workspace id would "break" all these links.

Note that the documentation is already accessible via the [downloads](https://bitbucket.org/eob_ihes/teobresums/downloads/) page, but we'd like for it to be displayed online. We'd also prefer to avoid having to use Confluence.

Thank you in advance,

Rossella


Answers:
author: Ben
body: Hi Rosella,

The feature request ticket you have linked is still with our developers, but we have no ETA as to when/if it will be implemented - more information concerning our feature request implementation policy can be found below:

* <https://confluence.atlassian.com/support/implementation-of-new-features-policy-201294576.html>

Unfortunately, changing the workspaceID would require that remote URL's are updated locally so that the linkage is not broken, more information can be found here:

* <https://support.atlassian.com/bitbucket-cloud/docs/change-a-workspace-id/>

Are you able to share a screenshot of how the webpage appears with the underscore workspaceID? I wish to know what is not displaying properly so I can attempt to reproduce the issue on my end.

Cheers!

- Ben (Bitbucket Cloud Support)

comments: author: rossella gamba
body: Hello Ben,

thank you for the very prompt answer. When navigating to <https://eob_ihes.bitbucket.io> I see the following:

![Screenshot_20231205_132605.png](https://community.atlassian.com/t5/image/serverpage/image-id/295411iDFBAD23BAD4406F1/image-dimensions/330x92?v=v2 "Screenshot_20231205_132605.png")

I guess "displaying properly" is not the correct wording: it is not showing anything at all (but an error message) -- apologies for not being clearer! :)

I also tried navigating to [https://eob-ihes.bitbcuket.io](https://eob-ihes.bitbucket.io), but get a "repository not found" message, as expected.

Thank you,

Rossella


author: Ben
body: Hi Rossella,

I've been able to reproduce this on my end, the same HTTP error response is returned.

I've found an old bug ticket that was closed, but I have re-opened it on your behalf as I believe that work could be done to avoid the requirement of a workspace ID change to fix the issue - please feel free to **Watch** this to receive future updates related to it and click **This Affects My Team**to raise its visibility:

* <https://jira.atlassian.com/browse/BCLOUD-13600>

Essentially, underscores aren't supported by DNS hostnames - but when they are present in a repository name, for example, we replace these with dashes in the URL (this doesn't occur for static webpages).

Unfortunately, at this stage, the only interim fix is to remove the underscore from your Workspace ID and then update the static website repository name to fix this.

Cheers!

- Ben (Bitbucket Cloud Support)


author: rossella gamba
body: Hi Ben,

I see, thank you! Marking this as resolved then, as we wait for updates :)

Cheers,  
Rossella


Tags: bitbucket-cloud

cloud

documentation