Как создать гиперссылку на файл в подкаталоге родительского каталога

Обновлено: 21.11.2024

Текст ссылки

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

Не используйте фразу "нажмите здесь". Это плохо для поисковой оптимизации и неадекватно описывает цель.

Правильно:

Неверно:

Ссылки с одной статьи на другую

Система публикации поддерживает два типа гиперссылок: URL-адреса и ссылки на файлы.

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

Самый простой способ создать относительную ссылку — скопировать URL-адрес из браузера, а затем удалить https://docs.microsoft.com/en-us из значения, которое вы вставляете в уценку.

Не включайте локали в URL-адреса свойств Microsoft (например, удалите «/en-us» из URL-адреса).

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

Все пути к файлам используют символы прямой косой черты ( / ) вместо обратной косой черты.

Статья ссылается на другую статью в том же каталоге:

Статья ссылается на статью в родительском каталоге текущего каталога:

Статья ссылается на статью в подкаталоге текущего каталога:

Статья ссылается на статью в подкаталоге родительского каталога текущего каталога:

Ни в одном из предыдущих примеров ~/ не используется как часть ссылки. Чтобы указать абсолютный путь, который начинается в корне репозитория, начните ссылку с / . Включение ~/ приводит к недопустимым ссылкам при навигации по исходным репозиториям на GitHub. Путь, начинающийся с /, разрешается правильно.

– определяет язык статьи (пример: en-us или de-de)
– название продукта или услуги (пример: powershell, dotnet или azure).
[] – (необязательно) название функции или подслужбы продукта (пример: csharp или балансировщик нагрузки)
[] – (необязательно) имя подпапки внутри функции.
- название файла статьи по теме (пример: load-balancer-overview или обзор)
[?view=\] – (необязательно) имя представления, используемое средством выбора версии для контента, имеющего несколько доступных версий (пример: azps-3.5.0)

В большинстве случаев статьи в одном и том же наборе документов имеют одинаковый фрагмент URL. Например:

Добавить ссылки в закладки

Для закладки ссылки на заголовок в текущем файле используйте символ решетки, за которым следуют слова заголовка в нижнем регистре. Удалите знаки препинания из заголовка и замените пробелы тире:

Чтобы сослаться на заголовок закладки в другой статье, используйте ссылку, относящуюся к файлу или сайту, плюс символ решетки, за которым следуют слова заголовка. Удалите знаки препинания из заголовка и замените пробелы тире:

Нажмите значок ссылки, а затем скопируйте текст привязки закладки из URL-адреса (то есть часть после решётки).

Расширение Документов также содержит инструменты для создания ссылок.

Явные якорные ссылки

И следующее для ссылки на якорь:

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

XRef (перекрестные ссылки)

Ссылки XRef — это рекомендуемый способ ссылки на API, поскольку они проверяются во время сборки. Чтобы создать ссылку на автоматически созданные справочные страницы API в текущем наборе документации или других наборах документации, используйте ссылки XRef с уникальным идентификатором (UID) типа или члена.

Вы можете использовать один из следующих синтаксисов:

По умолчанию в тексте ссылки отображается только имя члена или типа. Необязательный параметр запроса displayProperty=nameWithType создает полный текст ссылки, то есть namespace.type для типов и type.member для членов типа, включая элементы типа перечисления.

Используйте ссылки в стиле Markdown для XRef, если хотите настроить отображаемый текст ссылки.

отображается как строка

[Класс String](xref:System.String) отображается как класс String.

Параметр запроса displayProperty=fullName работает так же, как displayProperty=nameWithType для классов. То есть текст ссылки становится namespace.classname. Однако для участников текст ссылки отображается как namespace.classname.membername, что может быть нежелательно.

UID чувствительны к регистру. Например, разрешает правильно, но не делает.

Предупреждения сборки XRef и добавочные сборки

Определить UID

Идентификатор UID обычно представляет собой полное имя класса или члена. Существует как минимум два способа определить UID:

Щелкните правой кнопкой мыши страницу Документов для типа или члена, выберите Просмотреть источник, а затем скопируйте значение содержимого для ms.assetid:

