On 01/03/2011 18:54, Benedikt Kaempgen wrote:
> Great idea.
> Maybe, it would be good to have a small introduction to the way SMW is integrated into MW, answering questions like
> * When does SMW come into play if MW is run?
> * What hooks are used?
> * What parsers are extended?
> * What globals are needed?
Some of this might go a bit far into the implementation details to be
part of a first architecture overview. But I plan to say some words
about the whole hook/parsing business an the architecture page.
> PS: Can someone tell me: Why does SMWDataValue not have a method getProperty()?
Because it does not have a property. A datavalue is really exactly what
is explained on the architecture page: a single value. It represents a
number or a wikipage, or whatever. But a property has nothing to do with
it (unless the value itself is a property, but this is not what you
mean, I think). Semantic statements in SMW a built by combining values.
So values are part of the statement, not the other way around.
> Karlsruhe Institute of Technology (KIT)
> Institute of Applied Informatics and Formal Description Methods (AIFB)
> Benedikt Kämpgen
> Research Associate
> Kaiserstraße 12
> Building 11.40
> 76131 Karlsruhe, Germany
> Phone: +49 721 608-47946 (!new since 1 January 2011!)
> Fax: +49 721 608-46580 (!new since 1 January 2011!)
> Email: benedikt.kaempgen@...
> Web: http://www.kit.edu/
> KIT - University of the State of Baden-Wuerttemberg and
> National Research Center of the Helmholtz Association
> -----Original Message-----
> From: Yury Katkov [mailto:katkov.juriy@...]
> Sent: Friday, February 25, 2011 3:11 PM
> To: Markus Krötzsch
> Cc: SMW developer list
> Subject: Re: [SMW-devel] documentation, entry points, interface classes
> Thank you very much, Markus! Architecture guide provides much help
> even being incomplete! I'll do my best to improve it after becoming
> more proficient with SMW development.
> Speaking about examples, I think that the best documentation in the
> world is Qt Assistant in the Qt framework  - and because of this
> the library is so much popular among C++ and Python GUI developers.
> Each class of the library has the examples of its usage; they also
> provide rich (but comprehensive) example applications where one can
> see the way many Qt-classes interact.
> The SMW community can add useful examples of solving typical tasks on
> the official SMW wiki - I'm sure it improves the documentation very
>  http://doc.qt.nokia.com/4.6/index.html
> On Thu, Feb 24, 2011 at 1:40 PM, Markus Krötzsch
> <markus@...> wrote:
>> On 24/02/2011 09:41, Yury Katkov wrote:
>>> Hello everyone!
>>> I'm trying to make Semantic MediaWiki extension and observing the
>>> documentation. I checked the Programmer Guide  and found that only
>>> the Doxygen documentation is currently available. Here are some questions:
>>> 1) Are there any very small example extensions available, whether or
>>> not some tutorials exist?
>>> 2) What are the main entry points to the code? For example, how can I
>>> add a numeric property Age with value 27 to the page User:Paul? Should I
>>> use SMWDataValueFactory? Or another example: what classes are to be used
>>> when I want to make an #ask query in my PHP code?
>>> 3) What classes are interfaces for extension developers and what classes
>>> belongs to the SMW core and should not be used by us?
>>> Hopefully after figuring out the answers to these questions I will able
>>> to improve the current documentation and it will make the life of other
>>> newbie extension developers easier.
>> Hi Yury,
>> by a happy coincidence I have just realized that we are lacking a good starting point for understanding SMW's architecture, and I have started to write a suitable documentation . It is still incomplete, but I hope I can add further information within the next week.
>> I agree that this is important to have, not only for helping people to get started but also to reduce the effort we have in aligning contributions with what we intend SMW to be. PHP is not very good for communicating architecture through code alone ;-)
>> I also second your call for examples but there are so many ways in which to extend SMW that it is hard to come up with example code that is of general interest. Maybe we could build a collection of LocalSettings.php code snippets that show how some functions can be extended (e.g. how to register a new datatype, how to add a sidebar item that shows a property value for the given page, etc.)
>>  http://semantic-mediawiki.org/wiki/Architecture_guide#
> Yury V. Katkov
> Laboratory of intelligent systems
> of the Saint-Petersburg National University of Information
> Technologies, Mechanics and Optics, Russia
> Free Software Download: Index, Search& Analyze Logs and other IT data in
> Real-Time with Splunk. Collect, index and harness all the fast moving IT data
> generated by your applications, servers and devices whether physical, virtual
> or in the cloud. Deliver compliance at lower cost and gain new business
> insights. http://p.sf.net/sfu/splunk-dev2dev
> Semediawiki-devel mailing list