Content referencing

[Davide Valsecchi]

I have an idea that could make this feature really interesting for users.

We should reproduce a sort of label/ref latex mechanism along all wiki
pages.
When a label it's create with our tag, the section of the page to which it
refers is saved in a table in db and made unique.
When another page use <content-ref label=> a link to the right content is
created, without the need of knowing the right page.

To make things neat we should use a sort of "scope" for labels. When
writing ref for a specific course the user should use a label like
"/coursename/label". Doing so, similar labels won't conflict and they will
be easier to use and categorize.

Then we can go further. Imagine a tool that read all the labels and made
them searchable. We could also add metadata to label tag and made this
information avaiable for queries. When someone wants to refer a theorem or
a specific part, he has only to query to check if an existing content
exists.

Alessandro, that could really interest you for semantics features.






2016-01-18 0:56 GMT+01:00 Russell Greene <russellgreene8 at gmail.com>:

>
>
> On Sun, Jan 17, 2016 at 4:48 PM Davide Valsecchi <
> valsecchi.davide94 at gmail.com> wrote:
>
>> Really good ideas! I have some comments to do
>>
>> 2016-01-18 0:19 GMT+01:00 Russell Greene <russellgreene8 at gmail.com>:
>>
>>> Hey all, last night I made an MediaWiki extension for doing content
>>> referencing. The idea is for this to be applied to figures, equations,
>>> anything that would want to be referenced back to later.
>>>
>>> Everything here is on the GitHub repo, under the branch
>>> ContentRefrencer, give it a try!
>>>
>>> Anything here is up for debate/change.
>>>
>>> *Motivation:*
>>>
>>> Reuse of content. This way one chapter that requires a certain proof or
>>> math equation, they can reference to there, where it is explained in more
>>> depth instead of explaining it again.
>>>
>>> *Syntax:*
>>>
>>> Currently there are two new tags, content and content-ref.
>>>
>>> Example:
>>>
>>> <content name="Quadratic Formula" id=1.0>
>>> <math> ... </math>
>>> </content>
>>>
>>>
>> I think that it would be better to use a label instead of a numerical id.
>> It would be remembered and referred easier.
>> Look at Latex ref/label, you are trying to recreate the same behavior.
>>
> Okay! That should be really easy. I'll push that in a minute.
>
>
>>
>>
>>> and then later
>>> <content-ref id=1.0>See Quadratic formula</content-ref>
>>>
>>> This will work for any <content> elements in that page. In order to
>>> reference to a different page, just add the page attribute to the
>>> <content-ref> element:
>>>
>>> <content-ref page="Physics/Quantum Mechanics" id=3>...</content-ref>
>>>
>>>
>> It works impressively! I see that for now it displays: "Figure: $name".
>> Why don't create a parameter for the type of reference? Like type=Figure or
>> type=math.
>>
>
> I totally agree. The "Figure: " was just for demonstration purposes.
>
>
>>
> *Features:*
>>>
>>> So as of right now, this is very simple, and could live in a template,
>>> but there are more options with an extension.
>>>
>>>
>> You know that we are using templates for theorems and definitions and so
>> on. Do you think that we could use your ref tag to create a link to them?
>> We can insert a label/id in the template, or maybe include automatically al
>> the content inside a <content> tag, but without your extension box. Maybe
>> the box could be optional?
>>
> One idea would be to include a <content> tag in the templates, so they can
> be referenced by a <content-ref>. This would keep the consistency that
> templates give, while also being referable.
>
>>
>>
>
>>
> *Hover*
>>> One feature I really want to figure out is showing the contents of the
>>> <content> tag when hovering over the corresponding <content-ref> tag. This
>>> would allow anyone to be able to see the content without even navigation
>>> outside the page.
>>>
>>> *dmath*
>>> One cool feature would to have support similar to this in the dmath tag,
>>> to make it easier to pass on to OCG.
>>>
>>
>> I think that for math we should pay a lot of attention. Maybe it would be
>> possible to insert a label inside dmath tag and then make reference to it
>> with your <content-ref> tag. Including math inside a <content> tag it's not
>> optimal because I don't know how we could make OCG recognize the link.
>>
>> We have full control over what the <dmath> tag does, so anything is
> possible. I am not familiar with how OCG works, so I would need someone to
> hold my hand through that.
>
>
>> I hope my suggestions could give you hints. I think that a general way to
>> ref things is excellent, but we have to integrate it also in templates and
>> math.
>>
>> What do you think?
>>
>>
>> Davide
>>
>>
>>>
>>> So what do you think? Is this something we need? Additional thoughts?
>>>
>>> -Russell
>>>
>>> _______________________________________________
>>> WikiToLearn-Tech mailing list
>>> WikiToLearn-Tech at kde.org
>>> https://mail.kde.org/mailman/listinfo/wikitolearn-tech
>>>
>>>
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/wikitolearn-tech/attachments/20160118/372eecb5/attachment.html>