Подтвердите UID

Чтобы проверить, правильный ли у вас UID, замените System.String в следующем URL на свой UID, а затем вставьте его в адресную строку браузера:

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

Если вы видите что-то вроде следующего, у вас правильный UID:

Если вы просто видите [] на странице, значит, у вас неверный UID.

Процентное кодирование URL

Специальные символы в UID должны быть закодированы в HTML следующим образом:

См. полный список процентных кодов.

System.Threading.Tasks.Task`1 кодируется как System.Threading.Tasks.Task%601 (см. раздел об универсальных типах)

System.Object.Equals* кодируется как System.Object.Equals%2A

Общие типы

Чтобы связать общий тип, такой как List , закодируйте символ обратной кавычки ` как %60, как показано в следующем примере:

Методы

Чтобы сослаться на метод, вы можете либо указать ссылку на общую страницу метода, добавив звездочку ( * ) после имени метода, либо на конкретную перегрузку. Например, используйте общую страницу, если вы хотите сослаться на метод без конкретных типов параметров. Символ звездочки кодируется как %2A. Например:

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

Ссылки из вложений

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

Расширение Docs Authoring Pack для Visual Studio Code помогает правильно вставлять относительные ссылки и закладки без утомительного поиска путей.

Ссылки в селекторах

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

Ссылки в справочном стиле

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

Ссылки в конце статьи:

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

Ссылки на страницы, не входящие в комплект технической документации

Чтобы создать ссылку на страницу другого ресурса Майкрософт (например, страницу с ценами, страницу SLA или что-то еще, что не является статьей документации), используйте абсолютный URL-адрес, но не указывайте языковой стандарт. Цель состоит в том, чтобы ссылки работали в GitHub и на отображаемом сайте:

Ссылки на сторонние сайты

Наилучшее взаимодействие с пользователем сводит к минимуму отправку пользователей на другой сайт. Так что основывайте любые ссылки на сторонние сайты, которые нам иногда нужны, на этой информации:

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

Первые ссылки

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

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

Структура ссылок

Как и все теги, ссылки имеют определенную структуру и имеют начальные и конечные теги. Поместите эту строку кода на одну из своих страниц.

a : a означает Anchor, что означает ссылку. Это тег, благодаря которому все это происходит.
href : означает гипертекстовую ссылку. Часть href — это еще один атрибут, значением которого является местоположение другой страницы. Просто измените theotherpage.html на имя второго файла. Не забудьте кавычки!

Все, что вы поместите в теги ссылок, станет ссылкой, окрашенной в синий цвет и подчеркнутой. Когда вы наведете на нее указатель мыши, ваш курсор превратится в руку, а URL-адрес страницы появится в строке состояния вашего браузера (в нижней части окна). Если вы хотите сделать ссылки на другие части вашей страницы (например, ссылку на верхнюю часть страницы), настройте несколько внутренних ссылок. Изменение цветов ссылок по умолчанию осуществляется в атрибутах body.

Ссылки на адреса электронной почты

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

чтобы создать это — напишите мне — откроется программа электронной почты пользователя с вашим адресом в поле Кому:.

Ссылки на изображения

Ссылка на файл изображения практически такая же, как и на файл html. Просто укажите имя файла и не забудьте правильный суффикс — например, если это gif или jpg. Для краткого изложения форматов файлов изображений в Интернете прочитайте это. Если вы хотите использовать изображение в качестве ссылки, прочитайте следующее руководство.

Ссылки на файлы

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

Встраивание файла непосредственно в страницу — это другой процесс. У нас также есть страница о форматах файлов в Интернете.

Абсолютные и относительные ссылки

Относительные ссылки могут вести только на страницу того же сайта. Адрес всегда относится к позиции второго файла. Если бы вы ссылались на ту же страницу со страницы в том же каталоге, href был бы просто page1.html. Если бы вы устанавливали ссылку со своей домашней страницы, то есть из корневого каталога, ссылка выглядела бы как , так как вам нужно было бы сначала перейти в каталог, а затем получить файл.

