Первый пост в блоге с использованием Markdown
Теперь, когда вы построили страницы, используя файлы .astro
, давайте создадим несколько записей в блоге, используя файлы .md
!
Приготовьтесь к...
- Создайть новую папку и создайть новую запись
- Напишите некоторое содержимое Markdown
- Добавить ссылки на ваши записи на страницу вашего блога
Создайте свой первый файл .md
-
Создать новый каталог в
src/pages/posts/
. -
Добавить новый (пустой) файл
post-1.md
внутри вашей новой папки/posts/
. -
Найти эту страницу в браузерном предпросмотре, добавив
/posts/post-1
в конец вашего существующего URL-адреса предварительного просмотра.(например,
http://localhost:4321/posts/post-1
) -
Измените URL-адрес предварительного просмотра в браузере, чтобы просмотреть
/posts/post-2
вместо этого. (Это страница, которую вы еще не создали.)Обратите внимание на различный вывод при предварительном просмотре «пустой» страницы и страницы, которой еще не существует. Это поможет вам устранить проблемы в будущем.
Напишите содержимое Markdown
-
Скопируйте или введите следующий код в файл
post-1.md
-
Проверьте предварительный просмотр в браузере снова
http://localhost:4321/posts/post-1
. Теперь на этой странице должно быть содержимое. -
Используйте инструменты разработчика вашего браузера, чтобы проверить эту страницу. Обратите внимание, что хотя вы не ввели никаких элементов HTML, ваш Markdown был преобразован в HTML. Вы можете увидеть элементы, такие как заголовки, абзацы и пункты списка.
Информация в верхней части файла, в кодовых заграждениях, называется frontmatter. Эти данные, включая теги и изображение для записей, являются информацией о вашей записи, которую Astro может использовать. Они не появляются на странице автоматически, но мы будем использовать их позже в учебнике для улучшения вашего сайта.
Ссылка на ваши посты
-
Добавьте ссылку на ваш первый пост с помощью тега якоря в файле src/pages/blog.astro:
-
Теперь добавьте еще два файла в папке
src/pages/posts/
:post-2.md
иpost-3.md
. Вот небольшой пример кода, который вы можете скопировать и вставить в эти файлы, или написать свой: -
Добавьте ссылки на эти посты:
-
Проверьте предварительный просмотр в вашем браузере и удостоверьтесь, что:
- Все ваши ссылки на Post 1, Post 2 и Post 3 ведут на рабочую страницу на вашем сайте. (Если вы обнаружили ошибку, проверьте ваши ссылки на
blog.astro
или имена файлов Markdown.)
- Все ваши ссылки на Post 1, Post 2 и Post 3 ведут на рабочую страницу на вашем сайте. (Если вы обнаружили ошибку, проверьте ваши ссылки на
Проверьте свои знания
- Контент в файле Markdown (
.md
) преобразуется в:
Чек-лист
Ресурсы
-
Шпаргалка по Markdown от The Markdown Guide внешняя ссылка
-
Что такое инструменты разработчика браузера? MDN внешняя ссылка
-
YAML frontmatter внешняя ссылка