Предохранитель уго: Предохранители. ГОСТ 2.727

Условные обозначения в различных электрических схемах

Выборка материалов из ГОСТ, имеющих отношение к размерам изображений условных графических обозначений элементов электрических схем.

Все изображения вставлены из ГОСТ без изменений.

Блок: 1/12 | Кол-во символов: 189
Источник: https://elektroshema.ru/2009-02-05-22-57-45/ugo-1.html

Нормативные документы

Учитывая большое количество электроэлементов, для их буквенно-цифровых (далее БО) и условно графических обозначений (УГО) был разработан ряд нормативных документов исключающих разночтение. Ниже представлена таблица, в которой представлены основные стандарты.

Таблица 1. Нормативы графического обозначения отдельных элементов в монтажных и принципиальных электрических схемах.

Следует учитывать, что элементная база со временем меняется, соответственно вносятся изменения и в нормативные документы, правда это процесс более инертен. Приведем простой пример, УЗО и дифавтоматы широко эксплуатируются в России уже более десятка лет, но единого стандарта по нормам ГОСТ 2.755-87 для этих устройств до сих пор нет, в отличие от автоматических выключателей. Вполне возможно, в ближайшее время это вопрос будет урегулирован. Чтобы быть в курсе подобных нововведений, профессионалы отслеживают изменения в нормативных документах, любителям это делать не обязательно, достаточно знать расшифровку основных обозначений.

Блок: 2/5 | Кол-во символов: 1696
Источник: https://www.asutpp.ru/uslovnye-oboznachenija-v-jelektricheskih-shemah.html

1. Общие правила построения обозначений контактов

1. Общие правила построения обозначений контактов

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

1.2. Контакты коммутационных устройств состоят из подвижных и неподвижных контакт-деталей.

1.3. Для изображения основных (базовых) функциональных признаков коммутационных устройств применяют условные графические обозначения контактов, которые допускается выполнять в зеркальном изображении:

1.4. Для пояснения принципа работы коммутационных устройств при необходимости на их контакт-деталях изображают квалифицирующие символы, приведенные в табл.1.

Таблица 1

Примечание. Обозначения, приведенные в пп.1-4, 7-9 настоящей таблицы, помещают на неподвижных контакт-деталях, а обозначения в пп.5 и 6 — на подвижных контакт-деталях.

Блок: 2/11 | Кол-во символов: 1277
Источник: http://docs.cntd.ru/document/464625462

Виды электрических схем

В соответствии с нормами ЕСКД под схемами подразумеваются графические документы, на которых при помощи принятых обозначений отображаются основные элементы или узлы конструкции, а также объединяющие их связи. Согласно принятой классификации различают десять видов схем, из которых в электротехнике, чаще всего, используется три:

• Функциональная, на ней представлены узловые элементы (изображаются как прямоугольники), а также соединяющие их линии связи. Характерная особенность такой схемы – минимальная детализация. Для описания основных функций узлов, отображающие их прямоугольники, подписываются стандартными буквенными обозначениями. Это могут быть различные части изделия, отличающиеся функциональным назначением, например, автоматический диммер с фотореле в качестве датчика или обычный телевизор. Пример такой схемы представлен ниже. Пример функциональной схемы телевизионного приемника
• Принципиальная. Данный вид графического документа подробно отображает как используемые в конструкции элементы, так и их связи и контакты. Электрические параметры некоторых элементов м

Что обозначает sb1 на электрической схеме. Буквенные обозначения элементов на электрических схемах

Условные графические обозначения коммутационных изделий — выключателей, тумблеров, электрических реле построены на базе знаков контактов: замыкающих (рис. 1, б), размыкающих (в, г) и переключающих (г, е). Контакты, сразу замыкающие либо размыкающие две цепи, обозначают, как показано на рис. 1, (ж, и и).

За начальное положение замыкающих контактов на электронных схемах принято разомкнутое состояние коммутируемой электронной цепи, размыкающих — замкнутое, переключающих — положение, в каком одна из цепей замкнута, другая разомкнута (исключение составляет контакт с нейтральным положением). УГО всех контактов допускается изображать исключительно в зеркальном либо повернутом на 90° положениях.

Стандартизованная система УГО предугадывает отражение и таких конструктивных особенностей, как неодновременность срабатывания 1-го либо нескольких контактов в группе, отсутствие либо наличие фиксации их в одном из положений.

Рис. 1

Рис. 2

Так, если нужно показать, что контакт замыкается либо размыкается ранее других, знак его подвижной части дополняют маленьким штрихом, направленным в сторону срабатывания (рис. 2, а, б), а если позднее, — штрихом, направленным в оборотную сторону (рис. 2, в, г).

Отсутствие фиксации в замкнутом либо разомкнутом положениях (самовозврат) обозначают маленьким треугольником, верхушка которого ориентирована в сторону начального положения подвижкой части контакта (рис. 2, д, е), а фиксацию — кружком на знаке его недвижной части (рис. 2, ж, и).

Последние два УГО на электронных схемах употребляют в тех случаях, если нужно показать разновидность коммутационного изделия, контакты которого этими качествами обычно не владеют.

Условное графическое обозначение выключателей на электронных схемах (рис. 3) строят на базе знаков замыкающих и размыкающих контактов. При всем этом имеется в виду

Найдите свой веб-сайт Hugo

Статический веб-сайт с функцией динамического поиска? Да, Hugo предоставляет альтернативу встраиваемым скриптам из Google или других поисковых систем для статических веб-сайтов. Hugo позволяет вам предоставлять вашим посетителям настраиваемую функцию поиска, напрямую индексируя файлы содержимого.