Подсказка: если вы называете файлы index.html в своих каталогах, вы можете делать ссылки на эти страницы, просто ссылаясь на имя каталога. Ваш браузер всегда будет использовать index в качестве главной страницы для этой папки. Это означает, что вы можете сжать href="folder/index.html" в href="folder/" . Косая черта говорит браузеру, что он должен искать папку, а не файл. Не забудьте!

Линкал Гимнастика

Если вам нужно подняться вверх по каталогу, а затем вернуться в другой, вам нужно понять, как устроен ваш сайт. Используя исходный код HTML в качестве примера, мы сейчас находимся в разделе «myfirstsite». Посмотрите на адресную строку, чтобы увидеть. Если бы мы хотели сделать ссылку относительно раздела «images», нам пришлось бы перейти на один каталог вверх, а затем вниз в каталог изображений. Таким образом, полный относительный адрес href будет выглядеть так:
"../images/index.html"
Видите две точки? Они означают «перейти вверх по каталогу» к вашему корню. Таким образом, независимо от того, насколько глубоко вы погрузились в свой сайт, вы всегда можете вернуться к нему с помощью пары ../../. Просто считайте каталоги, пока не окажетесь на нужном уровне.

Совет источника: если вы хотите сделать ссылку на страницу, которая находится в верхней части вашего сайта (не глубоко в каталогах), вы можете начать ссылку с косой черты. Это означает «начать с корневого каталога». Итак, href выше может быть просто /images/ . Это избавляет вас от необходимости вводить множество ../../s. Ссылка на главную страницу всегда href="/"

Внешние ссылки

Структура сайта

Без простого плана игры на вашем сайте скоро будет очень трудно найти что-то для вас, учитывая все файлы, которые вы продолжаете накапливать на нем. Таким образом, вам следует сгруппировать страницы схожей тематики в папки (каталоги). Храните все изображения в одной папке, отдельно от html-файлов (назовите папку «images» или «media» или что-то в этом роде).

Я бы также посоветовал вам поработать над шаблоном вашего дизайна. Возможно, сейчас это не важно, так как ваш сайт может не иметь отличительного дизайна, но позже этот файл сэкономит вам часы времени. Что вы делаете, так это сохраняете файл без содержимого, только макет ваших страниц как TEMPLATE.html в каждом каталоге вашего сайта (заглавными буквами, чтобы он выделялся), со всеми правильными ссылками. Затем, когда вы добавляете страницу в папку, вы просто открываете этот файл, добавляете в него свой контент и сохраняете под другим именем, оставляя template.html пустым, готовым к другому использованию. Чтобы увидеть наш шаблон для этого каталога, см. это. Проверьте, у нас есть по одному в каждом каталоге.

Скажем, у вас есть сайт о солнечной системе (просто скажите). Храните все файлы о Марсе в папке «mars», а все изображения Марса — в папке «images» в папке «mars». И сохраните фотографии Урана… нет. Я выше этого.

Гиперссылки действительно важны — именно они делают Интернет сетью. В этой статье показан синтаксис, необходимый для создания ссылки, и обсуждаются рекомендации по созданию ссылок.

Предварительные требования:	Основные знания HTML, описанные в разделе Начало работы с HTML. Форматирование текста HTML, описанное в разделе Основы работы с текстом HTML.
Цель:	Узнать, как эффективно реализовать гиперссылку и связать несколько файлов вместе.

Что такое гиперссылка?

Гиперссылки — одно из самых захватывающих нововведений в Интернете. Они были особенностью Интернета с самого начала и именно они делают Интернет сетью. Гиперссылки позволяют нам связывать документы с другими документами или ресурсами, ссылаться на определенные части документов или создавать приложения, доступные по веб-адресу. Почти любой веб-контент можно преобразовать в ссылку, чтобы при нажатии или другой активации веб-браузер переходил на другой веб-адрес (URL).

Примечание. URL-адрес может указывать на HTML-файлы, текстовые файлы, изображения, текстовые документы, видео- и аудиофайлы или что-либо еще, что находится в Интернете. Если веб-браузер не знает, как отображать или обрабатывать файл, он спросит вас, хотите ли вы открыть файл (в этом случае обязанность по открытию или обработке файла передается подходящему родному приложению на устройстве) или скачайте файл (в этом случае вы можете попробовать разобраться с ним позже).

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

