Spec-Zone.ru › Hammerspoon

hs.doc.hsdocs

Управление веб-сервером внутренней документации.

Этот модуль предоставляет функции для управления встроенным веб-сервером документации Hammerspoon. В настоящее время это та же документация, что и в наборе документов Dash для Hammerspoon, но не требует стороннего программного обеспечения для просмотра.

В будущем рассматриваются следующие улучшения этого модуля:

  • Поддержка сторонних модулей для добавления в набор документации во время выполнения
  • Руководства и примеры «Как это сделать» на основе Markdown/HTML
  • Документация для LuaSkin Objective-C Framework
  • Документация по Lua

Цель этого подмодуля — предоставить максимально возможное соответствие отображению той же документации, доступной на сайте Hammerspoon GitHub и в документации Dash, подходящее для модификации во время выполнения, так что разработчики модулей могут тестировать добавления документации без необходимости полной перекомпиляции исходного кода Hammerspoon. Как всегда, самую последнюю и официальную документацию можно найти на сайте https://www.hammerspoon.org и в официальном наборе документов Hammerspoon Dash.

Обзор API

  • Функции — API-вызовы, предлагаемые непосредственно расширением
    • browserDarkMode
    • browserFrame
    • forceExternalBrowser
    • help
    • interface
    • moduleEntitiesInSidebar
    • port
    • start
    • stop
    • trackBrowserFrame

Документация API

Функции

browserDarkMode
Подпись hs.doc.hsdocs.browserDarkMode([value]) -> currentValue
Тип Функция
Описание

Получение или установка значения, определяющего, отображается ли вывод веб-браузера Hammerspoon в тёмном режиме.

Параметры
  • value — необязательный булево значение, число или nil, определяющие, отображается ли веб-браузер документации в тёмном режиме.
    • если значение равно true, HTML-вывод всегда будет инвертирован
    • если значение равно false, HTML-вывод никогда не будет инвертирован
    • если значение равно nil, вывод будет инвертирован только тогда, когда тема OS X установлена в тёмный режим
    • если значение — число от 0 до 100, оно определяет коэффициент инверсии, где 0 означает отсутствие инверсии, 100 — полную инверсию, а 50 — нечитаемый результат, потому что передняя и задняя части одинаково скорректированы.
Возвращаемые значения
  • текущее, возможно новое значение
Примечания
  • Инверсия применяется с помощью фильтра CSS, поэтому, хотя значения, отличные от 0 (false) и 100 (true), допускаются, результат обычно не тот, который ожидается.

  • Изменения, внесенные с помощью этой функции, сохраняются с помощью hs.settings с меткой "_documentationServer.invertDocs" и сохранятся при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 635
browserFrame
Подпись hs.doc.hsdocs.browserFrame([frameTable]) -> currentValue
Тип Функция
Описание

Получить или установить текущее сохранённое начальное расположение фрейма для браузера документации.

Параметры
  • frameTable - таблица фреймов, содержащая значения x, y, h и w, определяющие начальное положение браузера при запуске Hammerspoon.
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • Если hs.doc.hsdocs.trackBrowserFrame имеет значение false или nil (по умолчанию), то вы можете использовать эту функцию для указания начального положения браузера документации.

  • Если hs.doc.hsdocs.trackBrowserFrame имеет значение true, то любое значение, заданное этой функцией, будет перезаписано всякий раз, когда окно браузера перемещается или изменяет размер.

  • Внесённые изменения с помощью этой функции сохраняются с hs.settings с меткой "_documentationServer.browserFrame" и сохраняются при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 567
forceExternalBrowser
Подпись hs.doc.hsdocs.forceExternalBrowser([value]) -> currentValue
Тип Функция
Описание

Получить или установить, использует ли hs.doc.hsdocs.help внешний браузер.

Параметры
  • value - необязательное логическое значение или строка, по умолчанию false, определяющее, будут ли запросы документации отображаться во внешнем браузере или во внутреннем, обрабатываемом hs.webview.
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • Если это значение установлено в true, запросы справки, вызванные hs.doc.hsdocs.help, будут вызваны по умолчанию вашим системным обработчиком для http схемы.

  • Если это значение установлено в строку, строка определяет идентификатор пакета приложения, который будет использоваться для обработки запроса URL для документации. Строка должна совпадать с одним из элементов, возвращаемых hs.urlevent.getAllHandlersForScheme("http").

  • Это поведение срабатывает автоматически, независимо от этого параметра, если вы работаете с версией OS X до 10.10, так как hs.webview требует OS X 10.10 или новее.

  • Изменения, внесённые с помощью этой функции, сохраняются с hs.settings с меткой "_documentationServer.forceExternalBrowser" и сохраняются при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 663