• GitHub Gist для рабочего процесса Hugo. Эта суть содержит простой рабочий процесс для создания поискового индекса для вашего статического веб-сайта. Он использует простой скрипт Grunt для индексации всех ваших файлов содержимого и lunr.js для обслуживания результатов поиска.
• hugo-elasticsearch. Создавайте индексы Elasticsearch для статических сайтов Hugo, анализируя первичный материал. Hugo-Elasticsearch сгенерирует файл JSON с разделителями новой строки (NDJSON), который можно массово загрузить в Elasticsearch с помощью любого из доступных клиентов.
• hugo-lunr. Простой способ добавить поиск по сайту к вашему статическому сайту Hugo с помощью lunr.js. Hugo-lunr создаст индексный файл любых HTML-документов и документов уценки в вашем проекте Hugo.
• хуго-лунр-ж.Немного похоже на Hugo-lunr, но Hugo-lunr-zh может помочь вам разделить китайские ключевые слова.
• Github Gist для интеграции Fuse.js. Эта суть демонстрирует, как использовать существующую обработку времени сборки Hugo для создания индекса JSON с возможностью поиска, используемого Fuse.js на стороне клиента. Хотя эта суть использует Fuse.js для нечеткого сопоставления, любой инструмент поиска на стороне клиента, способный читать индексы JSON, будет работать. Не требует npm, grunt или других инструментов времени сборки, кроме Hugo!
• hugo-search-index.Библиотека, содержащая задачи Gulp и готовый сценарий браузера, реализующий поиск. Gulp генерирует поисковый индекс из файлов разметки проекта.
• hugofastsearch. Улучшение удобства использования и скорости «GitHub Gist для интеграции Fuse.js» — глобального поиска, оптимизированного для клавиатуры.

Коммерческие службы поиска

• API поиска Algolia упрощает предоставление отличных возможностей поиска в ваших приложениях и на веб-сайтах. Algolia Search обеспечивает полнотекстовый, числовой, фасетный и геолокализованный поиск.
• Bonsai — это полностью управляемый размещенный сервис Elasticsearch, быстрый, надежный и простой в настройке. Легко загружайте свои документы из Hugo в Elasticsearch, следуя этому руководству из документации.
• ExpertRec — это размещенное на хосте решение «поиск как услуга», быстрое и масштабируемое. Настройка и интеграция чрезвычайно просты и занимают всего несколько минут. Настройки поиска можно изменить без кодирования с помощью панели управления.

Установить Hugo | Hugo

Сейчас много говорят о том, что «Hugo пишется на Go», но вам не нужно устанавливать Go, чтобы пользоваться Hugo.Просто возьмите предварительно скомпилированный двоичный файл!

Hugo написан на Go с поддержкой нескольких платформ. Последнюю версию можно найти на сайте Hugo Releases.

Hugo в настоящее время предоставляет предварительно скомпилированные двоичные файлы для следующего:

• macOS (Darwin) для архитектур x64, i386 и ARM
• Windows
• Linux
• OpenBSD
• FreeBSD

Hugo также может быть скомпилирован из исходников везде, где может работать набор инструментов Go; например, в других операционных системах, таких как DragonFly BSD, OpenBSD, Plan 9, Solaris и других.См. Https://golang.org/doc/install/source для получения полного набора поддерживаемых комбинаций целевых операционных систем и архитектур компиляции.

Быстрая установка

Двоичный (кроссплатформенный)

Загрузите соответствующую версию для своей платформы из Hugo Releases. После загрузки двоичный файл можно запускать из любого места. Вам не нужно устанавливать его в глобальном местоположении. Это хорошо работает для общих хостов и других систем, в которых у вас нет привилегированной учетной записи.

В идеале, вы должны установить его где-нибудь в вашем PATH для удобства использования. / usr / local / bin — наиболее вероятное местоположение.

Docker

В настоящее время мы не предлагаем официальные образы Hugo для Docker, но мы рекомендуем эти актуальные дистрибутивы: https://hub.docker.com/r/klakegg/hugo/

Homebrew (macOS)

Если вы используете macOS и Homebrew, вы можете установить Hugo с помощью следующего однострочника:

. Для получения более подробных объяснений прочитайте руководства по установке, которые следуют для установки в macOS и Windows.

MacPorts (macOS)

Если вы работаете в macOS и используете MacPorts, вы можете установить Hugo со следующей однострочной версией:

Homebrew (Linux)

Если вы используете Homebrew в Linux, вы можете установить Hugo с следующий однострочный:

install-with-linuxbrew.sh

Руководства по установке Homebrew в Linux доступны на их веб-сайте.

Chocolatey (Windows)

Если вы работаете на компьютере с Windows и используете Chocolatey для управления пакетами, вы можете установить Hugo со следующим однострочником:

install-with-chocolatey.пс1

 
choco install hugo -confirm
  

Или, если вам нужна «расширенная» версия Sass / SCSS:

install-extended-with-chocolatey.ps1

 
choco install hugo-extended -confirm
  

Scoop (Windows)

Если вы работаете на компьютере с Windows и используете Scoop для управления пакетами, вы можете установить Hugo с помощью следующего однострочника:

Или установить расширенную версию с помощью:

  scoop install hugo- расширенный
  

Исходный код

Необходимые инструменты

Получить с GitHub

Начиная с Hugo 0.48, Hugo использует для сборки поддержку модулей Go, встроенную в Go 1.11. Самый простой способ начать — клонировать Hugo в каталог за пределами GOPATH, как в следующем примере:

from-gh.sh

 
mkdir $ HOME / src
cd $ HOME / src
git clone https://github.com/gohugoio/hugo.git
cd hugo
go install --tags extended
  

Удалите --tags extended , если вы не хотите / не нуждаетесь в поддержке Sass / SCSS.

Если вы являетесь пользователем Windows, замените указанную выше переменную среды $ HOME на % USERPROFILE% .

macOS

Допущения