Структура ссылки

Базовая ссылка создается путем переноса текста или другого содержимого (см. Ссылки на уровне блока) внутри элемента и с использованием атрибута href, также известного как гипертекстовая ссылка или цель, которая содержит веб-адрес.

Это дает нам следующий результат:

Добавление вспомогательной информации с помощью атрибута title

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

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

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

Активное обучение: создание собственного примера ссылки

Создайте HTML-документ, используя местный редактор кода и наш шаблон для начала работы.

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

Ссылки на уровне блокировки

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

Примечание. Подробнее об использовании изображений в Интернете вы узнаете из следующей статьи.

Краткий обзор URL и путей

Чтобы полностью понять цели ссылок, необходимо понимать URL-адреса и пути к файлам. В этом разделе содержится информация, необходимая для этого.

URL используют пути для поиска файлов. Пути указывают, где в файловой системе находится интересующий вас файл. Давайте рассмотрим пример структуры каталогов, см. каталог создания гиперссылок.

Корень этой структуры каталогов называется create-hyperlinks . При локальной работе с веб-сайтом у вас будет один каталог, содержащий весь сайт. Внутри корня у нас есть файл index.html и contact.html. На реальном веб-сайте index.html будет нашей домашней страницей или целевой страницей (веб-страницей, которая служит точкой входа для веб-сайта или определенного раздела веб-сайта.).

В нашем корне также есть два каталога — pdfs и Projects. Внутри каждого из них находится один файл — PDF (project-brief.pdf) и файл index.html соответственно. Обратите внимание, что вы можете иметь два файла index.html в одном проекте, если они находятся в разных местах файловой системы. Второй index.html, возможно, будет основной целевой страницей для информации, связанной с проектом.

Примечание. При необходимости вы можете объединить несколько экземпляров этих функций в сложные URL-адреса, например: ../../../complex/path/to/my/file.html .

Фрагменты документа

Возможна ссылка на определенную часть HTML-документа, известную как фрагмент документа, а не только на верхнюю часть документа. Для этого вам сначала нужно присвоить атрибут id элементу, на который вы хотите сослаться. Обычно имеет смысл ссылаться на определенный заголовок, поэтому это будет выглядеть примерно так:

Вы даже можете использовать ссылку на фрагмент документа отдельно, чтобы создать ссылку на другую часть текущего документа:

Абсолютные и относительные URL

В Интернете вы встретите два термина: абсолютный URL и относительный URL:

Абсолютный URL всегда будет указывать на одно и то же местоположение, где бы он ни использовался.

Конечно, расположение файла project-brief.pdf и папки pdfs не изменится внезапно из-за того, что вы переместили файл index.html. Это приведет к тому, что ваша ссылка будет указывать не на то место, и это не сработает. если нажать. Вы должны быть осторожны!

Связать рекомендации

Есть несколько рекомендаций, которым следует следовать при написании ссылок. Давайте посмотрим на это сейчас.

Используйте четкие формулировки ссылок

Размещать ссылки на своей странице легко. Этого не достаточно. Нам нужно сделать наши ссылки доступными для всех читателей, независимо от их текущего контекста и того, какие инструменты они предпочитают. Например:

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

Давайте рассмотрим конкретный пример:

Хороший текст ссылки: Скачать Firefox

Неверный текст ссылки: нажмите здесь, чтобы скачать Firefox

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

Ссылки на не-HTML-ресурсы — оставляйте четкие указатели

При ссылке на ресурс, который будет загружен (например, документ PDF или Word), передан в потоковом режиме (например, видео или аудио) или имеет другой потенциально неожиданный эффект (открывает всплывающее окно или загружает Flash-ролик), вы должны добавьте четкие формулировки, чтобы избежать путаницы.

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

Используйте атрибут загрузки при ссылке на загрузку