help
Подпись hs.doc.hsdocs.help([identifier]) -> nil
Тип Функция
Описание

Отобразить документацию для указанной функции Hammerspoon или содержание для документации Hammerspoon в встроенном мини-браузере.

Параметры
  • необязательная строка, определяющая модуль, функцию или метод Hammerspoon для отображения документации. Если вы опустите этот параметр, будет отображено содержание документации Hammerspoon.
Возвращаемое значение
  • Нет
Исходный код extensions/doc/hsdocs/init.lua строка 532
interface
Подпись hs.doc.hsdocs.interface([interface]) -> currentValue
Тип Функция
Описание

Получить или установить сетевой интерфейс, на котором будет предоставляться веб-сервер документации Hammerspoon.

Параметры
  • interface - необязательная строка или nil, определяющая сетевой интерфейс, на котором будет предоставляться веб-сервер документации Hammerspoon. Явное nil указывает, что веб-сервер должен слушать на всех активных интерфейсах машины. По умолчанию "localhost".
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • См. hs.httpserver.setInterface для описания допустимых значений, которые могут быть указаны в качестве аргумента interface для этой функции.

  • Изменение интерфейса может произойти только тогда, когда сервер документации не запущен. Если сервер активен во время вызова этой функции с аргументом, сервер будет временно остановлен, а затем перезапущен после изменения интерфейса.

  • Изменения, внесённые с помощью этой функции, сохраняются с hs.settings с меткой "_documentationServer.interface" и сохраняются при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 409
moduleEntitiesInSidebar
Подпись hs.doc.hsdocs.moduleEntitiesInSidebar([value]) -> currentValue
Тип Функция
Описание

Получить или установить, отображается ли список сущностей модуля как столбец слева от рендерной страницы.

Параметры
  • value - необязательное логическое значение, определяющее, отображается ли список сущностей модуля в строке документации (false) или в боковой панели слева (true).
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • Это экспериментальная функция, по умолчанию отключена. Она была вдохновлена скриптом пользователя, написанным krasnovpro. Оригинал можно найти по адресу https://openuserjs.org/scripts/krasnovpro/hammerspoon.org_Documentation/source.

  • Изменения, внесённые с помощью этой функции, сохраняются с hs.settings с меткой "_documentationServer.entitiesInSidebar" и сохраняются при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 613
port
Подпись hs.doc.hsdocs.port([value]) -> currentValue
Тип Функция
Описание

Получить или установить HTTP порт сервера документации Hammerspoon.

Параметры
  • value - необязательное число, определяющее порт веб-сервера документации Hammerspoon
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • Номер порта по умолчанию 12345.

  • Изменения, внесённые с помощью этой функции, сохраняются с hs.settings с меткой "_documentationServer.serverPort" и сохраняются при перезагрузке или перезапуске Hammerspoon.

Исходный код extensions/doc/hsdocs/init.lua строка 453
END_OF_DOCUMENT_MARKER
Запуск
Подпись hs.doc.hsdocs.start() -> hs.doc.hsdocs
Тип Функция
Описание

Запустить веб-сервер внутренней документации Hammerspoon.

Параметры
  • Нет
Возвращаемое значение
  • таблица, представляющая модуль hs.doc.hsdocs
Примечания
  • Эта функция автоматически вызывается при необходимости, когда вызывается hs.doc.hsdocs.help.
  • Веб-сервер документации можно просмотреть в веб-браузере, перейдя по адресу "http://localhost:порт", где port — порт, на котором работает сервер, по умолчанию 12345 — см. hs.doc.hsdocs.port.
Исходный код extensions/doc/hsdocs/init.lua строка 479
Остановка
Подпись hs.doc.hsdocs.stop() -> hs.doc.hsdocs
Тип Функция
Описание

Остановить веб-сервер внутренней документации Hammerspoon.

Параметры
  • Нет
Возвращаемое значение
  • таблица, представляющая модуль hs.doc.hsdocs
Исходный код extensions/doc/hsdocs/init.lua строка 513
Отслеживание фрейма браузера
Подпись hs.doc.hsdocs.trackBrowserFrame([value]) -> currentValue
Тип Функция
Описание

Установить или получить, сохраняются ли изменения в местоположении и размере окна браузера документации при запуске Hammerspoon.

Параметры
  • value - необязательный boolean, определяющий, сохранять ли положение окна браузера при запуске Hammerspoon.
Возвращаемое значение
  • текущее, возможно новое, значение
Примечания
  • Изменения, внесенные с помощью этой функции, сохраняются с hs.settings с меткой "_documentationServer.trackBrowserFrameChanges" и сохранятся при перезагрузке или перезапуске Hammerspoon.
Исходный код extensions/doc/hsdocs/init.lua строка 593

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.doc.hsdocs.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API