Help:Настройка
Semantic MediaWiki предлагает администратору множество настроек специально для того, чтобы можно было лучше приспособить вики для конкретных нужд. Параметры настройки являются обычными php-переменными и заносятся в файл LocalSettings.php после подключения SMW. На этой странице описаны все параметры настройки SMW версии 1.6.0 и выше. Все опции можно найти также в файле SMW_Settings.php в директории вашей SMW , однако не изменяйте этот файл в процессе настройки – все изменения будут затерты при обновлении версии движка.
Contents
Параметры установки[edit]
Следующие настройки относятся к установке SMW.
| Параметр | Описание |
|---|---|
| $smwgNamespaceIndex | Если на вашем сайте уже есть дополнительные пространства имен, вставьте следующую строчку ПЕРЕД тем как подключать SMW в свой файл LocalSettings.php
$smwgNamespaceIndex = ???;
Число ??? должно быть наименьшим четным числом больше ста, которое до сих пор не использовалось для нумерования пространств имен. Еще раз обратите внимание, что эта настройка должны быть вставлена в LocalSettings.php до включения расширения SMW. Значение по умолчанию: 100 |
| $smwgEnableUpdateJobs | Опция включает или выключает использование очереди заданий.
SMW использует очередь заданий MediaWiki (см.https://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, ); |
Настройки интерфейса[edit]
Приведенные ниже настройки влияют на поведение, связанное с внешним видом вики-страниц SMW а также на интерфейсы для просмотра семантических аннотаций, таких как Область данных (Factbox) и страница Special:Browse.
| Параметр | Описание |
|---|---|
| $smwgShowFactbox | Данная настройка управляет тем, когда SMW должна показывать область данных (Factbox) внизу страницы. Помните, что магические слова и позволяют вам принудительно скрыть или показать Область данных для каждой отдельно взятой страницы.
Возможные опции:
|
| $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 |
Настройки, относящиеся к запросам[edit]
Ниже описаны общие настройки, которые относятся к ask-запросам. Обратите на них особенное внимание, возможно они могут помочь вам решить проблемы, связанные с быстродействием встроенных запросов. Настройки влияют на все запросы, которые находятся на вики.
| Параметр | Описание |
|---|---|
| $smwgQEnabled | Активирует и деактивирует возможности, связанные с семантическими запросами.
Значение по умолчанию: true |
| $smwgQMaxLimit | Максимальное количество результатов, которое можно получить с помощью запроса. Это относится как к странице Special:Ask, так и к запросам, помещенных в текстах вики-статей.
Значение по умолчанию: 10000 |
| $smwgQSubcategoryDepth | Опция ограничивает глубину обхода иерархии вложенных категорий. Иными словами, оция регулирует то, насколько глубоко можно забираться во вложенные категории при ответе на ask-запросы. Вы можете поставить тут 0 и таким образом отключить вывод по иерархии категорий.
Значение по умолчанию: 10 |
| $smwgQSubpropertyDepth | Опция ограничивает глубину обхода иерархии семантических свойств. Похожа на smwgQMaxLimit. Можете сбросить эту опцию в ноль и таким образом отключить вывод по дереву свойств.
Значение по умолчанию: 10 |
| $smwgQEqualitySupport | Нужно ли интерпретировать перенаправления между различными страницами как эквивалентность между объектами, которые эти страницы представляютс? Возможные значения:
Оратите внимание, что эта опция заработает только после нажатия кнопки восстановления данных в администраторской странице 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), которые должен поддерживаться в языке запросов. Список оформляется разделенным вертикальной чертой '|'. Возможные элементы этого списка приведены ниже:
Если в строке встретился компаратор, который не указан в данной опции, тогда этот компаратор будет восприниматься как обычный текст. Обратите внимание, что работа компараторов < и > зависит от значения оgции smwStrictComparators. Значение по умолчанию: '<|>|!~|!|~|?|?|<<|>>' |
| $smwStrictComparators | Включает и выключает строгое трактование символов компараторов.
Значение по умолчанию: false |
| $smwgIgnoreQueryErrors | Должны ли семантические запросы исполняться несмотря на наличие ошибок? В лбом случае, сообщения об ошибках будут показываться.
Значение по умолчанию: true |
Настройки встроенных запросов и спецстраницы Special:Ask[edit]
Приведенные настройки влияют на параметры исполнения встроенных запросов, а также на поведение страницы 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 | 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 |
Настройки запросов в концептах[edit]
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:
- 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.
- 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:
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) |
Настройки отображения результатов запроса[edit]
| Параметр | Описание |
|---|---|
| $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'
);
|
Настройки экспорта[edit]
Экспорт в RSS[edit]
| Параметр | Описание |
|---|---|
| $smwgRSSEnabled | Опция включает и выключает экспорт в RSS.
Значение по умолчанию: true |
| $smwgRSSWithPages | Должны ли RSS-потоки содержать целиком страницы(true), или лишь ссылки на них(false)?
Значение по умолчанию: true |
Экспорт страниц в OWL/RDF[edit]
| Параметр | Описание |
|---|---|
| $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 |
Прочие настройки[edit]
Эти опции предназначены для тонкой настройки 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 |