Когда вы ссылаетесь на ресурс, который нужно загрузить, а не открыть в браузере, вы можете использовать атрибут загрузки, чтобы указать имя файла сохранения по умолчанию. Вот пример со ссылкой для скачивания последней версии Firefox для Windows:

Активное обучение: создание навигационного меню

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

Вам потребуется сделать локальные копии следующих четырех страниц в одном и том же каталоге. Полный список файлов см. в каталоге navigation-menu-start:

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

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

Примечание. Если вы застряли или не уверены, что все сделали правильно, вы можете проверить каталог navigation-menu-marked-up, чтобы увидеть правильный ответ.

Ссылки по электронной почте

Можно создавать ссылки или кнопки, при нажатии которых открывается новое исходящее сообщение электронной почты, а не ссылка на ресурс или страницу. Это делается с помощью элемента и схемы mailto: URL.

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

В результате появится ссылка, которая выглядит так: Отправить письмо в никуда.

На самом деле, адрес электронной почты не является обязательным. Если вы опустите его, а ваш href будет «mailto:», почтовый клиент пользователя откроет новое окно исходящей электронной почты без адреса получателя. Это часто полезно в качестве ссылок «Поделиться», по которым пользователи могут щелкнуть, чтобы отправить электронное письмо на адрес по своему выбору.

Указание деталей

Помимо адреса электронной почты вы можете указать другую информацию. Фактически, любые стандартные поля заголовка почты могут быть добавлены к указанному вами URL-адресу mailto. Наиболее часто используемые из них — «тема», «копия» и «тело» (которое не является настоящим полем заголовка, но позволяет вам указать короткое содержание сообщения для нового электронного письма). Каждое поле и его значение указываются как условие запроса.

Вот пример, который включает копию, скрытую копию, тему и текст:

Примечание. Значения каждого поля должны быть закодированы в URL-адресе с использованием непечатаемых символов (невидимых символов, таких как символы табуляции, возврата каретки и разрывов страниц) и экранированных пробелов. Также обратите внимание на использование вопросительного знака ( ? ) для отделения основного URL-адреса от значений поля и амперсанда (&) для разделения каждого поля в адресе mailto: URL. Это стандартная нотация запроса URL. Прочтите метод GET, чтобы понять, для чего чаще всего используется нотация URL-запроса.

Вот несколько других примеров адресов электронной почты:

Проверьте свои навыки!

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

Обзор

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

Меньшее, что вам нужно знать о GitHub Pages, — это сфокусироваться на одном: показать, как максимально быстро запустить работающий информационный веб-сайт с помощью GitHub Pages, используя только веб-сайт GitHub.

Начните с простого файла README.md:

Связывание с документами Markdown в том же каталоге

Создать ссылку на документ в текущем каталоге Markdown очень просто:

Терминология и пример структуры каталогов для иллюстрации этих примеров

Вот типичная структура каталогов GitHub Pages.

Корневой каталог

Для целей этих иллюстраций мы будем называть /docs корневым каталогом. Если вы привыкли к Git-проектам или структуре каталогов, вы можете быть озадачены, потому что вы можете думать о / как о корневом каталоге. GitHub Pages предпочитает, чтобы ваша документация начиналась в каталоге /docs, поскольку фактический корень / зарезервирован для кода.

Подкаталог

На приведенном выше рисунке tutorial является подкаталогом /docs . Так же как и активы и справочные каталоги. Вы можете думать о них как о дочерних папках или дочерних каталогах, и это нормально. Однако обычная терминология — это подкаталог.

В зависимости от контекста эти каталоги могут называться /assets , /reference или /tutorial . Это потому, что подразумеваемый корневой каталог — /docs. Их полное обозначение будет /docs/assets и т. д.

Каталог v1 является подкаталогом /reference , поэтому в этих документах он, скорее всего, будет упоминаться как /reference/v1, хотя технически это /docs/reference/v1

Родительский каталог

Противоположностью подкаталога является родительский каталог. Итак:

/ является родителем каталога документов
/docs является родительским каталогом ссылки
/docs/reference является родительским для каталога /v1

Любое описание местоположения файла называется путем. Например, полное имя файла README.md в приведенном выше примере — /docs/README.md. Правильным термином для этого пути является либо абсолютный путь, либо полный путь, по большей части в данном руководстве он называется просто путем.

