Links
by Rubes · in Torque Developer Network · 12/08/2005 (1:33 pm) · 9 replies
I put together a page on TDN listing all of the GUI controls, and as part of it I wanted to include links to their referenc (like in the Docs) and to some examples of their usage (like in resources).
I got the links to the Docs working fine, but none of the links to the Resources would work.
For example, this link works fine:
[[http://www.garagegames.com/docs/tge/engine/classEditTSCtrl.php Documentation]]
But this one doesn't:
[[http://www.garagegames.com/index.php?sec=mg&mod=resource&page=view&qid=5277 Resource]]
The second one causes the whole section to disappear. I'm not sure what's causing it, but I think it has to do with the type of URL. I'm not sure if it's the ?, the &, or the = that does it, but TDN doesn't seem to allow these types of links. I didn't read anything about this in the Meta page, so I thought I'd mention it here.
I got the links to the Docs working fine, but none of the links to the Resources would work.
For example, this link works fine:
[[http://www.garagegames.com/docs/tge/engine/classEditTSCtrl.php Documentation]]
But this one doesn't:
[[http://www.garagegames.com/index.php?sec=mg&mod=resource&page=view&qid=5277 Resource]]
The second one causes the whole section to disappear. I'm not sure what's causing it, but I think it has to do with the type of URL. I'm not sure if it's the ?, the &, or the = that does it, but TDN doesn't seem to allow these types of links. I didn't read anything about this in the Meta page, so I thought I'd mention it here.
#2
12/16/2005 (10:05 pm)
You don't need the second set of []'s, just the first. I did some testing and it seems to make things work fine. Are you talking about the per-section edit links being broken?
#3
When I pasted the entire text all at once, that resource link caused its section to disappear from the beginning of the link to the end of the section. I don't recall if the edit link for that section was broken as well. The sections after it looked and worked fine.
Just now I tried editing the URL link in one of the sections that didn't work previously. I put in the link to a resource as above. When I clicked the "Preview" button, the link seemed to display properly, although there were some problems after the link (some of the markup was being displayed). When I clicked "Save", now the section that I edited is again gone, replaced with {{{1}}}. The edit link is gone as well, as is the entry from the Table of Contents. So now I can't go back and fix it, either.
It should still be that way if you want to check it out. The entry that I edited is GameTSCtrl.
12/18/2005 (9:00 am)
Some of this may have arisen because I created the entire page in a word processor (a deft use of mail merge, if I do say so myself) and then pasted it into TDN all at once. I still didn't know much about TDN, so I was surprised to see it create the Table of Contents and split each entry up into a different section, which was very cool.When I pasted the entire text all at once, that resource link caused its section to disappear from the beginning of the link to the end of the section. I don't recall if the edit link for that section was broken as well. The sections after it looked and worked fine.
Just now I tried editing the URL link in one of the sections that didn't work previously. I put in the link to a resource as above. When I clicked the "Preview" button, the link seemed to display properly, although there were some problems after the link (some of the markup was being displayed). When I clicked "Save", now the section that I edited is again gone, replaced with {{{1}}}. The edit link is gone as well, as is the entry from the Table of Contents. So now I can't go back and fix it, either.
It should still be that way if you want to check it out. The entry that I edited is GameTSCtrl.
#4
I rolled back and it seems to be showing up fine....?
12/18/2005 (3:28 pm)
Sure you can go back and fix it. It's all in the history, dude. :)I rolled back and it seems to be showing up fine....?
#5
I'm not sure what you're referring to when you say it shows up fine. The link for the Reference (to the Documentation) works fine, but the link to the Usage Example doesn't. The link to the Reference is a simple link like the first one in my original post; the Usage Example link is to a resource and looks like the second one in my original post.
Right now there is no link for Usage Example -- I removed it since I couldn't get it to work.
When I put the link back in, the code for the section looks like this:
and when saved, the entire section shows up like this:
with no edit link, and it is no longer listed in the Table of Contents.
This seems to happen only with links that involve search/retrieval functions, but not simple links (like the ones to the documentation).
12/18/2005 (7:14 pm)
Crap, forgot about the history thing.I'm not sure what you're referring to when you say it shows up fine. The link for the Reference (to the Documentation) works fine, but the link to the Usage Example doesn't. The link to the Reference is a simple link like the first one in my original post; the Usage Example link is to a resource and looks like the second one in my original post.
Right now there is no link for Usage Example -- I removed it since I couldn't get it to work.
When I put the link back in, the code for the section looks like this:
<h3><u>'''GameTSCtrl'''</u></h3>
<ul>
'''Description:''' A Gui for rendering 3D scenes. It is the TS Gui control often used for the main screen during gameplay. A subclass of GuiTSCtrl.
'''Reference:''' [[http://www.garagegames.com/docs/tge/engine/classGameTSCtrl.php Documentation]]
'''Usage Example:''' [[http://www.garagegames.com/index.php?sec=mg&mod=resource&page=view&qid=7335 Object Selection Resource]] - not the best example but illustrates how it can be used and modified.
</ul>}}
{{Template:ContentBlockoutBlackRule}}
{{Template:ContentStandard|and when saved, the entire section shows up like this:
{{{1}}}with no edit link, and it is no longer listed in the Table of Contents.
This seems to happen only with links that involve search/retrieval functions, but not simple links (like the ones to the documentation).
#6
12/18/2005 (7:37 pm)
So it does. Interesting. I'll have to track that issue down. For now I'd suggest not using templates on that page, as they tend to break links and things of this nature. A link outside the templates work fine.
#8
06/20/2006 (10:04 am)
Ah, I'm glad I found this page. I still see the same behavior. I suppose this is a bump. 
Associate Kyle Carter