1. Вы знаете, как открыть терминал macOS.
2. Вы используете современный 64-разрядный компьютер Mac.
3. Вы будете использовать ~ / Sites в качестве отправной точки для вашего сайта. ( ~ / Sites используется в качестве примера. Если вы достаточно знакомы с командной строкой и файловой системой, у вас не должно возникнуть проблем при выполнении инструкций.)

Выберите свой метод

Есть три способа установите Hugo на свой Mac

1. Менеджер пакетов, например Homebrew ( brew ) или MacPorts ( порт )
2. Дистрибутив (т.е.д., tarball)
3. Сборка из исходников

Не существует «лучшего» способа установить Hugo на ваш Mac. Вы должны использовать метод, который лучше всего подходит для вашего случая использования.

Плюсы и минусы

У каждого из вышеупомянутых методов есть свои плюсы и минусы:

1. Package Manager. Использование диспетчера пакетов — это самый простой метод, требующий минимум усилий для обслуживания. Недостатки несущественные. Пакет по умолчанию будет для самого последнего выпуска, поэтому в нем не будет исправлений ошибок до следующего выпуска (т.е.е., если вы не установите его с опцией --HEAD в Homebrew). Релизы могут отставать на несколько дней, потому что это должно быть согласовано с другой командой. Тем не менее, это рекомендуемый метод установки, если вы хотите работать из стабильного, широко используемого источника. Менеджеры пакетов работают хорошо, и их легко обновлять.

2. Tarball. Загрузка и установка из tarball также просты, хотя для этого требуется немного больше навыков работы с командной строкой, чем для Homebrew.Обновления тоже просты: вы просто повторяете процесс с новым двоичным файлом. Это дает вам возможность иметь несколько версий на вашем компьютере. Если вы не хотите использовать brew , тогда tarball / binary — хороший выбор.

3. Строительство из источника. Строительство из исходников — это больше всего работы. Преимущество сборки из исходного кода заключается в том, что вам не нужно ждать выпуска, чтобы добавить функции или исправления ошибок. Недостатком является то, что вам нужно тратить больше времени на управление настройкой, что вполне управляемо, но требует больше времени, чем два предыдущих варианта.

Поскольку сборка из исходных текстов привлекательна для более опытных пользователей командной строки, это руководство будет больше сосредоточено на установке Hugo через Homebrew и Tarball.

Установите Hugo with Brew

Шаг 1. Установите brew , если вы еще этого не сделали.

Перейдите на веб-сайт brew https://brew.sh/ и следуйте инструкциям на нем. Самый важный шаг — установка из командной строки:

install-brew.ш

 
ruby -e "$ (curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  

Шаг 2: Запустите команду brew для установки hugo

Установить Hugo с использованием brew очень просто:

Если Homebrew работает правильно, вы должны увидеть что-то похожее на следующее:

  ==> Скачивание https://homebrew.bintray.com/bottles/hugo-0.21.sierra.bottle.tar.gz
############################################### ####################### 100.0%
==> Заливка hugo-0.21.sierra.bottle.tar.gz
🍺 /usr/local/Cellar/hugo/0.21: 32 файла, 17,4 МБ
  

Замените brew install hugo на brew install hugo --HEAD , если вам нужна самая последняя версия, находящаяся в разработке.

brew должен был обновить ваш путь, чтобы включить Хьюго. Вы можете подтвердить, открыв новое окно терминала и выполнив несколько команд:

  $ # показать местоположение исполняемого файла hugo
который Хьюго
/ USR / местные / бен / хьюго

# показать установленную версию
ls -l $ (что хьюго)
lrwxr-xr-x 1 mdhender admin 30 марта 28 22:19 / usr / local / bin / hugo ->../Cellar/hugo/0.13_1/bin/hugo

# проверяем, что hugo работает правильно
версия hugo
Генератор статических сайтов Hugo v0.13 Дата сборки: 2015-03-09T21: 34: 47-05: 00
  

Установите Hugo из Tarball

Шаг 1: Определитесь с местом

При установке из tarball вы должны решить, собираетесь ли вы устанавливать двоичный файл в / usr / local / bin или в своем доме каталог. На этом есть три лагеря:

1. Установите его в / usr / local / bin , чтобы все пользователи вашей системы имели к нему доступ.Это хорошая идея, потому что это довольно стандартное место для исполняемых файлов. Обратной стороной является то, что вам могут потребоваться повышенные привилегии для размещения программного обеспечения в этом месте. Кроме того, если в вашей системе несколько пользователей, все они будут использовать одну и ту же версию. Иногда это может стать проблемой, если вы хотите опробовать новую версию.

2. Установите его в ~ / bin , чтобы только вы могли его выполнить. Это хорошая идея, потому что это легко сделать, легко поддерживать и не требует повышенных привилегий.Обратной стороной является то, что управлять Хьюго можно только тебе. Если на вашем сайте есть другие пользователи, они должны поддерживать свои собственные копии. Это может привести к тому, что люди будут запускать разные версии. Конечно, это облегчает вам эксперименты с разными выпусками.

3. Установите его в каталог Sites . Это неплохая идея, если у вас есть только один сайт, который вы создаете. Он хранит все в одном месте. Если вы хотите опробовать новые выпуски, вы можете сделать копию всего сайта и обновить исполняемый файл Hugo.

Все три офиса будут работать на вас. В интересах краткости в этом руководстве рассматривается вариант №2.

Шаг 2. Загрузите Tarball

1. Откройте https://github.com/gohugoio/hugo/releases в своем браузере.

2. Найдите текущий выпуск, прокрутив страницу вниз и найдите зеленый тег с надписью «Последний выпуск».

3. Загрузите текущий архив для Mac. Имя будет примерно hugo_X.Y_osx-64bit.tgz , где X.YY — номер версии.

4. По умолчанию архив будет сохранен в вашем каталоге ~ / Downloads . Если вы решите использовать другое местоположение, вам нужно будет изменить его, выполнив следующие действия.

Шаг 3: Подтвердите загрузку

Убедитесь, что архив не был поврежден во время загрузки:

  tar tvf ~ / Downloads / hugo_X.Y_osx-64bit.tgz
-rwxrwxrwx 0 0 0 0 22 февраля, 04:02 hugo_X.Y_osx-64bit / hugo_X.Y_osx-64bit.tgz
-rwxrwxrwx 0 0 0 0 22 февраля, 03:24 hugo_X.Y_osx-64bit / README.md
-rwxrwxrwx 0 0 0 0 30 января 18:48 hugo_X.Y_osx-64bit / LICENSE.md
  

Файлы .md являются документацией для Hugo. Другой файл — исполняемый.

Шаг 4: Установите в bin Directory

  # создайте каталог, если необходимо
mkdir -p ~ / bin

# сделать его рабочим каталогом
cd ~ / bin

# распаковать архив
tar -xvzf ~ / Загрузки / hugo_X.Y_osx-64bit.tgz
Архив: hugo_X.Y_osx-64bit.tgz
  Икс ./
  х ./hugo
  x ./LICENSE.md
  x ./README.md

# проверяем, что он работает
./hugo версия
Генератор статических сайтов Hugo v0.13 Дата сборки: 2015-02-22T04: 02: 30-06: 00
  

Возможно, вам потребуется добавить каталог bin в переменную среды PATH . , который команда проверит за нас. Если он сможет найти hugo , он напечатает полный путь к нему. В противном случае он ничего не напечатает.

  # проверяем, находится ли Хьюго на пути
который Хьюго
/ Пользователи / ИМЯ ПОЛЬЗОВАТЕЛЯ / bin / hugo
  

Если hugo отсутствует в вашем PATH :

1. Определите оболочку по умолчанию (zsh или bash).

     echo $ SHELL
     

2. Измените свой профиль.

   Если ваша оболочка по умолчанию — zsh:

     nano ~ / .zprofile
     

   Если ваша оболочка по умолчанию — bash:

     nano ~ / .bash_profile
     

3. Вставьте строку, чтобы добавить $ HOME / bin к существующему PATH .

     экспорт PATH = $ PATH: $ HOME / bin
     

4. Сохраните файл, нажав Control-X, затем Y.

5. Закройте терминал и откройте новый терминал, чтобы сохранить изменения в вашем профиле. Проверьте изменение, снова запустив команду which hugo .

Вы успешно установили Hugo.

Сборка из исходного кода на Mac

Если вы хотите скомпилировать Hugo самостоятельно, вам потребуется установить Go (он же Golang). Вы можете установить Go прямо с веб-сайта Go или через Homebrew, используя следующую команду:

  brew install go
  

Шаг 1. Получите исходный код

Если вы хотите скомпилировать определенную версию Hugo, перейдите на https: // github.com / gohugoio / hugo / Release и загрузите исходный код для выбранной вами версии. Если вы хотите скомпилировать Hugo со всеми последними изменениями (которые могут включать ошибки), клонируйте репозиторий Hugo:

  git clone https://github.com/gohugoio/hugo
  

Клонирование репозитория Hugo напрямую означает отказ от хорошего и плохого. Используя новейшую версию Hugo, вы делаете свою разработку восприимчивой к новейшим функциям, а также к последним ошибкам. Ваше мнение очень важно.Если вы обнаружите ошибку в последней версии, создайте проблему на GitHub.

Шаг 2: Компиляция

Сделайте каталог, содержащий исходный код, своим рабочим каталогом, а затем загрузите зависимости Hugo:

  mkdir -p src / github.com / gohugoio
ln -sf $ (pwd) src / github.com / gohugoio / hugo

иди возьми
  

Будет получена самая последняя версия зависимостей. Если Hugo не может построить, это может быть результатом того, что автор зависимости внес критическое изменение.

После того, как вы правильно настроили свой каталог, вы можете скомпилировать Hugo, используя следующую команду:

  go build -o hugo main.go
  

Затем поместите исполняемый файл hugo где-нибудь в $ PATH . Теперь вы готовы начать использовать Hugo.

Windows

Ниже приводится полное руководство по установке Hugo на ПК с Windows.

Допущения

1. Вы будете использовать C: \ Hugo \ Sites в качестве отправной точки для вашего нового проекта.
2. Вы будете использовать C: \ Hugo \ bin для хранения исполняемых файлов.

Настройте ваши каталоги

Вам понадобится место для хранения исполняемого файла Hugo, вашего контента и созданного веб-сайта Hugo:

1. Откройте проводник Windows.
2. Создайте новую папку: C: \ Hugo , при условии, что вы хотите, чтобы Hugo был на вашем диске C, хотя это может быть где угодно
3. Создайте подпапку в папке Hugo: C: \ Hugo \ bin
4. Создайте еще одну вложенная папка в Hugo: C: \ Hugo \ Sites

Технические пользователи

1. Загрузите последний заархивированный исполняемый файл Hugo из Hugo Releases.
2. Распакуйте все содержимое в папку .. \ Hugo \ bin .
3. В PowerShell или предпочитаемом вами интерфейсе командной строки добавьте исполняемый файл hugo.exe в ваш PATH, перейдя к C: \ Hugo \ bin (или в расположение вашего файла hugo.exe) и используйте команду set PATH = % ПУТЬ%; C: \ Hugo \ bin . Если команда hugo не работает после перезагрузки, возможно, вам придется запустить командную строку от имени администратора.

Менее технических пользователей