Относительные каталоги

Последние несколько пунктов описывают относительные каталоги. Относительные каталоги также имеют обозначение, где одна точка, за которой следует косая черта ./, относится к текущему каталогу, а два документа, за которыми следует косая черта ../, относятся к родительскому каталогу. Итак:

Ссылка внутри документа contact.md на файл screenshot-home-1024x512.jpg будет выглядеть так: assets/img/screenshot-home-1024x512.jpg (относительное обозначение не используется)
Относительная ссылка из документа start.md на файл Chapter1.md будет обозначаться как ../chapter1.md в относительном выражении.
Ссылка внутри документа start.md на файл contact.md может быть обозначена как без относительного пути как /docs/contact.md , который также называется полным полное имя пути.
Ссылка внутри документа reference1.0.md на Chapter1.md будет обозначаться как ../../chapter1.md в относительном выражении.

Связывание с документами Markdown в подкаталоге/дочернем каталоге

На основе относительных каталогов приведены полные примеры.

Ссылки Markdown в стиле GitHub с расширением .md автоматически преобразуются в ссылки HTML

Если вы привыкли к HTML, вы, вероятно, заметили что-то странное. Ссылка ведет на contact.md , а не на contact.html , и мы знаем, что работа генератора статических сайтов, такого как Jekyll, который используется GitHub, заключается в преобразовании файлов Markdown в HTML. Как это превращается в действующую ссылку?

Jekyll видит внутренние ссылки, такие как contact.md, и преобразует их во что-то вроде contact или contact.html . Веб-сервер GitHub также соблюдает это соглашение.

Markdown в духе GitHub отличается от стандартного Markdown

GitHub использует расширенную версию Markdown. Функция внутренних ссылок является одним из многих элементов. Полную информацию см. в технической спецификации Markdown Spec со вкусом GitHub.

Ссылка из README.md на статью 2.md будет выглядеть следующим образом:

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

Я работал в крупной страховой компании, и мы как раз занимались проектом по инвентаризации всех используемых электронных таблиц.

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

Мы использовали Excel 2010, и установка надстройки Power Query была невозможна из-за блокировки ИТ-безопасности. С Power Query это заняло бы гораздо меньше времени и не требовало написания кода.

Создать запрос из папки

Из любой книги, в которой вы хотите создать список файлов, вы можете создать запрос из папки. Перейдите на вкладку «Данные» на ленте и выберите «Получить данные» в разделе «Получить и преобразовать». Затем выберите в меню пункт «Из файла», а затем в подменю пункт «Из папки».

Выберите родительскую папку для запроса

Добавьте путь к родительской папке, которую вы хотите запросить. Вы можете скопировать и вставить это из адресной строки проводника Windows или использовать параметр «Обзор», чтобы выбрать папку.

Редактировать запрос из папки

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

Удалить столбец содержимого

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

Чтобы удалить столбец "Содержание", щелкните правой кнопкой мыши заголовок столбца и выберите "Удалить" в меню.

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

Разверните столбец атрибутов для получения дополнительной информации

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

Щелкните левой кнопкой мыши значок фильтра в столбце "Атрибуты".
Выберите или отмените выбор различных атрибутов файлов, которые вы хотите видеть в результатах запроса.
Снимите флажок Использовать исходное имя столбца в качестве префикса, если вы не хотите, чтобы ваши новые столбцы атрибутов имели префикс (например, Attributes.Kind)
Нажмите кнопку ОК.

Теперь вы увидите дополнительные столбцы, которые вы выбрали, в предварительном просмотре редактора запросов.

Закрыть и загрузить запрос

На вкладке "Главная" нажмите кнопку "Закрыть и загрузить".

Результаты запроса: список всех файлов

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

Об авторе

Джон МакДугалл

Джон — Microsoft MVP, внештатный консультант и тренер, специализирующийся на Excel, Power BI, Power Automate, Power Apps и SharePoint. Другие интересные статьи Джона можно найти в его блоге или на канале YouTube.

Читайте также: