Host HTML pages right on your server instance – supports Javascript, and serves unique pages on a repository basis.
...
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Excerpt |
|---|
Pages for Bitbucket provides a simple way to publish web pages in Bitbucket |
...
for any existing branch or tag. |
...
View HTML files of this branch or tag files directly in Bitbucket. |
...
Using relative links, you can also link to other HTML files or resources like CSS, JavaScript |
...
, or images. Pages for Bitbucket allows you to host HTML pages right on your Bitbucket instance and supports Javascript and serves unique pages on a repository basis. Feature Highlights
|
...
|
...
|
...
|
...
|
How it works
Repository administrators You can enable the serving of static web pages for any existing branch or tag in the repository settings screen. Once enabled, the base URL for pages in this branch or tag is being displayed next to the branch or tag name.
Web pages are available under the following URL: /pages/<PROJECT>/<REPOSITORY>/<BRANCH-OR-TAG>
If there is no index.html file available in the root level of a branch or tag, you need to link to the page directly by appending the file path to the URL. Example: /pages/<PROJECT>/<REPOSITORY>/<BRANCH-OR-TAG>/browse/<PATH>/<TO>/<FILE>.html
Once pages have been enabled for a branch or a tag, users will be able to you can view HTML files of this branch or tag directly in Bitbucket. When clicking on open Click Open in the file browser of this branch or tag , to render the page will be rendered full screen, without the Bitbucket layout. It's also possible to link to other HTML files or resources like CSS, JavaScript, or images by using relative links. You can even link to files stored in Git LFS.
Of course by hosting Hosting your web pages directly in Bitbucket Server, also gives you also get automatic version control by Git.
Security
Access to web pages is based on repository permissions. Users need at least read access to the repository to view web pages in Bitbucket. For security reasons, by default, pages are not available unavailable for branches or tags in personal repositories by default. But in the plugin settings, you can configure which groups are allowed to can enable pages in personal repositories.
XSS Attacks
For users who want to still use the plugin and are worried about potentially malicious content in git repositories, weWe've added an option to disable JavaScript on rendered pages to reduce the risk of allowing potentially malicious content in git repositories. You can disable JavaScript either on a global level or a repository level. Another way to host malicious safely
Another method for reducing the risk of XSS vulnerability is to configure an external domain.
...
Pages for Bitbucket Server vs. websites on Bitbucket Cloud
The main difference between Pages for Bitbucket Server and the websites feature of Bitbucket Cloud is that we support websites on a repository level, not just on the account level. This brings the following advantages:
...
Websites on Bitbucket Cloud
...
Pages for Bitbucket Server
...
On Bitbucket Cloud you can only publish one repository per user.
...
With the Pages add-on you can publish as many repositories as you want.
...
On Bitbucket Cloud you can only publish a single branch of the repository.
...
With the Pages add-on you can serve static web pages from any branch or tag you like.
...
On Bitbucket Cloud the website is public on the internet. Anyone with the URL can access it.
...
The Pages add-on uses the permissions of the underlying repository, which allows you to control specifically who can access the pages and who not.
...
Bitbucket Cloud can only serve a website when the site's URL is <username>.bitbucket.org.
...