Re: [xdi-editors] questions about browser-viewable copies on xdi.org

[Chet Ensign <chet.ensign@oasis-open.org>]

Hi Joseph, hi Drummond - 

I suspect the problem here lies with Kavi. Copying Robin on the thread as he has much more history than I do. 

Kavi isn't acting as a normal server would. The www.oasis-open.org/apps/... URL is going to the database underlying Kavi which then retrieves the document. I don't know how we would put a link into Kavi that would then be associated with the document when you get it back. I know that we handled that in SVN but not Kavi. 

Robin, do you know if I am correct on this? Can you provide any feedback to Joseph? 

/chet

On Sat, Dec 6, 2014 at 4:44 PM, Joseph Boyle <boyle.joseph@gmail.com> wrote:

Hi Chet,

For example, if I open this URI directly in Firefox or Safari on my Mac: 

http://docs.oasis-open.org/templates/DocBook/spec-0.6/oasis-specification-0.6-wd01.xml

then I see a styled version displayed in the browser. This has been our primary mode of display for editing of XDI TC’s DocBook-format drafts. (which have displayed in Chrome as well)

In this case, the document points to a stylesheet hosted on the same domain name docs.open-oasis.org, which is apparently why it works. 

<?xml-stylesheet type="text/xsl"
	href="" href="http://docs.oasis-open.org/templates/DocBook/spec-0.6/stylesheets/oasis-specification-html.xsl" target="_blank">http://docs.oasis-open.org/templates/DocBook/spec-0.6/stylesheets/oasis-specification-html.xsl"?>

When we upload drafts to Kavi, we get addresses on the server www.open-oasis.org like:

https://www.oasis-open.org/apps/org/workgroup/xdi/download.php/51637/xdi-core-1.0-wd01.xml

These never display correctly in the browser - pointing to a stylesheet at another subdomain doesn’t work (I assume due to usual browser Cross-Site Scripting restrictions), and there’s not a DocBook stylesheet and corresponding installation on www.oasis-open.org.

I think if the server simply had a symbolic link so that URIs like www.oasis-open.org/templates/DocBook/… would return the corresponding results from the existing installation docs.oasis-open.org/templates/DocBook/… then drafts on Kavi should be displayable in the browser.

Thanks, Joseph

On Dec 2, 2014, at 9:51 AM, Chet Ensign <chet.ensign@oasis-open.org> wrote:

Hi Drummond - 

That'd be me. I have an action item to update the Docbook publishing environment anyway. Which is woefully behind but different story there... 

Joseph, when you write "...  www.open-oasis.org, the server where uploaded drafts live...", do you mean the links as they are done in Kavi? I don't understand why a link on www.oasis-open.org would be needed. What I consider the official copy of the Docbook installation is the one on docs.oasis-open.org. 

Not arguing here - just looking to understand. 

Thanks, 

/chet 

On Mon, Nov 24, 2014 at 12:16 AM, =Drummond Reed <drummond.reed@xdi.org> wrote:

Joseph, it sounds like you and Markus are in violent agreement on this. Who do we need to contact at OASIS to "make it so"?

On Sat, Nov 22, 2014 at 5:15 PM, Joseph Boyle <boyle.joseph@gmail.com> wrote:

We still should ask OASIS to host a copy of (or symlink) the DocBook installation from www.open-oasis.org, the server where uploaded drafts live. That would allow us to always use the HTTP form of the stylesheet reference, preferably from a fixed well-known relative address that might even let us leave out the domain name and make it domain independent.

On Nov 22, 2014, at 9:11 AM, Markus Sabadello <markus.sabadello@xdi.org> wrote:

I'm just not sure about #3.

The stylesheet references in Github are currently very chaotic, sometimes it's this:

<?xml-stylesheet type="text/xsl"
href="" href="http://docs.oasis-open.org/templates/DocBook/spec-0.6/stylesheets/oasis-specification-html.xsl" target="_blank">http://docs.oasis-open.org/templates/DocBook/spec-0.6/stylesheets/oasis-specification-html.xsl"?>

Sometimes it's this:

<?xml-stylesheet type="text/xsl"
href="" href="http://xdi.org/xdi-spec-docbook/htmlruntime/spec-0.6/stylesheets/oasis-specification-html.xsl" target="_blank">http://xdi.org/xdi-spec-docbook/htmlruntime/spec-0.6/stylesheets/oasis-specification-html.xsl"?>

Sometimes it's this:

<?xml-stylesheet type="text/xsl"
href="">

And sometimes it's this:

<?xml-stylesheet type="text/xsl"
href="">
I understand they all work or don't work under different circumstances, but we should have a rule for which one we use in Github, Kavi, xdi.org etc., and stick to that rule consistently in all specs.

Markus

​

--

/chet   [§] 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open

--

/chet   [§] 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open