Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
The Docs AddOn allows you to embed in Confluence Cloud empowers users to seamlessly integrate HTML, JavaScript, and CSS-based content in Confuence Cloud. The initial idea of the came from embedding . Its inception was inspired by the embedding of JavaDocs. However, as JavaDocs is just given that JavaDocs essentially comprise HTML, JavaScript, and CSS, the AddOn's versatility extends beyond this initial concept. This means you can use utilize the AddOn for embeddng any type of such content.
FAQ
How to add your content to the Docs AddOn?
All content shown by the Docs AddOn need to be uploaded as attachment to the appropriate Confluence Page. The content itself needs to be packacked as ZIP Archive. The content’s entry page should be named “index.html“ and shall be located in the ZIP Archive’s root directory.
Note: The entry page’s name can be adjusted in the AddOn’s configurations.
Image Removed
REST API
As all to embed a wide range of similar content types, including but not limited to Doxygen, PHPDocs, and more. Whether it's Doxygen, PHPDocs, or other content-sharing technologies, the AddOn offers a flexible solution for integrating various types of content within Confluence Cloud.
Keywords: JavaDoc, Doxygen, PHPDoc, Static WebContent, Technical Documentation
Here you can find aDocs Demo.
Screens
Image Added | Image Added | Image Added |
Image Added | Image Added | Image Added |
Image Added | Image Added |
Feature Clips
Automation via REST API
All your Docs are organized as attachments on a Conflunce Confluence Page basis. So, you can simply use Confluence’s standard REST API to organize attachments to add, delete, or modify your content.
You can find a real example in our Feature Clips above.
Here is a code snippet showing how to use curl to upload a doc to the AddOn:
Code Block |
---|
curl -D- \
-u user:password \
-X PUT \
-H 'X-Atlassian-Token: nocheck' \
-F 'file=@"my-javadoc.jar"' \
-F 'minorEdit="true"' \
-F 'comment="My JavaDoc"; type=application/zip' \
http://myhost/rest/api/content/123/child/attachment |
Here is the link to Confluence Cloud’s REST API documentation for attachment handling:
https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-get-put
Docs File Structure
The Docs AddOn requires all content to be packaged in a ZIP archive. By default, the entry page should be called index.html and must be located at the root of the ZIP archive.
Note: The name of the entry page can be adjusted in the AddOn’s configurations.
Example File
Here is an example file showing how a document should be organized:
View file | ||
---|---|---|
|
Docs Configurations
Image AddedHere you find a list of all configurations in addition to a description and example values.
Description | Example | |
---|---|---|
Height | The Docs AddOn’s static height in pixel on the page. Default: 600 pixel. | 600 |
Entry Page | The main entry page of your Docs content. Default: index.html. | index.html |
Filename Pattern | Filter your attachments by filename using a Java NIO Glob expression.
| *.jar *.{jar,zip} |
Label | Filter by attachments labels. |
How To’s
Clear Cache
To clear the cache, please click on “clear“ on the lower right on your overview page:
Image AddedPanel | ||
---|---|---|
| ||
Quick LinksIn the following are some quick links: |
Table of Contents
Table of Contents | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
AddOn Properties
Page Properties | ||||
---|---|---|---|---|
|