[XXE] Inserting Hyperlinks

Discussion:

Karen Hansen

2005-07-07 08:27:27 UTC

Hi,

Can you tell me how to insert hyperlinks in xmlmind. I have tried typing in a url, ahref etc in the linkend attribute but nothing seems to work
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.xmlmind.com/pipermail/xmleditor-support/attachments/20050707/480092cf/attachment.html>

Hussein Shafie

2005-07-07 09:14:12 UTC

Permalink

Post by Karen Hansen
Can you tell me how to insert hyperlinks in xmlmind. I have tried typing
in a url, ahref etc in the linkend attribute but nothing seems to work

It depends on what you mean by "nothing seems to work".

Assuming that you are authoring a DocBook document.

Procedure:

[1] Type the text of the hyperlink. Example: XMLmind XML Editor.

[2] Select the text of the hyperlink by dragging your mouse over it as
usual.

[3] Use the DocBook toolbar and select ulink from the "blue underlined
a" icon. (*ulink* and not link.)

[4] Now "XMLmind XML Editor" is underlined and displayed in blue.
You need to specify the href attribute of this newly created ulink
element. 2 methods for that:

[a] Usual one:
* Click inside "XMLmind XML Editor".
* Select the Attributes tool at the right of the window.
* Click in the row starting with "href".
* Type the target of the hyperlink. Example:
http://www.xmlmind.com/xmleditor/
* Press enter.

[b] Cool one (works on Windows, Mac and Linux with Java 1.5):
Use your web navigator. Drag the target of the hyperlink from the
navigator and drop it on the blue, underlined "XMLmind XML Editor" in
the XML editor.

You are done.

Yes, the ulink is not ``active'' inside the XML editor. That is, using
the default configuration of the XML editor, you cannot follow the
hyperlink inside the XML editor. But when you'll convert your DocBook
document to HTML and/or to PDF you'll be able to do so using the
*converted document* (i.e. opened in Internet Explorer or in Acrobat).

---
PS: Please take the time to read
http://www.xmlmind.com/xmleditor/tutorial.html (also available in
http://www.xmlmind.com/xmleditor/_distrib/doc/user/userguide.pdf)or you
will use your time because XMLmind XML Editor is not intuitive to use.

The fact that the tutorial uses XHTML as an example is not a problem.
Everything you'll learn applies to DocBook and to all the other document
types.

Ken Doran

2005-07-21 20:57:56 UTC

Permalink

Hi Everyone,

I'm authoring a Docbook modular document (with chapters) and am trying
to insert hyperlinks. I'm trying to link not to websites (URLs), but
rather to files residing on the end-user's PC. I've tried the steps for
creating hyperlinks that Hussein suggested to Karen, but without
success. I'm using V2.11 (Standard Edition).

I created a "ulink" element as described by Hussein. However, "href"
does not appear in the list of attributes for ulink. So, I added href
as an attribute and assigned it a value (in my case, the name of a file
in my XXE folder). Once my Docbook document was converted to HTML, I
clicked on the link in the resulting HTML page, but it went nowhere.
So, I went back into XXE and noticed that my XML was invalid. The
following errors were cited:

element has no attribute "href" [cvc-complex-type.3]
required attribute "url" is missing [cvc-complex-type.4]

My understanding is that ulink elements are employed in Docbook to
create href's in HTML files. Further, that local files as well as URLs
may be referenced. What am I doing wrong?

On the other hand, if I specify the "url" attribute instead of the href
attribute, I'm able to create good links to other documents (chapters),
but *only* if the HTML files for the referenced chapters reside within
the *same* folder.

However, some of the files to be hyperlinked are data files (not
chapters) and must reside in different folders. The hyperlinks to these
files also work OK on my PC. Yet, even though I specify them by
reference (e.g., ../../folderA/fileA), these links somehow seem to get
hardwired to the path of my computer. So, the links created are not
valid on the PCs of any other users. Again, what am I doing wrong?

Thanks very much for your assistance,
-- Ken

Post by Hussein Shafie

Post by Karen Hansen
Can you tell me how to insert hyperlinks in xmlmind. I have tried typing
in a url, ahref etc in the linkend attribute but nothing seems to work