1. Перейдите на страницу Hugo Releases.
2. Последний релиз анонсирован сверху. Прокрутите до конца объявления о выпуске, чтобы увидеть загрузки. Это все ZIP-файлы.
3. Найдите файлы Windows внизу (они расположены в алфавитном порядке, поэтому Windows идет последней) — загрузите 32-разрядный или 64-разрядный файл в зависимости от того, какая у вас Windows — 32-разрядная или 64-разрядная. (Если вы не знаете, см. Здесь.)
4. Переместите ZIP-файл в папку C: \ Hugo \ bin .
5. Дважды щелкните ZIP-файл и извлеките его содержимое.Обязательно извлеките содержимое в ту же папку C: \ Hugo \ bin — Windows сделает это по умолчанию, если вы не укажете извлекать его куда-нибудь еще.
6. Теперь у вас должно быть три новых файла: исполняемый файл hugo ( hugo.exe ), LICENSE и README.md .

Теперь вам нужно добавить Hugo в настройки Windows PATH:

Для пользователей Windows 10:

• Щелкните правой кнопкой мыши кнопку Start .
• Нажмите Система .
• Нажмите Advanced System Settings слева.
• Щелкните ссылку Environment Variables & mldr; Кнопка внизу.
• В разделе «Пользовательские переменные» найдите строку, которая начинается с ПУТЬ (ПУТЬ будет полностью заглавными).
• Дважды щелкните PATH .
• Щелкните ссылку New & mldr; Кнопка .
• Введите папку, в которую был извлечен hugo.exe , то есть C: \ Hugo \ bin , если вы следовали приведенным выше инструкциям. Запись PATH должна быть папкой, в которой живет Хьюго, а не двоичным файлом. По завершении ввода нажмите Enter.
• Для выхода нажимайте ОК в каждом окне.

Редактор путей в Windows 10 был добавлен в большом обновлении за ноябрь 2015 г. Вам потребуется установить это или более позднее обновление, чтобы описанные выше действия работали. Вы можете увидеть, какая у вас сборка Windows 10, нажав кнопку Пуск → Настройки → Система → О программе. Подробнее см. Здесь)

Для Windows 7 и 8.x пользователи:

Windows 7 и 8.1 не включают редактор простого пути, включенный в Windows 10, поэтому нетехническим пользователям на этих платформах рекомендуется установить бесплатный сторонний редактор путей, например редактор переменных среды Windows или редактор путей.

Проверьте исполняемый файл

Выполните несколько команд, чтобы убедиться, что исполняемый файл готов к запуску, а затем создайте образец сайта, чтобы начать работу.

1. Откройте командную строку

В командной строке введите hugo help и нажмите клавишу Enter.Вы должны увидеть вывод, который начинается с:

  hugo - это основная команда, используемая для создания вашего сайта Hugo.

Hugo - быстрый и гибкий генератор статических сайтов
Создано с любовью spf13 и друзьями в Go.

Полная документация доступна на https://gohugo.io/.
  

Если да, то установка завершена. Если вы этого не сделаете, дважды проверьте путь, по которому вы поместили файл hugo.exe , и что вы правильно ввели этот путь, когда добавляли его в переменную PATH .Если вы по-прежнему не получаете результат, поищите в дискуссионном форуме Hugo, чтобы узнать, поняли ли другие уже нашу проблему. Если нет, добавьте примечание — в категории «Поддержка» — и обязательно укажите свою команду и результат.

При появлении приглашения смените каталог на каталог Sites .

  C: \ Program Files> cd C: \ Hugo \ Sites
C: \ Hugo \ Sites>
  

2. Запустите команду

Запустите команду, чтобы создать новый сайт. Я использую пример .com в качестве имени сайта.

  C: \ Hugo \ Sites> новый сайт hugo example.com
  

Теперь у вас должен быть каталог C: \ Hugo \ Sites \ example.com . Перейдите в этот каталог и перечислите его содержимое. Вы должны получить следующий результат:

  C: \ Hugo \ Sites> cd example.com
C: \ Hugo \ Sites \ example.com> dir
Каталог C: \ hugo \ sites \ example.com

13.04.2015 22:44 .
13.04.2015 22:44 ..
13.04.2015 22:44  архетипы
13.04.2015 22:44 83 config.toml
13.04.2015 22:44  содержание
13.04.2015 22:44  data
13.04.2015 22:44  макеты
13.04.2015 22:44  статический
               1 Файл (ы) 83 байта
               7 Dir (s) 6,273,331,200 байт свободно
  

Устранение неполадок при установке Windows

@dhersam создал хорошее видео по распространенным проблемам:

Linux

Snap Package

В любом из дистрибутивов Linux, поддерживающих привязки, вы можете установить «расширенный» Sass / Версия SCSS с помощью этой команды:

  snap install hugo --channel = extended
  

Чтобы установить нерасширенную версию без поддержки Sass / SCSS:

  snap install hugo
  

Для переключения между ними используйте либо snap refresh hugo --channel = extended , либо snap refresh hugo --channel = stable .

Hugo, установленный через Snap, может записывать только в пользовательский каталог $ HOME и подключаемые к gvfs каталоги, принадлежащие пользователю, из-за ограниченности и модели безопасности Snaps. Дополнительная информация также доступна в этой связанной проблеме GitHub.

Debian и Ubuntu

@anthonyfok и его друзья из Debian Go Packaging Team поддерживают официальный пакет hugo Debian, который используется совместно с Ubuntu и может быть установлен через apt-get :

  sudo apt-get install hugo
  

То, что будет установлено, зависит от вашей версии Debian / Ubuntu.В Ubuntu bionic (18.04) устанавливается нерасширенная версия без поддержки Sass / SCSS. На Ubuntu disco (19.04) устанавливается расширенная версия с поддержкой Sass / SCSS.

Этот вариант не рекомендуется, потому что Hugo в менеджерах пакетов Linux для Debian и Ubuntu обычно отстает на несколько версий, как описано здесь

