Vol III: Zener Diodes

On this page,
http://www.allaboutcircuits.com/vol_3/chpt_3/11.html

Second paragraph: "According to the 'diode equation' here..", the word "here" should be hyperlinked to the diode equation, I'm assuming. Instead, it links to the same page you are viewing.

Just thought I'd point it out since I've used this site for reference more than several times.

This is verified, it needs fixed. I'm not sure where it is supposed to point, but in a paper version of the book, which this is supposed to be, it doesn't really make sense.

The short simple answer is that this is a "page reference" in the .sml, and it works as such in the .pdf file as a hyperreference and in print pdf as a printed page number. Morover, the link in the chapter long file at ibiblio works.
http://www.openbookproject.net//electricCircuits/Semi/SEMI_3.html#xtocid827812

To explain why it does not work at AAC, some reference material follows:
The .sml source code is: <pageref>DioEqu</pageref>
The LaTeX translation is: \pageref{DioEqu}
The SEMI_1.html is: <a href="#DioEqu">

The properties of this link on my local machine, ibiblio, & AAC respectively:
File:///home/dennis/lessons/Semi//SEMI_3.html#DioEqu
http://www.openbookproject.net//electricCircuits/Semi/SEMI_3.html#DioEqu
http://www.allaboutcircuits.com/vol_3/chpt_3/11.html#DioEqu

I suspect that the poperties should be this at AAC:
http://www.allaboutcircuits.com/vol_3/chpt_3/1.html#DioEqu

The basic reason that the html link works at ibiblio and not at AAC is that the html at ibiblio is one large file per chapter, one whole too-large file for all of the "Diodes" chapter. At AAC, the diodes chapter is divided into (at a minimum) smaller, more digestable, files on a per section basis. At AAC, the link appears in /chpt_3/11.html but the target is in /chpt_3/1.html (I suspect). At ibiblio, the target and link are in the same html file.
I suspect that the link ( at http://www.allaboutcircuits.com/vol_3/chpt_3/11.html#DioEqu)
which is probably <a href="#DioEqu"> should be <a href="1.html/#DioEqu"> . That should point to the page (1.html) with the anchor <a name="DioEqu"></a> .

I do not know of an easy algorithmic method of producing the path to the links. (There could be scripts out there that will split a large html file into smaller ones.) In doing it from scratch, I suspect that it may be necessary to scan each AAC page for anchors, storing the anchor in a batabase along with the path to the file containing the anchor. Links would need to be looked up in this database of anchors.

I am hoping (but do not know) that tex4ht, the newer replacement for latex2html is capable of converting a LaTeX book into a set of small HTML files with all the hyperlinks preserved. I think that latex2html did that, but don't remember for sure.

I would like to convert from SML source to LaTeX source in the distant future, as Tony Kuphaldt has done for his "Instrumentation" book. This would only be attractive if it helped attract more authors by not having to deal with SML. If it helped solve the hyperlinks problem, that would also make it look attractive.

Dennis Crunkilton

Thanks for pointing this out. Given what Dennis has said I assume this is possibly not an isolated case with the material on AAC. That said it does need addressing.

I'll PM Rob to have a look at this and see if there is any way of modifying the update scripts to work around this issue.

Dave