[sword-devel] SWORDWEB Footnote / Cross-ref support

[Troy A. Griffitts]

Hey guys,
	Thank you for the feedback.  I will say once again for the newcomers, 
in case they haven't realized it yet: I am terrible at making things 
look pretty.  Anything that looks good on swordweb is due to other 
people writing nice CSS and HTML, etc.  If anyone has graphic design 
talent and would like to change some of the CSS styles to replace the X 
and N with nice neo-conservative abstract art icons we could show 
instead, I would love for people to use their gifts!

	Concerning hitting the server.  DM, you made a comment about jumpy 
redraws?  Please be specific about when this happens.  It should do no 
such thing.  I'd like to fix whatever the problem is.

	Thank you for the suggestion about preloading data.  Our first impl of 
these pages work this way.  We've changed to the current impl because 
not everyone has high speed access and some people pay by bandwidth 
usage.  Those pages have been way too hot, since adding word click 
strongs/morph lookups, to grab all the data in one hit to the server.

	Always open for patches and help with other items on the todo list:

	http://crosswire.org/~scribe/todo/



Daniel Blake wrote:
> FYI - I did the exact same thing.  Toggled the Footnotes on and 
> immediately scrolled to the bottom of the page to see them.  It may not 
> be right, but I think most of us have been trained to think and expect 
> to find things that way.
> 
> Thanks for the work.  It looks good.
> 
> Daniel Blake
> 
> DM Smith wrote:
> 
>> Looks good. Some thoughts.
>>
>> In the NASB module each of the notes and cross references has an "n" 
>> attribute which can be used for a marker. I don't know if the sword 
>> api exposes them. If it does, you might want to use it.
>>
>> In the "It's just my preference" category, I think that since you are 
>> not listing the notes at the foot of the page, they are not foot 
>> notes. The first thing that I did after clicking on "Show footnotes" 
>> was to scroll to the foot of the page to see the notes. Perhaps just 
>> call them "Notes".
>>
>> In the KJV, notes often have references. How would that be handled?
>>
>> If the reference is to something on the same page, should it do 
>> something different?
>>
>> I run my monitor at a high resolution and it is hard for me to click 
>> on the little 'n's or 'x's. I noticed in the html that the spacing is 
>> outside the span. Perhaps putting it into the span would help. I think 
>> that using different marks might also help, such as †. You 
>> might not need to superscript it or make it smaller.
>>
>> It appears that the showing or hiding of footnotes or cross references 
>> goes back out to the server. It is pretty fast but it causes a redraw 
>> and a jumping around of the page. I don't know what is done during 
>> that refresh, but I think that the page could be gotten with all the 
>> notes and references and the page built with them, but making them 
>> visible based on the state of the settings.
>>
>> To do this, the "Study Tools" options would need to change to call 
>> javascript to toggle the setting and then invoke the appropriate 
>> behavior. The spacing around spans would need to be moved inside.
>>
>> The appropriate behaviour may be to call passageStudy.jsp as it does 
>> now or to change the display state of the span with something like the 
>> following pseudo code:
>>
>> /*
>> * Set the display state of sought tags.
>> * @param root         the element whose descendants are examined
>> * @param tagname      the tag of the elements being sought
>> * @param classvalue   the class of elements being sought
>> *                     An empty classvalue means that all elements match.
>> * @param displayState "none" to hide, "inline" or "block" to show
>> */
>> function setState(root, tagName, classValue, displayState)
>> {
>>  // Get all the descendants of root having the desired tagName
>>  var elements = root.getElementsByTagName(tagName);
>>  for (var i=0; i < elements.length; i++)
>>  {
>>    var item = elements[i];
>>    // for those elements that match on classValue
>>    if (!classValue || item.className == classValue)
>>    {
>>      // set the state as desired.
>>      item.style.display = displayState;
>>    }
>>  }
>> }
>>
>> I have used something like this to manage a tree made from a nested 
>> list. If you find this interesting and want more details please ask.
>>
>> In His Service,
>>    DM
>>
>> Troy A. Griffitts wrote:
>>
>>> A first attempt at footnote / crossref support is available for 
>>> testing at:
>>>
>>> http://crosswire.org/study/passagestudy.jsp
>>>
>>> Notice 2 new tools on the right: Show [Footnotes | Cross-references]
>>>
>>> Your feedback is appreciated.
>>>
>>>
>>> _______________________________________________
>>> sword-devel mailing list: sword-devel at crosswire.org
>>> http://www.crosswire.org/mailman/listinfo/sword-devel
>>> Instructions to unsubscribe/change your settings at above page
>>>
>>>
>>
>> _______________________________________________
>> sword-devel mailing list: sword-devel at crosswire.org
>> http://www.crosswire.org/mailman/listinfo/sword-devel
>> Instructions to unsubscribe/change your settings at above page
> 
> 
> 
> _______________________________________________
> sword-devel mailing list: sword-devel at crosswire.org
> http://www.crosswire.org/mailman/listinfo/sword-devel
> Instructions to unsubscribe/change your settings at above page