Arch Linux

Вы также можете установить Hugo из репозитория сообщества Arch Linux. Применимо также к производным, таким как Manjaro.

  Судо Пакман -Syu Hugo
  

Fedora, Red Hat и CentOS

Fedora поддерживает официальный пакет для Hugo, который можно установить с помощью:

  sudo dnf install hugo
  

Для последней версии рекомендуется пакет Hugo, поддерживаемый @daftaupe в Fedora Copr:

См. Соответствующее обсуждение на форумах Hugo.

Solus

Solus включает Hugo в свой репозиторий пакетов, его можно установить с помощью:

  sudo eopkg install hugo
  

OpenBSD

OpenBSD предоставляет пакет для Hugo через pkg_add :

  doas pkg_add hugo
  

Обновить Hugo

Обновить Hugo так же просто, как загрузить и заменить исполняемый файл, который вы поместили в свой PATH , или запустить brew upgrade hugo при использовании Homebrew.

Дальнейшие действия

Теперь, когда вы установили Hugo, прочтите краткое руководство и изучите остальную документацию. Если у вас есть вопросы, задавайте их сообществу Hugo напрямую, посетив дискуссионный форум Hugo.

Настроить Hugo | Hugo

Hugo использует config.toml , config.yaml или config.json (если он находится в корень сайта) в качестве файла конфигурации сайта по умолчанию.

Пользователь может заменить это значение по умолчанию одним или несколькими файлами конфигурации сайта. с помощью переключателя командной строки --config .

Примеры:

  hugo --config debugconfig.toml
hugo --config a.toml, b.toml, c.toml
  

Несколько файлов конфигурации сайта можно указать в виде строки, разделенной запятыми, в параметре --config .

Каталог конфигурации

В дополнение к использованию одного файла конфигурации сайта можно использовать каталог configDir (по умолчанию config / ) для упрощения управления настройками организации и среды.

• Каждый файл представляет собой корневой объект конфигурации, например params.toml для [Параметры] , меню (я) .toml для [Меню] , languages.toml для [Языки] и т. д. & mldr;

• Содержание каждого файла должно быть верхнего уровня, например:

  В config.toml :

  В params.toml :

    foo = "bar"
    

• Каждый каталог содержит группу файлов, содержащих настройки, уникальные для данной среды.

• Файлы можно локализовать, чтобы они соответствовали языку.

  ├── конфигурация
│ ├── _default
│ │ ├── config.toml
│ │ ├── languages.toml
│ │ ├── menus.en.toml
│ │ ├── меню.ж.томл
│ │ └── params.toml
│ ├── производство
│ │ ├── config.toml
│ │ └── params.toml
│ └── постановка
│ ├── config.toml
│ └── params.toml
  

Учитывая приведенную выше структуру, при запуске hugo --environment staging , Hugo будет использовать все настройки из config / _default и объединить staging поверх этих.

Среды по умолчанию: development с hugo server и production с hugo .

Все настройки конфигурации

Ниже приводится полный список переменных, определенных Hugo, с их значениями по умолчанию. значение в скобках. Пользователи могут переопределить эти значения на своем сайте. конфигурационный файл (ы).

archetypeDir («архетипы»)

Каталог, в котором Хьюго находит файлы архетипов (шаблоны содержимого).Также см. Module Mounts Config для альтернативного способа настройки этого каталога (из Hugo 0.56).

assetDir («assets»)

Каталог, в котором Hugo находит файлы ресурсов, используемые в Hugo Pipes. Также см. Module Mounts Config для альтернативного способа настройки этого каталога (из Hugo 0.56).

baseURL

Имя хоста (и путь) к корню, например https://bep.is/

blackfriday

См. Настройка Blackfriday

build

См. Настройка сборки

buildDrafts (false)

Включать черновики при сборке.

buildExpired (false)

Включить содержимое, срок действия которого уже истек.

buildFuture (false)

Включить содержимое с датой публикации в будущем.

кешей

См. Настройка файловых кешей

canonifyURLs (false)

Включите, чтобы превратить относительные URL-адреса в абсолютные.

contentDir («content»)

Каталог, из которого Hugo читает файлы содержимого. Также см. Module Mounts Config для альтернативного способа настройки этого каталога (из Hugo 0.56).

dataDir («данные»)

Каталог, из которого Хьюго читает файлы данных. Также см. Module Mounts Config для альтернативного способа настройки этого каталога (из Hugo 0.56).

defaultContentLanguage («en»)

Для содержимого без индикатора языка по умолчанию будет выбран этот язык.

defaultContentLanguageInSubdir (false)

Отображает язык содержимого по умолчанию в подкаталоге, например content / en / . Корневой каталог сайта / будет перенаправлен на / en / .

disableAliases (false)

Отключит создание переадресации псевдонимов. Обратите внимание, что даже если установлен disableAliases , сами псевдонимы сохраняются на странице. Мотивация при этом заключается в том, чтобы иметь возможность генерировать 301 редирект в файле .htaccess , файле Netlify _redirects или аналогичном с использованием настраиваемого формата вывода.

disableHugoGeneratorInject (false)

Hugo по умолчанию вставляет метатег генератора в заголовок HTML на домашней странице только .Вы можете отключить его, но мы будем очень признательны, если вы этого не сделаете, так как это хороший способ наблюдать за ростом популярности Хьюго.

disableKinds ([])

Разрешить отключение всех страниц указанных типов . Допустимые значения в этом списке: "страница" , "главная" , "раздел" , "таксономия" , "термин" , "RSS" , "карта сайта" , " robotsTXT ", " 404 ".

disableLiveReload (false)

Отключить автоматическую перезагрузку окна браузера в реальном времени.

disablePathToLower (false)

Не преобразовывать URL / путь в нижний регистр.