It depends on what you mean by "nothing seems to work".
Assuming that you are authoring a DocBook document.
[1] Type the text of the hyperlink. Example: XMLmind XML Editor.
[2] Select the text of the hyperlink by dragging your mouse over it as
usual.
[3] Use the DocBook toolbar and select ulink from the "blue underlined
a" icon. (*ulink* and not link.)
[4] Now "XMLmind XML Editor" is underlined and displayed in blue.
You need to specify the href attribute of this newly created ulink
* Click inside "XMLmind XML Editor".
* Select the Attributes tool at the right of the window.
* Click in the row starting with "href".
http://www.xmlmind.com/xmleditor/
* Press enter.
Use your web navigator. Drag the target of the hyperlink from the
navigator and drop it on the blue, underlined "XMLmind XML Editor" in
the XML editor.
You are done.
Yes, the ulink is not ``active'' inside the XML editor. That is, using
the default configuration of the XML editor, you cannot follow the
hyperlink inside the XML editor. But when you'll convert your DocBook
document to HTML and/or to PDF you'll be able to do so using the
*converted document* (i.e. opened in Internet Explorer or in Acrobat).
---
PS: Please take the time to read
http://www.xmlmind.com/xmleditor/tutorial.html (also available in
http://www.xmlmind.com/xmleditor/_distrib/doc/user/userguide.pdf)or you
will use your time because XMLmind XML Editor is not intuitive to use.
The fact that the tutorial uses XHTML as an example is not a problem.
Everything you'll learn applies to DocBook and to all the other document
types.
--
XMLmind XML Editor Support List
xmleditor-support at xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.xmlmind.com/pipermail/xmleditor-support/attachments/20050721/be16d093/attachment.html>

Hussein Shafie

2005-08-02 10:25:13 UTC

Permalink

Post by Ken Doran
I'm authoring a Docbook modular document (with chapters) and am trying
to insert hyperlinks. I'm trying to link not to websites (URLs), but
rather to files residing on the end-user's PC. I've tried the steps for
creating hyperlinks that Hussein suggested to Karen, but without
success. I'm using V2.11 (Standard Edition).
I created a "ulink" element as described by Hussein. However, "href"
does not appear in the list of attributes for ulink. So, I added href
as an attribute and assigned it a value (in my case, the name of a file
in my XXE folder).

You did that using a editor other than XXE (e.g. a text editor) because,
in normal editing mode, XXE cannot be used to add alien attributes such
as "href" to an element.

Post by Ken Doran
Once my Docbook document was converted to HTML, I
clicked on the link in the resulting HTML page, but it went nowhere.
So, I went back into XXE and noticed that my XML was invalid. The
element has no attribute "href" [cvc-complex-type.3]
required attribute "url" is missing [cvc-complex-type.4]
My understanding is that ulink elements are employed in Docbook to
create href's in HTML files. Further, that local files as well as URLs
may be referenced. What am I doing wrong?
On the other hand, if I specify the "url" attribute instead of the href
attribute, I'm able to create good links to other documents (chapters),
but *only* if the HTML files for the referenced chapters reside within
the *same* folder.

XXE is right. I was wrong. My answer to Karen contained a *blatant*
error. The ulink element has no "href" attribute. Instead it has a
required "url" attribute. You need to specify a proper value for this
"url" attribute.

See http://docbook.org/tdg/en/html/ulink.html

Post by Ken Doran
However, some of the files to be hyperlinked are data files (not
chapters) and must reside in different folders. The hyperlinks to these
files also work OK on my PC. Yet, even though I specify them by
reference (e.g., ../../folderA/fileA), these links somehow seem to get
hardwired to the path of my computer. So, the links created are not
valid on the PCs of any other users. Again, what am I doing wrong?

Ken Doran

2005-08-03 00:52:50 UTC

Permalink

Thanks, Hussein. My problem (when pointing to files in other folders,
the links worked OK locally, but actually got hardwired to the path of
my PC) had nothing to do with using the wrong XXE elements or
attributes, but rather the data files didn't reside in a subfolder of
the converted HTML files. XXE (or XML or HTML?) doesn't know that each
end-user will have the same directory structure. So, even though I
specified my links by reference (e.g., ../../folderA/fileA), they
somehow got hardwired to the path of my PC and weren't valid on the PCs
of other users. What I needed to do was to simply move or copy these
files to a subfolder of the converted HTML files (or to the same folder
as the HTML files). Thanks, Hussein, for pointing out the simple solution.

-- Ken

Post by Hussein Shafie

You did that using a editor other than XXE (e.g. a text editor) because,
in normal editing mode, XXE cannot be used to add alien attributes such
as "href" to an element.

I don't know what to answer. This problem is absolutely not related to
XXE. It seems that you need to copy "../../folderA/fileA" along with the
generated HTML file.
This task could be automated using XXE but it would require a pretty
advanced customization of the DocBook configuration.
--
XMLmind XML Editor Support List
xmleditor-support at xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.xmlmind.com/pipermail/xmleditor-support/attachments/20050802/04daacaf/attachment.html>

Karen Hansen

2005-07-07 20:59:47 UTC

Permalink

Thanks very much for the quick response.

________________________________

From: Hussein Shafie [mailto:hussein at pixware.fr]
Sent: Thu 7/07/2005 7:14 PM
To: Karen Hansen
Cc: xmleditor-support at xmlmind.com
Subject: Re: [XXE] Inserting Hyperlinks

Post by Karen Hansen
Can you tell me how to insert hyperlinks in xmlmind. I have tried typing
in a url, ahref etc in the linkend attribute but nothing seems to work