Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways...
Transcript of Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways...
![Page 2: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/2.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
XAAS – XML Authoring as Service
oXygen XML Web Author =
A REST service to interact with XML content!
Parameters
• url – pointing to the file to edit
• ditamap – pointing to a DITA map for editing
context
• … – more parameters are available
![Page 3: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/3.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Integration is key
web XML editor ≠ opening XML to edit in browser
The real power of a web editor can be seen
when it is integrated to optimize or to enable a
workflow!
![Page 4: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/4.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Desktop editor
GitHub contribution workflow
original
remote
repository
dita-ot/docs
your
remote
repository
1. fork
your local
repository
branch
2. clone
Working
copy
3. checkout
4. change
5. commit
6. push
7. pull
request
Edited
File
GitHub
Local
![Page 5: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/5.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Desktop editor
GitHub contribution workflow
your
remote
repository
1. fork
your local
repository
branch
2. clone
Working
copy
3. checkout
4. change
5. commit
6. push
7. pull
request
Edited
File
GitHub
Local
original
remote
repository
dita-ot/docs
![Page 6: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/6.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Hide GitHub complexity
From
• Fork remote
• Clone locally
• Branch
• Checkout working copy
• Change• Commit locally• Push to remote
• Send pull request
To
• Change
• Save/Commit
Automate parts of the contribution workflow
![Page 7: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/7.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Simplified workflow
original
remote
repository
Edited
File
1. change
2. save à fork + commit/push + pull request
![Page 8: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/8.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Technical support to documentation
A support incident is an opportunity to improve
your product documentation!
![Page 9: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/9.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Review product documentation
Involve developers to review product
documentation!
![Page 10: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/10.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Review documentation
Jira
Issue
• description
• comment
• code changes
• documentation
changes
Source repository
GitHub
• Documentation
repository
![Page 11: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/11.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Review documentation
Jira
Issue
• description
• comment
• code changes
• documentation
changes
Source repository
GitHub
• Documentation
repository
review/edit
modified
documentation
![Page 12: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/12.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Review documentation
Jira
Issue
• description
• comment
• code changes
• documentation
changes
• review/edit modified
documentation
Source repository
GitHub
• Documentation
repository
oXygen XML
Web Author
![Page 13: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/13.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Email notifications with links
![Page 14: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/14.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Link to changes topics
click to
review/edit
![Page 15: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/15.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Immediate edit access
![Page 16: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/16.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Click to see changes
![Page 17: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/17.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
DITA-OT documentation
Services used by the DITA-OT documentation
• GitHub• storage
• versioning
• access control
• GitHub Pages• web publishing
• Travis• automate publishing
• Slack• project communication
![Page 18: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/18.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
And they are connected
GitHubRepositories
• dita-ot.github.io
• docs
GitHub Pages
• www.dita-ot.org
Travis
publish
scripts
Slack
![Page 19: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/19.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
New service – XML authoring
• GitHub• storage
• versioning
• access control
• oXygen XML Web Author• XML Authoring
• GitHub Pages• web publishing
• Travis• automate publishing
• Slack• project communication
![Page 20: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/20.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
And we integrate it in the workflow
GitHubRepositories
• dita-ot.github.io
• docs
GitHub Pages
• www.dita-ot.org
Travis
publish
scripts
Slack
oXygen XML Web Author
online editor
![Page 21: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/21.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Click on website to edit its content
![Page 22: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/22.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
DITA-OT documentation website
edit link
http://www.dita-ot.org/dev/
![Page 23: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/23.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Edit the source content
![Page 24: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/24.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Save to send a request for change
![Page 25: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/25.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
xproc.org and exproc.org
Similar services (GitHub, Travis, GitHub Pages)
but this time the source is DocBook.
Integrates the web authoring via the “Edit this
page on GitHub” links
http://www.xproc.org
http://www.exproc.org
![Page 26: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/26.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
DITA+Markdown based Wiki
Website
(GitHub Pages)
link to edit page
GitHub
• Documentation
repository
oXygen XML
Web Author
Travis
![Page 27: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/27.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Website content
https://georgebina.github.io/ghd-wiki/
![Page 28: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/28.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Lightweight DITA topic
History and Edit links
![Page 29: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/29.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Revisions history
![Page 30: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/30.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Controlled AX online editor
![Page 31: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/31.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Markdown topic
![Page 32: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/32.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
GitHub Markdown editor
![Page 33: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/33.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Travis project status
https://travis-ci.org/georgebina/ghd-wiki/builds
![Page 34: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/34.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
TEI Journal
TEI CSS customization for TEI Journal articles:
https://github.com/georgebina/jteiPlus
Sample:
https://www.oxygenxml.com/webapp-demo-
aws/app/oxygen.html?url=github%3A%2F%2FgetFileC
ontent%2Fgeorgebina%2FjteiPlus%2Fmaster%2Fsam
ples%2FJTEI%2Fjtei_8_eide_source%2FDEMOjtei-8-
eide-source.xml
![Page 35: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/35.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Take-aways
Integration is key for web XML authoring!
Contributing to XML-based systems cannot be
easier:
Click – Edit – Save – Describe what you changed
We can turn any system into a wiki like system
where anyone can edit the content
Contributions can be reviewed before they are
published (content curation)
![Page 36: Making XML Editable on the Web · 2017-06-01 · Making XML editable on the Web Take-aways Integration is key for web XML authoring! Contributing to XML-based systems cannot be easier:](https://reader033.fdocuments.in/reader033/viewer/2022060308/5f0a2c817e708231d42a5e04/html5/thumbnails/36.jpg)
@georgebina Copyright @ Syncro Soft, 2017. All rights reserved.
Making XML editable on the Web
Thank you
Questions?
@georgebina
http://www.oxygenxml.com