enableEmoji (false)

Включить поддержку смайлов Emoji для содержимого страницы; см. шпаргалку по Emoji.

enableGitInfo (false)

Включить объект .GitInfo для каждой страницы (если версия сайта Hugo контролируется Git). Затем это обновит параметр Lastmod для каждой страницы, используя дату последней фиксации git для этого файла содержимого.

enableInlineShortcodes (false)

Включить поддержку встроенных коротких кодов.См. Встроенные шорткоды.

enableMissingTranslationPlaceholder (false)

Показывать заполнитель вместо значения по умолчанию или пустой строки, если перевод отсутствует.

enableRobotsTXT (false)

Включить создание файла robots.txt .

передняя панель

См. Раздел Конфигурация передней панели.

footnoteAnchorPrefix («»)

Префикс для привязок сноски.

footnoteReturnLinkContents («»)

Текст, отображаемый для обратных ссылок сноски.

googleAnalytics («»)

Идентификатор отслеживания Google Analytics.

hasCJKLanguage (false)

Если true, автоматически определять китайский / японский / корейский языки в содержимом. Это заставит .Summary и .WordCount вести себя правильно для языков CJK.

imaging

См. Конфигурация обработки изображений.

языков

См. Настройка языков.

languageCode («»)

Код языка сайта. Он используется в шаблоне RSS по умолчанию и может быть полезен для многоязычных сайтов.

languageName («»)

Название языка сайта.

disableLanguages ​​

См. Отключение языка

layoutDir («макеты»)

Каталог, из которого Hugo читает макеты (шаблоны).

журнал (ложь)

Включить ведение журнала.

logFile («»)

Путь к файлу журнала (если задано, ведение журнала включается автоматически).

разметка

См. Раздел «Настройка разметки». Новое в v0.60.0

меню

См. Раздел «Добавление записей, не относящихся к содержанию».

minify

См. Настройка модуля Minify

Конфигурация модуля см. Конфигурация модуля. Новое в v0.56.0

newContentEditor («»)

Редактор для использования при создании нового содержимого.

noChmod (false)

Не синхронизировать режим разрешения файлов.

noTimes (false)

Не синхронизировать время модификации файлов.

paginate (10)

Количество элементов на странице по умолчанию при разбивке на страницы.

paginatePath («page»)

