weso / wikibase-sync

Python library to synchronise data between RDF files and Wikibase instances.
MIT License
8 stars 3 forks source link

Example #10

Open kerphi opened 3 years ago

kerphi commented 3 years ago

Hello,

I'm a bit lost and I wonder if a basic usage example could be added to the README?

Maybe showing a simple RDF file for the first step, then the program using wbsync to convert the RDF to wikibase, then the result into wikibase, maybe with a screenshot showing the few generated Property/Item.

Thanks a lot for the good work.

mistermboy commented 3 years ago

Hi @kerphi! Thanks for your comment.

There is README with an example in wbsync and in rdfsync. I´m afraid there is not any screenshot of the results yet but hopefully, there will be soon.

If you need any help, please let us know :)

kerphi commented 3 years ago

Thanks for your quick answer.

The example in https://github.com/weso/wikibase-sync/tree/master/wbsync is a bit strange for me. I don't understand the source_content and target_content idea?

Moreover maybe putting a real RDF could help more because "original rdf content goes here" don't help to understand.

However i'not a RDF and wikibase expert so it's also hard for me to get the big picture.

And maybe you know ? But this link to the notebook is a 404:

Additional examples about synchronizing RDF files with a Wikibase instance can be seen in the Synchronization notebook https://github.com/weso/wikibase-sync/blob/master/wbsync/notebooks/Synchronization.ipynb .

mistermboy commented 3 years ago

wbsync receives the RDF data before and after the modifications. For example, if you want to synchronize for the first time a RDF file with a wikibase instance the source_content must be empty (because it´s the first time) and the target_content must be the content of the file. After setting that, wbsync calculates the differences between the original_content and the target_content in order to know which operations are needed to make the wikibase instance consistent with the RFD file.

About the notebook link I didn´t know about it, thanks!

kerphi commented 3 years ago

Ok thanks a lot. That is more clear.

One more question: should the RDF respect a specific model to match wikibase model? Or is it possible to import any RDF then a specific mapping is maybe needed?

mistermboy commented 3 years ago

Mmmm I´m not sure at all but I think wbsync deals with the mappings between the RDF and the Wikibase, so you don´t need to look for it.

Maybe @alejgh knows more about it

almereyda commented 1 year ago

There is also https://github.com/HerculesCRUE/ib-hercules-sync which can act as an example on how to use this library.