Oxygen XML Web Author with Git using Bitbucket
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
I have an instance of our DITA source stored in Git accessible from an internal server hosting Bitbucket.
Can I use one of the Web Author plugins to connect to our Bitbucket server and access DITA content there?
Thanks in advance,
Ann
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
Yes, you can use Web Author to edit files located on a Bitbucket server. Web Author comes with a git plugin which allows one to open files from any git repository.
To edit a file stored in a git repository:
- click the Open/New Git buttons located on the Web Author Dashboard [1]
- type in your Bitbucket user & pass in the login dialog
- type in the URI of your bitbucket repository: "https://your_bitbucket_install/example_team/example_project"
- choose the branch on which you want to work
- click "Browse" and open a file for editing
- after editing, commit your file [2]
Note that if you use a self-signed SSL certificate for your BitBucket server you may need to enable the "Automatically accept a security certificate, even if invalid" option found under Connection in the administration page [3]
[1] https://www.oxygenxml.com/doc/versions/ ... =dashboard
[2] https://www.oxygenxml.com/doc/versions/ ... tml?hl=git
[3] https://www.oxygenxml.com/doc/versions/ ... l=security
Best,
Gabriel
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Re: Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
I mistyped my login credentials for Bitbucket but don't know how to get back the popup that allows me to type in my login credentials again.
Also, our Bitbucket is running on a private server so do I not need to type in the server URL somewhere?
Thanks,
Ann
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
Sorry about that, it looks like there's a bug preventing the logout button from showing up.
I fixed the bug and updated the Git plugin. You can download the latest version from here [1] (webapp-github-plugin-18.1-plugin.jar) and replace the one you have using the admin page [2] (Delete the old one, upload the new one).
[1] https://github.com/oxygenxml/webapp-git ... tag/18.1.0
[2] https://www.oxygenxml.com/doc/versions/ ... e_a_plugin
[3] https://www.oxygenxml.com/doc/versions/ ... start.html
Best,
Gabriel
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Re: Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
One other thing I still am not sure of: what am I being logged in to when I enter my username and password? Out Bitbucket is running on an internal server not on the cloud...so will this work?
thanks,
Ann
-
- Posts: 496
- Joined: Thu Sep 04, 2014 4:22 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by cristi_talau »
The Git support works also with on-premise installations of BitBucket. When you open a file, make sure to specify the URL of your local BitBucket server, then enter your BitBucket credentials to enable Web Author open and commit files on your behalf.
Best,
Cristian
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
To clarify. You aren't being logged into anything actually. After you type in the username and password we store them, encrypted, for the current editing session. When a commit/read into/from a repository requires credentials we present the stored username and password.One other thing I still am not sure of: what am I being logged in to when I enter my username and password?
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Re: Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
So I tried the following:
1. Select to open using Git.
2. Enter my username, password and associated email address (for our internal Bitbucket server).
3. Under Choose File, I pasted in the complete path to one of my Dita files viewable from the Bitbucket server i.e. http://<bitbucketservername>:7990/projects/bla/repos/idocsprototype/browse/system_documentation/dita_files/c_introduction.dita
I then get the following failure message:
Failed opening repository : http://<bitbucketservername>:7990/projects/bla/repos/idocsprototype/browse/system_documentation/dita_files/c_introduction.dita
I have double-checked my login credentials and they are correct for the Bitbucket server.
Any advice appreciated,
Regards,
Ann
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
Code: Select all
git clone MY_REPO
Best,
Gabriel
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Re: Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
I am connected now.
Thanks for your help,
Ann
-
- Posts: 295
- Joined: Wed Jun 17, 2015 10:19 am
Re: Oxygen XML Web Author with Git using Bitbucket
Post by ann.jensen »
I have since had Oxygen XML Web Author installed on a central server and am trying to connect to my Git repo from it.
I have already successfully connected from my local install of Oxygen XML Web Author but am running into problems with server install.
To recap the steps required:
1. Launch Oxygen XML Web Author installation
2. Log in to Administration page and select checkbox beside Automatically accept a security certificate, even if invalid
3. Navigate to homepage i.e. app/oxygen.html
4. Select Open --> Git
5. Enter username and password for the Git repo
6. Paste in the repo URI e.g. http://username@servername:port/path/repo.git
I am getting the error
Code: Select all
Failed opening repository : http://username@servername:port/path/repo.git
Regards,
Ann
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
Try typing https://... instead of http://... for the repo URI.
If that does not work I need more information to fix the error. Please enable additional debug logging by appending:
to the log-config file.log4j.category.com.oxygenxml.examples.git=debug
To locate the log-config file follow the first steps here [1].
After that you need to restart Web Author, go back to the Dashboard page and attempt to open a file. After you receive the error again, please find the oxygen.log file [1] and send it over to support@oxygenxml.com mentioning this forum post.
[1] https://www.oxygenxml.com/doc/versions/ ... ng%20files
Best,
Gabriel
-
- Site Admin
- Posts: 95
- Joined: Thu Jun 09, 2016 2:01 pm
Re: Oxygen XML Web Author with Git using Bitbucket
Post by Gabriel Titerlea »
Oxygen XML Web Author 23.0 was released and it now has enhanced support for Bitbucket server [1].
Instead of authenticating with a user-name and password, a "Login with Bitbucket Server" button is now available on the Web Author dashboard [2].
You can find instructions for how to enable the new Bitbucket server support here [3].
For more details about this release you can check out the what's new page [4].
Best,
Gabriel
[1] https://www.oxygenxml.com/doc/versions/ ... ithub.html
[2] https://www.oxygenxml.com/doc/versions/ ... -docs.html
[3] https://www.oxygenxml.com/doc/versions/ ... ntegration
[4] https://www.oxygenxml.com/xml_web_author/whats_new.html
Return to “DITA (Editing and Publishing DITA Content)”
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service