Элемент пути, используемый при разбивке на страницы (https: // example.com / page / 2).

постоянных ссылок

См. Управление контентом.

pluralizeListTitles (true)

Множественное число заголовков в списках.

publishDir («общедоступный»)

Каталог, в который Хьюго запишет окончательный статический сайт (файлы HTML и т. Д.).

связанные

См. Связанное содержимое. Новое в версии 0.27

relativeURLs (false)

Включите это, чтобы сделать все относительные URL-адреса относительно корня содержимого. Обратите внимание, что это не влияет на абсолютные URL-адреса.

refLinksErrorLevel («ERROR»)

При использовании ref или relref для разрешения ссылок на страницы, и ссылка не может быть разрешена, она будет регистрироваться с этим уровнем журнала. Допустимые значения: ОШИБКА (по умолчанию) или ПРЕДУПРЕЖДЕНИЕ . Любая ОШИБКА приведет к сбою сборки ( exit -1 ).

refLinksNotFoundURL

URL-адрес, который будет использоваться в качестве заполнителя, когда ссылка на страницу не может быть найдена в ref или relref .Используется как есть.

rssLimit (неограниченно)

Максимальное количество элементов в RSS-ленте.

sectionPagesMenu («»)

См. «Меню раздела для ленивых блоггеров».

карта сайта

Конфигурация карты сайта по умолчанию.

staticDir («static»)

Каталог или список каталогов, из которых Hugo читает статические файлы. Также см. Module Mounts Config для альтернативного способа настройки этого каталога (из Hugo 0.56).

summaryLength (70)

Длина текста в словах, отображаемого в .Резюме .

таксономий

См. Раздел Настройка таксономий.

тема («»)

Тема для использования (по умолчанию находится в / themes / THEMENAME / ).

themesDir («themes»)

Каталог, из которого Хьюго читает темы.

тайм-аут (10000)

Тайм-аут для создания содержимого страницы в миллисекундах (по умолчанию 10 секунд). Примечание: это используется для предотвращения создания рекурсивного контента, если ваши страницы генерируются медленно (например,g., поскольку они требуют обработки больших изображений или зависят от удаленного содержимого) вам может потребоваться увеличить этот предел.

заголовок («»)

Заголовок сайта.

titleCaseStyle («AP»)

См. «Настроить регистр заголовка»

uglyURLs (false)

При включении создает URL-адрес в форме /filename.html вместо / filename / .

verbose (false)

Включить подробный вывод.

verboseLog (false)

Включить подробное ведение журнала.

watch (false)

Следить за изменениями файловой системы и при необходимости воссоздавать.

Если вы разрабатываете свой сайт на машине * nix, вот удобный ярлык для поиска параметра конфигурации из командной строки:

  cd ~ / sites / yourhugosite
hugo config | grep emoji
  

, который показывает вывод вроде

  enableemoji: true
  

Настроить сборку

Раздел конфигурации build содержит глобальные параметры конфигурации, связанные со сборкой.

конфиг.

  сборка:
  noAOonfigInAssets: false
  useResourceCacheWhen: откат
  writeStats: ложь
  

  [сборка]
  noAOonfigInAssets = false
  useResourceCacheWhen = "резерв"
  writeStats = false
  

  {
   "build": {
      "noJSConfigInAssets": false,
      "useResourceCacheWhen": "резерв",
      "writeStats": false
   }
}
  

useResourceCacheWhen

Когда использовать кэшированные ресурсы в / resources / _gen для PostCSS и ToCSS.Допустимые значения: никогда, , всегда и резервный . Последнее значение означает, что кеш будет проверяться, если PostCSS / расширенная версия недоступна.

writeStats Новое в v0.69.0

При включении файл с именем hugo_stats.json будет записан в корень вашего проекта с некоторыми агрегированными данными о сборке, например список объектов HTML, опубликованных для использования при сокращении CSS. Если вы используете его только для производственной сборки, вам следует подумать о том, чтобы разместить его ниже config / production.Также стоит упомянуть, что из-за характера частичных сборок сервера новые объекты HTML будут добавляться при их добавлении или изменении во время работы сервера, но старые значения не будут удалены, пока вы не перезапустите сервер или не запустите обычный hugo build.

нетAOonfigInAssets Новое в версии 0.78.0

Отключите запись jsconfig.json в папку / assets с отображением импорта из запущенного js.Build. Этот файл предназначен для помощи с intellisense / навигацией внутри редакторов кода, таких как VS Code.Обратите внимание, что если вы не используете js.Build , файл не будет записан.

Настроить сервер

Это актуально только при запуске hugo server и позволяет устанавливать заголовки HTTP во время разработки, что позволяет вам протестировать свою Политику безопасности контента и т.п. Формат конфигурации соответствует формату Netlify с немного более мощным соответствием Glob:

config.

  сервер:
  заголовки:
  - за: /**.html
    значения:
      Content-Security-Policy: сценарий-src localhost: 1313
      Политика реферера: строгое происхождение при перекрестном происхождении
      Параметры X-Content-Type: nosniff
      Параметры X-Frame: ОТКАЗАТЬ
      X-XSS-Protection: 1; режим = блок
  

  [сервер]

  [[server.headers]]
    for = "/**.html"
    [server.headers.values]
      Content-Security-Policy = "script-src localhost: 1313"
      Referrer-Policy = "strict-origin-when-cross-origin"
      X-Content-Type-Options = "nosniff"
      X-Frame-Options = "ОТКАЗАТЬ"
      X-XSS-Protection = "1; режим = блок"
  

  {
   "server": {
      "заголовки": [
         {
            "за": "/**.html ",
            "значения": {
               "Content-Security-Policy": "script-src localhost: 1313",
               "Referrer-Policy": "strict-origin-when-cross-origin",
               "X-Content-Type-Options": "nosniff",
               "X-Frame-Options": "ОТКАЗАТЬ",
               «X-XSS-Protection»: «1; режим = блок»
            }
         }
      ]
   }
}
  

Поскольку это «только разработка», возможно, имеет смысл поместить его под средой разработки :

config / development / server.

 :
- для: /**.html
  значения:
    Content-Security-Policy: сценарий-src localhost: 1313
    Политика реферера: строгое происхождение при перекрестном происхождении
    Параметры X-Content-Type: nosniff
    Параметры X-Frame: ОТКАЗАТЬ
    X-XSS-Protection: 1; режим = блок
  

  [[заголовки]]
  for = "/**.html"
  [заголовки.значения]
    Content-Security-Policy = "script-src localhost: 1313"
    Referrer-Policy = "strict-origin-when-cross-origin"
    X-Content-Type-Options = "nosniff"
    X-Frame-Options = "ОТКАЗАТЬ"
    X-XSS-Protection = "1; режим = блок"
  

  {
   "заголовки": [
      {
         "за": "/**.html ",
         "значения": {
            "Content-Security-Policy": "script-src localhost: 1313",
            "Referrer-Policy": "strict-origin-when-cross-origin",
            "X-Content-Type-Options": "nosniff",
            "X-Frame-Options": "ОТКАЗАТЬ",
            «X-XSS-Protection»: «1; режим = блок»
         }
      }
   ]
}
  

Вы также можете указать простые правила перенаправления для сервера. Синтаксис снова аналогичен синтаксису Netlify.

Обратите внимание, что код состояния , равный 200, вызовет перезапись URL-адреса, что вам и нужно в ситуациях SPA, например.g:

config / development / server.

  перенаправляет:
- сила: ложь
  из: / myspa / **
  статус: 200
  кому: / myspa /
  

  [[перенаправляет]]
  force = false
  from = "/ myspa / **"
  status = 200
  to = "/ myspa /"
  

  {
   "перенаправления": [
      {
         "сила": ложь,
         "от": "/ myspa / **",
         «статус»: 200,
         "в": "/ myspa /"
      }
   ]
}
  

Новое в v0.76.0 Установка force = true выполнит перенаправление, даже если в пути уже есть контент.Обратите внимание, что до Hugo 0.76 force было поведением по умолчанию, но это соответствует тому, как это делает Netlify.

Настроить регистр заголовка

Задайте titleCaseStyle , чтобы указать стиль заголовка, используемый функцией шаблона заголовка и автоматическими заголовками разделов в Hugo. По умолчанию используется AP Stylebook для заголовка, но вы также можете установить его на Chicago или Go (каждое слово начинается с заглавной буквы).

Переменные среды конфигурации

HUGO_NUMWORKERMULTIPLIER

Можно настроить для увеличения или уменьшения количества рабочих процессов, используемых при параллельной обработке в Hugo.Если не установлен, будет использовано количество логических процессоров.

Порядок поиска конфигурации

Подобно порядку поиска шаблонов, Hugo имеет набор правил по умолчанию для поиска файла конфигурации в корне исходного каталога вашего веб-сайта в качестве поведения по умолчанию:

1. ./config.toml
2. ./config.yaml
3. ./config.json

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

Пример конфигурации

Ниже приведен типичный пример файла конфигурации. Значения, вложенные в params: , заполнят переменную .Site.Params для использования в шаблонах:

config.

  baseURL: https://yoursite.example.com/
footnoteReturnLinkContents: ↩
параметры:
  Имя автора:  

Предохранитель