Documentation/OHITool: Unterschied zwischen den Versionen

Aus Semantic CorA
Wechseln zu: Navigation, Suche
(42 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 18: Zeile 18:
 
|php          =
 
|php          =
 
|license      = MIT
 
|license      = MIT
|download      = {{TNT|WikimediaDownload|OfflineImportLexicon}}
+
|download      = external [https://smw-cora.org/index.php/File:OHI.zip zip file]
 
|needs-updatephp = No
 
|needs-updatephp = No
 
|readme        =
 
|readme        =
Zeile 29: Zeile 29:
 
}}
 
}}
  
The '''OfflineImportLexicon''' extension is an extension for [[Extension:Semantic_MediaWiki|Semantic MediaWiki]] that provides a user interface that allows to create wiki pages following hierarchical book's structure: book, volume, article, physical representation of book page as image. Entities are:
+
The '''OHITool''' extension is an extension used in a Virtual Research Environmen based on  Semantic MediaWiki and allows reaserchers to carry out Qualitative Analysis of social interaction using Objective Hermeneutical methodology. The extension particularly has been tailored to be use  for classroom interaction analysis.  
 
 
* Book (Lexicon)
 
* Volume
 
* Article (Lemma)
 
* Page as images.
 
  
 
It was developed within the research project [http://www.dipf.de/en/projects/virtual-research-environment-for-research-in-the-history-of-education-smw-cora?set_language=en SMW-CorA] and funded by the [http://www.dfg.de/ DFG].
 
It was developed within the research project [http://www.dipf.de/en/projects/virtual-research-environment-for-research-in-the-history-of-education-smw-cora?set_language=en SMW-CorA] and funded by the [http://www.dfg.de/ DFG].
  
 
== Download ==
 
== Download ==
 +
 +
Download the [https://smw-cora.org/index.php/File:OHI.zip zip file] and extract it to the folder of your MediaWiki installation, unter the folder ''extensions''.
  
 
{{TNT|WikimediaGitCheckout}}
 
{{TNT|WikimediaGitCheckout}}
Zeile 44: Zeile 41:
 
== Installation ==
 
== Installation ==
  
{{TNT|note}} This extension requires [[Extension:Semantic MediaWiki|Semantic MediaWiki]] to be installed first.
+
{{TNT|note}} This extension requires [https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki Semantic MediaWiki],
 +
[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki Semantic Result Formats] and [https://www.mediawiki.org/wiki/Extension:Header_Tabs Header Tabs] to be installed first.
 +
 
 +
Please edit the file '''LocalSettings.php''' and add the following line:
 +
 
 +
require_once( "$IP/extensions/OHI/OHI.php" );
 +
 
 +
The extension will be installed under the Section '''Other special pages''' of  Special:SpecialPages, under the name '''Objective Hermeneutic Interpretor Tool'''.
 +
 
 
{{TNT|ExtensionInstall}}
 
{{TNT|ExtensionInstall}}
 +
 +
== Usage ==
 +
 +
This is a brief introduction on how to use the OHITool. A more detailed guide will appear on this page in the near future.
 +
 +
'''Important'''. After the installation, in the extension folder, there is a folder ''OHI/resources/templates''. A .XML file contaning templates, forms and semantic properties could be automatically created using [[Special:Import|Special:Import]] procedure of MediaWiki. The import will create also a complet exaple of a transcript, in the main namespace, under the ''Neu_Ethik_Klasse6_Fremdsein_apaek02152'' name.
 +
 +
In order to start a new transcript, please call special page '''Formular:Erhebungsmaterial_Metadaten''', if your wiki is in German, otherwise call '''Form:Erhebungsmaterial_Metadaten''' (for English). After you collect the transcript data and save the formular, you should see the following interface:
 +
 +
[[File:OHITool1.jpg|600px]]
 +
 +
An explanation for abbreviation used by tool is here (German version): [[Documentation/OHITool/Help|Help]].
 +
 +
=== List of Templates and Forms ===
 +
 +
==== Templates ====
 +
 +
#Erhebungsmaterial Metadaten
 +
#Extension DPL
 +
#Fallstrukturanalyse
 +
#ShowText
 +
#Show Metadata
 +
#StoreFallstrukturanalyse
 +
#StoreFallstrukturhypothese
 +
#TextAnnotation
 +
#TextAnnotationLevel2
 +
#TextAnnotationLevel3
 +
#TextAnnotationNew
 +
#Transkript
 +
#Transkript kurz
 +
#Zeige Metadata
 +
 +
==== Forms ====
 +
#Erhebungsmaterial Metadaten
 +
#Erhebungsmaterial Metadaten 2
 +
#Fallstrukturanalyse
 +
#Linkliste
 +
#Medien
 +
#TextAnnotation
 +
 +
=== About Objective Hermeneutic method ===
 +
For an extensive information about Objective Hermeneutic method, please consult [http://opensym.lero.ie/wp-content/uploads/2017/08/a10-veja.pdf SMW based VRE for addressing multi-layered data analysis: The use case of classroom interaction interpretation], [https://dh2017.adho.org/abstracts/DH2017-abstracts.pdf#page=580 Interfacing collaborative and multiple-layered spaces of interpretation in humanities research: The case of semantically-enhanced objective hermeneutics.] and [http://www.qualitative-research.net/index.php/fqs/article/view/21/46 Competence and Praxis: Sequential Analysis in German Sociology] (in English).
 +
 +
In the following picture we present the ontology of classroom interaction:
 +
 +
[[File:Ontology.jpg|600px]]
 +
 +
Also, the researcher will follow the Objective Hermeneutic protocol, as in the picture:
 +
 +
[[File:Workflow.png|600px]]
 +
 +
You may also consult the presentation of the talk given at the OpenSym'17 conference in Galway, Ireland:
 +
 +
[https://semantic-cora.org/index.php/File:SMW_VRE_for_multi-layered_data_analysis.pdf SMW Based VRE for Addressing Multi-Layered Data Analysis – The Use Case of Classroom Interaction Interpretation].
 +
 +
=== Known issues ===
 +
*This tool is usually required in German space, due the fact that it was a genuine German idea. This is the reason that properties, templates
 +
and interface is in German. For the next version, we plan to have an English version also.
 +
*The Header Tabs extension is incompaticle with '''Tweeki''' skin. See: [https://www.mediawiki.org/wiki/Extension:Header_Tabs#Incompatible_extensions_and_skins Incompatible extensions and skins]. It would be recommendable to use [https://www.mediawiki.org/wiki/Skin:Vector Vector skin], or [[Cora_Skin_implementation|Cora skin]] instead.
 +
*If you find a bug, please report it on the [[Extension_talk:OHITool|discussion page]].
 +
 +
===Citation===
 +
If you use our software, we would be really happy if you cite our work like this:  Kminek, H., Meier, M., Hocker, J. Veja, L., Schindler, C, Sticht, K. (2018). OHTool:  Extension for Objective Hermeneutics for Semantic MediaWiki [Software]. Online available at: https://semantic-cora.org/index.php/Documentation/OHITool
 +
 +
[[Category:Semantic MediaWiki extensions]][[Category:Documentation]]

Version vom 7. November 2018, 12:23 Uhr

OHI Tool

Vorlage:TNT

The OHITool extension is an extension used in a Virtual Research Environmen based on Semantic MediaWiki and allows reaserchers to carry out Qualitative Analysis of social interaction using Objective Hermeneutical methodology. The extension particularly has been tailored to be use for classroom interaction analysis.

It was developed within the research project SMW-CorA and funded by the DFG.

Download

Download the zip file and extract it to the folder of your MediaWiki installation, unter the folder extensions.

Vorlage:TNT

Installation

Vorlage:TNT This extension requires Semantic MediaWiki, Semantic Result Formats and Header Tabs to be installed first.

Please edit the file LocalSettings.php and add the following line:

require_once( "$IP/extensions/OHI/OHI.php" );

The extension will be installed under the Section Other special pages of Special:SpecialPages, under the name Objective Hermeneutic Interpretor Tool.

Vorlage:TNT

Usage

This is a brief introduction on how to use the OHITool. A more detailed guide will appear on this page in the near future.

Important. After the installation, in the extension folder, there is a folder OHI/resources/templates. A .XML file contaning templates, forms and semantic properties could be automatically created using Special:Import procedure of MediaWiki. The import will create also a complet exaple of a transcript, in the main namespace, under the Neu_Ethik_Klasse6_Fremdsein_apaek02152 name.

In order to start a new transcript, please call special page Formular:Erhebungsmaterial_Metadaten, if your wiki is in German, otherwise call Form:Erhebungsmaterial_Metadaten (for English). After you collect the transcript data and save the formular, you should see the following interface:

OHITool1.jpg

An explanation for abbreviation used by tool is here (German version): Help.

List of Templates and Forms

Templates

  1. Erhebungsmaterial Metadaten
  2. Extension DPL
  3. Fallstrukturanalyse
  4. ShowText
  5. Show Metadata
  6. StoreFallstrukturanalyse
  7. StoreFallstrukturhypothese
  8. TextAnnotation
  9. TextAnnotationLevel2
  10. TextAnnotationLevel3
  11. TextAnnotationNew
  12. Transkript
  13. Transkript kurz
  14. Zeige Metadata

Forms

  1. Erhebungsmaterial Metadaten
  2. Erhebungsmaterial Metadaten 2
  3. Fallstrukturanalyse
  4. Linkliste
  5. Medien
  6. TextAnnotation

About Objective Hermeneutic method

For an extensive information about Objective Hermeneutic method, please consult SMW based VRE for addressing multi-layered data analysis: The use case of classroom interaction interpretation, Interfacing collaborative and multiple-layered spaces of interpretation in humanities research: The case of semantically-enhanced objective hermeneutics. and Competence and Praxis: Sequential Analysis in German Sociology (in English).

In the following picture we present the ontology of classroom interaction:

Ontology.jpg

Also, the researcher will follow the Objective Hermeneutic protocol, as in the picture:

Workflow.png

You may also consult the presentation of the talk given at the OpenSym'17 conference in Galway, Ireland:

SMW Based VRE for Addressing Multi-Layered Data Analysis – The Use Case of Classroom Interaction Interpretation.

Known issues

  • This tool is usually required in German space, due the fact that it was a genuine German idea. This is the reason that properties, templates

and interface is in German. For the next version, we plan to have an English version also.

Citation

If you use our software, we would be really happy if you cite our work like this: Kminek, H., Meier, M., Hocker, J. Veja, L., Schindler, C, Sticht, K. (2018). OHTool: Extension for Objective Hermeneutics for Semantic MediaWiki [Software]. Online available at: https://semantic-cora.org/index.php/Documentation/OHITool