Help:Настройка

From semantic-mediawiki.org
Jump to: navigation, search
Руководство администратора
Скачивание
Установка
Настройка
Кэширование концептов (англ.)
Красивые URI (англ.)
SPARQL и RDF-хранилище (англ.)
Устранение проблем (англ.)
Обновление данных SMW (англ.)
Расширения (англ.)
Расширения MediaWiki (англ.)
Семантические расширения (англ.)
Руководство пользователя

Semantic MediaWiki предлагает администратору множество настроек специально для того, чтобы можно было лучше приспособить вики для конкретных нужд. Параметры настройки являются обычными php-переменными и заносятся в файл LocalSettings.php после подключения SMW. На этой странице описаны все параметры настройки SMW версии 1.6.0 и выше. Все опции можно найти также в файле SMW_Settings.php в директории вашей SMW , однако не изменяйте этот файл в процессе настройки – все изменения будут затерты при обновлении версии движка.


Параметры установки

Следующие настройки относятся к установке SMW.

Параметр Описание
$smwgNamespaceIndex Если на вашем сайте уже есть дополнительные пространства имен, вставьте следующую строчку ПЕРЕД тем как подключать SMW в свой файл LocalSettings.php
$smwgNamespaceIndex = ???;

Число ??? должно быть наименьшим четным числом больше ста, которое до сих пор не использовалось для нумерования пространств имен. Еще раз обратите внимание, что эта настройка должны быть вставлена в LocalSettings.php до включения расширения SMW.

Значение по умолчанию: 100

$smwgEnableUpdateJobs Опция включает или выключает использование очереди заданий.

SMW использует очередь заданий MediaWiki (см.http://www.mediawiki.org/wiki/Manual:Job_queue) и каждый раз, когда пользователь редактирует страницу, исполняет несколько заданий из очереди. К примеру, если вы измените тип семантического свойства, то все страницы, на которых это свойство есть, должны будут обновлены. Задания на эти обновления будут добавлены в очередь задач. Данной опцией можно отключить использование очереди задач, например, если ваша вики генерирует слишком много задач. Однако, обратите внимание, что часть семантических данных в этом случае будет устаревать, так что вам рано или поздно придется воспользоваться скриптом SMW_refreshData.php.

Значение по умолчанию: true

$smwgLinksInValues Данная опция разрешает или запрещает использование ссылок внутри семантических свойств. Иными словами, должна ли SMW позволять пользователю вводить значения вида [[ололосвойство::текстик текст ссылкатекст текст]]? Будьте осторожны с этой настройкой – если она включена, это может привести к краху интерпретатора PHP, если длинные тексты будут использованы как значения семантических свойств. Это происходит из-за ограничений синтаксического анализатора библиотеки PCRE и клиенты будут получать ошибки сервера вида "invalid response" или же им будет предлагаться скачать файл "index.php".

Значение по умолчанию: false

$smwgUseCategoryHierarchy Должна ли SMW учитывать иерархию категорий при обработке ask-запросов? Если значение этой опции установлено в true, вложенные категории будут интерпретироваться как подклассы. Иными словами, если категория A является вложенной по отношению к категории B, то запрос всех страниц категории B даст нам в том числе страницы, помеченные категорией А. Если опция отключена, но вам хочется иногда использовать отношение класс-подкласс, это возможно с помощью зарезервированного семантического свойства Property:subcategory of, которое нужно поместить на страницу категории.

Значение по умолчанию: true

$smwgCategoriesAsInstances Должна ли SMW воспринимать страницы категорий, как вики-страницы? Пусть например, у нас есть категория [[Category:Foo]] и несколько страниц категорий, помеченных ей. Должны ли эти категориальные страницы считаться элементами категории Foo? См. также связанную опцию $smwgUseCategoryHierarchy.

Значение по умолчанию: true

$smwgNamespacesWithSemanticLinks В этой настройке можно указать, в каких пространствах имен разрешено использовать семантические аннотации. Вы можете переписать приведенный ниже массив и установить значение true в тех пространствах имен, где вы хотите, чтобы семантические аннотации учитывались системой. На всех пространствах имен со значением false семантические аннотации будут просто игнорироваться.

Значение по умолчанию:

$smwgNamespacesWithSemanticLinks = array(
	              NS_MAIN => true,
	              NS_TALK => false,
	              NS_USER => true,
	         NS_USER_TALK => false,
	           NS_PROJECT => true,
	      NS_PROJECT_TALK => false,
	             NS_IMAGE => true,
	        NS_IMAGE_TALK => false,
	         NS_MEDIAWIKI => false,
	    NS_MEDIAWIKI_TALK => false,
	          NS_TEMPLATE => false,
	     NS_TEMPLATE_TALK => false,
	              NS_HELP => true,
	         NS_HELP_TALK => false,
	          NS_CATEGORY => true,
	     NS_CATEGORY_TALK => false,
	     SMW_NS_PROPERTY  => true,
	SMW_NS_PROPERTY_TALK  => false,
	          SMW_NS_TYPE => true,
	     SMW_NS_TYPE_TALK => false,
	       SMW_NS_CONCEPT => true,
	  SMW_NS_CONCEPT_TALK => false,
);


Настройки интерфейса

Приведенные ниже настройки влияют на поведение, связанное с внешним видом вики-страниц SMW а также на интерфейсы для просмотра семантических аннотаций, таких как Область данных (Factbox) и страница Special:Browse.

Параметр Описание
$smwgShowFactbox Данная настройка управляет тем, когда SMW должна показывать область данных (Factbox) внизу страницы. Помните, что магические слова и позволяют вам принудительно скрыть или показать Область данных для каждой отдельно взятой страницы.

Возможные опции:

  • $smwgShowFactbox = SMW_FACTBOX_NONEMPTY; // показывать область данных только если на странице есть семантические аннотации (Область данных не пуста)
  • $smwgShowFactbox = SMW_FACTBOX_SPECIAL; // показывать Область данных только если на странице установлены специальные семантические свойства
  • $smwgShowFactbox = SMW_FACTBOX_HIDDEN; всегда скрывать Область данных
  • $smwgShowFactbox = SMW_FACTBOX_SHOWN; всегда показывать область данных. Некрасиво, глючит и настоятельно не рекомендуется


Значение по умолчанию: SMW_FACTBOX_HIDDEN

$smwgShowFactboxEdit Опция делает то же самое, что и $smwgShowFactbox , но для режима редактирования. Возможные значения – такие же как и у $smwgShowFactbox.

Значение по умолчанию: SMW_FACTBOX_NONEMPTY

$smwgToolboxBrowseLink Показывать ли ссылку на Special:Browse в панели инструментов (toolbox)?

Значение по умолчанию: true

$smwgInlineErrors Показывать ли предупреждения в тексте вики-страниц в случае, если возникли проблемы с семантическими аннотациями?

Значение по умолчанию: true

$smwgBrowseShowInverse Как показывать входящие ссылки в Special:Browse- используя их обратные ссылки (true) или просто показывая их с правой стороны(false)?

Значение по умолчанию: false

$smwgBrowseShowAll Нужно ли показывать семантические свойства, которые ссылаются НА обозреваемую страницу в Special:Browse

Значение по умолчанию: true

$smwgSearchByPropertyFuzzy При использовании служебной страницы search by property, должен ли поиск быть нечетким? Иными словами, должна ли SMW показывать результаты, которые близки к искомому значению? Выключите эту опцию, если страница search by properties тормозит.

Значение по умолчанию: true

$smwgTypePagingLimit Количество результатов, которое должно показываться на страницах пространства имен Type. На каждой странице этого пространства имен (например Type:String) показываются свойства этого типа. Данная опция как раз и управляет тем, сколько свойств должно показываться.

Значение по умолчанию: 200

$smwgConceptPagingLimit Количество результатов в списках на страницах пространства имен Concept.

Значение по умолчанию: 200

$smwgPropertyPagingLimit Количество результатов в списках на страницах пространства имен Property (Свойство).

Значение по умолчанию: 25

$smwgMaxPropertyValues Количество значений, показываемое в списке на страницах семантических свойств. Если вы хотите увеличить это значение, обратите внимание также на опцию $smwgPropertyPagingLimit, которая может помочь справиться с вопросами быстродействия.

Значение по умолчанию: 3

$smwgMaxNonExpNumber Максимальное число, которое следует показывать как есть, не используюя научную нотацю с exp. Возможно, если на вашей вики пользователи понимают экспоненциальную нотацию, стоит уменьшить это значение.

Значение по умолчанию: 1000000000000000

Настройки, относящиеся к запросам

Ниже описаны общие настройки, которые относятся к ask-запросам. Обратите на них особенное внимание, возможно они могут помочь вам решить проблемы, связанные с быстродействием встроенных запросов. Настройки влияют на все запросы, которые находятся на вики.

Параметр Описание
$smwgQEnabled Активирует и деактивирует возможности, связанные с семантическими запросами.

Значение по умолчанию: true

$smwgQMaxLimit Максимальное количество результатов, которое можно получить с помощью запроса. Это относится как к странице Special:Ask, так и к запросам, помещенных в текстах вики-статей.

Значение по умолчанию: 10000

$smwgQSubcategoryDepth Опция ограничивает глубину обхода иерархии вложенных категорий. Иными словами, оция регулирует то, насколько глубоко можно забираться во вложенные категории при ответе на ask-запросы. Вы можете поставить тут 0 и таким образом отключить вывод по иерархии категорий.

Значение по умолчанию: 10

$smwgQSubpropertyDepth Опция ограничивает глубину обхода иерархии семантических свойств. Похожа на smwgQMaxLimit. Можете сбросить эту опцию в ноль и таким образом отключить вывод по дереву свойств.

Значение по умолчанию: 10

$smwgQEqualitySupport Нужно ли интерпретировать перенаправления между различными страницами как эквивалентность между объектами, которые эти страницы представляютс? Возможные значения:
  • SMW_EQ_FULL Всегда интерпретировать перенаправления как отношение эквивалентности.
  • SMW_EQ_SOME Почти всегда интерпретировать перенаправления как отношение эквивалентности, оценивая трудоемкоть с точки зрения быстродействия. Процедура оценки зависит от типа хранилища.
  • SMW_EQ_NONE Никогда не считать перенаправления отношением эквивалентности.

Оратите внимание, что эта опция заработает только после нажатия кнопки восстановления данных в администраторской странице Semantic MediaWiki. Обратитесь к главе Repairing SMW за подробностями.

Значение по умолчанию: SMW_EQ_SOME

$smwgQSortingSupport Включает и отключает возможность сортировки результатов ask-запросов.

Значение по умолчанию: true

$smwgQRandSortingSupport Enables or disables the random sorting of query results.

Значение по умолчанию: true

$smwgQDefaultNamespaces При исполнении запросов, по каким пространствам имен система должна осуществлять поиск в первую очередь? Если установить эту опцию в NULL, будут сняты ограничения на поиск, что сделает систему чуть быстрее. Вот пример другой настройки:
array(NS_MAIN, NS_IMAGE)

Значение по умолчанию: NULL

$smwgQComparators Список возможных компараторов и масок (wildcards) компараторов и масок (wildcards), которые должен поддерживаться в языке запросов. Список оформляется разделенным вертикальной чертой '|'. Возможные элементы этого списка приведены ниже:
  • < (меньше либо равно)
  • > (больше либо равно)
  • << (строго меньше)
  • >> (строго больше)
  • ≤ (меньше либо равно - обратите внимание, что этот символ не относится к стандартному набору ASCII и поэтому с ним могут взникнуть проблемы - например, он может замениться вопросительным знаком или символом вроде â¤)
  • ≥ (больше либо равно - обратите внимание, что этот символ не относится к стандартному набору ASCII и поэтому с ним могут взникнуть проблемы - например, он может замениться вопросительным знаком или символом вроде â¥)
  •  ! (не равно)
  • ~ (удовлетворяет шаблону со звездочкой '*' в качестве wildcard. Работает только для данных типа String)
  •  !~ (не удовлетворяет шаблону со звездочкой '*' в качестве wildcard. Работает только для данных типа String)

Если в строке встретился компаратор, который не указан в данной опции, тогда этот компаратор будет восприниматься как обычный текст. Обратите внимание, что работа компараторов < и > зависит от значения оgции smwStrictComparators.

Значение по умолчанию: '<|>|!~|!|~|?|?|<<|>>'

$smwStrictComparators Включает и выключает строгое трактование символов компараторов.

Значение по умолчанию: false

$smwgIgnoreQueryErrors Должны ли семантические запросы исполняться несмотря на наличие ошибок? В лбом случае, сообщения об ошибках будут показываться.

Значение по умолчанию: true


Настройки встроенных запросов и спецстраницы Special:Ask

Приведенные настройки влияют на параметры исполнения встроенных запросов, а также на поведение страницы Special:Ask. Настройте эти параметры в соответсвии с размером вашей вики, требованияем к быстродействию и имеющимися вычислительными мощностями. .

Параметр Описание
$smwgQMaxSize Максимальное количество параметров отбора страниц. Use format=debug in inline queries for example sizes.

Значение по умолчанию: 12

$smwgQMaxDepth Максимальная глубина запроса. Например у запроса [[rel.rel2::Test]] глубина равна. Use format=debug in inline queries for example depth.

Значение по умолчанию: 4

$smwgQFeatures С помощью этой опции вы может настроить, какие типы ask-запросов разрешены к использованию, а какие нет.
  • SMW_PROPERTY_QUERY - для выражений вида [[property::...]],
  • SMW_CATEGORY_QUERY для выражений вида [[Category:...]],
  • SMW_CONCEPT_QUERY для выражений вида [[Concept:...]],
  • SMW_NAMESPACE_QUERY для выражений вида [[Namespace:+]],
  • SMW_CONJUNCTION_QUERY включает возможность комбинации нескольких выражений по отборус траниц в одном запросе,
  • SMW_DISJUNCTION_QUERY включает возможность использования конструкции OR или || в запросе,
  • SMW_ANY_QUERY включает любые типы запросов.

Эти возможности должны быть указаны в виде списка, разделенного вертикальной чертой |. Примеры:

  • $smwgQFeatures = SMW_CATEGORY_QUERY | SMW_CONJUNCTION_QUERY; для того, чтобы разрежить только запросы, отбирающие страницы, которые находятся в пересечении категорий
  • $smwgQFeatures = SMW_CONCEPT_QUERY; разрешает только использование запросов на концепты (в том числе с кэшированием)
  • $smwgQFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY; разрешает любые типы запросов, кроме использвания OR.

Значение по умолчанию: SMW_PROPERTY_QUERY | SMW_CATEGORY_QUERY | SMW_CONCEPT_QUERY | SMW_NAMESPACE_QUERY | SMW_CONJUNCTION_QUERY | SMW_DISJUNCTION_QUERY (разрешать все базовые возможности)

$smwgQMaxInlineLimit Максимальное число строк, которые печатаются в качестве результата запроса. Работает так как будто к каждому запросу приписывается опция limit=....

Значение по умолчанию: 500

$smwgQPrintoutLimit Maximal number of supported printouts (added columns in result table, ?-statements).

Значение по умолчанию: 100

$smwgAutoRefreshSubject Whether to automatically refresh pages after they stored semantic data, so queries for their own data immediately show the desired results. Either true or false.

Значение по умолчанию: true

Настройки запросов в концептах

Further settings for queries. The following settings affect queries that are part of concept pages. These are usually chosen to be less restricted than inline queries, since there are two other means for controlling their use:

  1. Concept queries that would not be allowed as normal queries will not be executed directly, but can use pre-computed results instead. This is the default. See Concept caching for details on how to exploit this.
  2. The whole Concept: namespace can be restricted (using some suitable MediaWiki extension) to an experienced user group that may create more complex queries resonably. Other users can employ thus defined concepts in their queries.
Параметр Описание
$smwgQConceptCaching Which concepts should be displayed only if available from cache? Possible values are:
  • CONCEPT_CACHE_ALL show concept elements anywhere only if they are cached,
  • CONCEPT_CACHE_HARD show without cache if concept is not harder than permitted inline queries, or
  • CONCEPT_CACHE_NONE show all concepts even without any cache.

In any case, caches will always be used if available (but see $smwgQConceptCacheLifetime).

Значение по умолчанию: CONCEPT_CACHE_HARD

$smwgQConceptMaxSize Same as $smwgQMaxSize but for concepts.

Значение по умолчанию: 20

$smwgQConceptMaxDepth Same as $smwgQMaxDepth but for concepts.

Значение по умолчанию: 8

$smwgQConceptFeatures Same as $smwgQFeatures but for concepts. Note that using concepts in concepts is currently not supported – do not enable it!

Значение по умолчанию: SMW_PROPERTY_QUERY | SMW_CATEGORY_QUERY | SMW_NAMESPACE_QUERY | SMW_CONJUNCTION_QUERY | SMW_DISJUNCTION_QUERY

$smwgQConceptCacheLifetime This setting defines the cache life time in minutes. If a concept cache exists but is older than this, SMW tries to recompute it, and will only use the cache if this is not allowed due to settings above.

Значение по умолчанию: 24 * 60 (= 1 day)

Настройки отображения результатов запроса

Параметр Описание
$smwgQDefaultLinking Какие колонки в результатах запроса должны быть в виде ссылок? Возможные значения: 'none' (никакие), 'subject' (только первая колонка), 'all' (все).

Значение по умолчанию: 'all'

$smwgQDefaultLimit Количество строк, по умолчанию возвращаемое запросов. Может быть задано явно с помощью параметра limit=... в запросе.

Значение по умолчанию: 50

$smwgResultFormats Здесь хранится массив всех допустимых форматов отображения результатов запроса, которые должны поддживатья в вики. Расширения, которые задают новые форматы, могут дописывать новые форматы в этот массив. Однако у вас есть возможность указать вручную, какие форматы вывода будут поддерижваться именно в вашей вики. Например, вы можете принудительно выключить поддержку одного из форматов дописав в LocalSettings.php строку
unset($smwgResultFormats['template']);//формат template будет выключен

В этом случае если кто-то попробует использовать выключенный формат в свое запросе, система просто проигнорирует его и выдаст результат, отформатированный по умолчанию. Форматы 'table' и 'list' не могут быть отключены. Формат 'broadtable' тоже не стоит отключать, т.к. это может поломать страницу Special:Ask.

Значение по умолчанию:

array(
	'table' => 'SMWTableResultPrinter',
	'list' => 'SMWListResultPrinter',
	'ol' => 'SMWListResultPrinter',
	'ul' => 'SMWListResultPrinter',
	'broadtable' => 'SMWTableResultPrinter',
	'category' => 'SMWCategoryResultPrinter',
	'embedded' => 'SMWEmbeddedResultPrinter',
	'template' => 'SMWListResultPrinter',
	'count' => 'SMWListResultPrinter',
	'debug' => 'SMWListResultPrinter',
	'rss' => 'SMWRSSResultPrinter',
	'csv' => 'SMWCsvResultPrinter',
	'dsv' => 'SMWDSVResultPrinter',
	'json' => 'SMWJSONResultPrinter',
	'rdf' => 'SMWRDFResultPrinter'
);

Настройки экспорта

Экспорт в RSS

Параметр Описание
$smwgRSSEnabled Опция включает и выключает экспорт в RSS.

Значение по умолчанию: true

$smwgRSSWithPages Должны ли RSS-потоки содержать целиком страницы(true), или лишь ссылки на них(false)?

Значение по умолчанию: true


Экспорт страниц в OWL/RDF

Параметр Описание
$smwgAllowRecursiveExport Могут ли обычные пользователи использовать рекурсивный экспорт в RDF/OWL? Под рекурсивным экспортом понимается, что при экспорте страницы, экпортируются также все страницы, связанные с ней и т.д. Включайте эту поцию только на небольших вики, иначе могут возникнуть проблемы с производительностью и опасность DoS-атак.

Значение по умолчанию: false

$smwgExportBacklinks Нужно ли включать в OWL/RDF экспорт страницы входящие в неё ссылки?

Значение по умолчанию: true

$smwgNamespace; Пространство имен для экспортируемых в RDF URI-идентификаторов. По умолчанию оно будет установлено автоматически, используя тот URL, который вы указали в строке enableSemantics(). Однако если вы хотите, чтобы ваши URL были симпатичнее на вид ( см. pretty URIs), ва нужно будет настроить перенаправления на вашем web-сервере и указать нужную строчку в тексте этой опции. Например, так сделано на веб-сайте semanticweb.org, где URI-идентификаторы экспортируется в форме http://semanticweb.org/id/FOAF. Вот пример того, что можно написать в значении этой опции:
$smwgNamespace = 'http://example.org/id/';

Значение по умолчанию: unset

Прочие настройки

Эти опции предназначены для тонкой настройки SMW и обычно не нуждаются в модификации.

Параметр Описание
$smwgPDefaultType Тип семантического свойства по умолчанию. Если вы не укажете тип свойства на его странице с помощью выражения has type, то свойство будет автоматически иметь тип, указанный в данной опции . В качестве значения опции нужно задать идентификатор типа, который можно посмотреть в файле languages/SMW_LanguageXX.php. По умолчанию свойства имеют тип Страница.

Значение по умолчанию: '_wpg' (соответствует типу Страница)

$smwgDefaultStore Использовать альтернативное хранилище для семантических свойств. Вы можете установить эту опцию в значение 'SMWSparqlStore' (см. ниже)

Значение по умолчанию: 'SMWSQLStore2'

$smwgSparqlDatabase Configure SPARQL database connection for Semantic MediaWiki. This is used when SPARQL-based features are enabled, e.g. when using 'SMWSparqlStore' as the $smwgDefaultStore.

Значение по умолчанию: 'SMWSparqlDatabase'

$smwgSparqlQueryEndpoint Configure SPARQL database connection for Semantic MediaWiki. This is used when SPARQL-based features are enabled. Endpoint (service URL) for queries (reading queries like SELECT). This endpoint is neccessary.

Значение по умолчанию: 'http://localhost:8080/sparql/'

$smwgSparqlUpdateEndpoint Configure SPARQL database connection for Semantic MediaWiki. This is used when SPARQL-based features are enabled. Endpoint (service URL) for updates (SPARQL Update queries). Can be omitted if not supported.

Значение по умолчанию: 'http://localhost:8080/update/'

$smwgSparqlDataEndpoint Configure SPARQL database connection for Semantic MediaWiki. This is used when SPARQL-based features are enabled. Endpoint (service URL) for data (SPARQL HTTP Protocol for Graph Management) Can be omitted if not supported.

Значение по умолчанию: 'http://localhost:8080/data/'

$smwgTranslate Setting this to true allows to translate all the labels within Special:Browse given that they have interwiki links. This feature is currently disabled and cannot be activated with this setting.

Значение по умолчанию: false

$smwgAdminRefreshStore If the following is set to true, the wiki data can be repaired using the interface on the page Special:SMWAdmin. Setting this option to false does not stop ongoing repair processes.

Значение по умолчанию: true

$smwgHistoricTypeNamespace If the following is set to true, you can still access the old namespaces Type (104) and Type_talk (105) which have been replaced by Special:Types and are thus obsolete starting with SMW 1.6.0.

Значение по умолчанию: false


Эта страница относится ко всем версиям SMW, начиная с версии 1.6.0 вплоть до самой последней версии.
      Другие языки : deen

Help:Configuration ru 1.6.0