[](https://starlight.astro.build)
```
npm create astro@latest -- --template starlight
```
[](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
[](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
[](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
## 🚀 Project Structure
Inside of your Astro + Starlight project, you'll see the following folders and files:
```
.
├── public/
├── src/
│ ├── assets/
│ ├── content/
│ │ ├── docs/
│ │ └── config.ts
│ └── env.d.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json
```
Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
Images can be added to `src/assets/` and embedded in Markdown with a relative link.
Static assets, like favicons, can be placed in the `public/` directory.
## 🧞 Commands
All commands are run from the root of the project, from a terminal:
| `npm run dev` | Starts local dev server at `localhost:4321` |
| `npm run build` | Build your production site to `./dist/` |
| `npm run preview` | Preview your build locally, before deploying |
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
| `npm run astro -- --help` | Get help using the Astro CLI |
## 👀 Want to learn more?
Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
1. **Абдуллин Р. К., Пономарчук А. И.** Технологии интернет-картографирования: учебное пособие / Пермский государственный национальный исследовательский университет. - Пермь, 2020. – 132 с.: ил. [[↗]](https://gis.psu.ru/publications/технологии-интернет-картографирован/)
1. **Аляутдинов А. Р., Лурье И. К., Ушакова Л. А.** Основные принципы функционирования геоинформационных ресурсов // Известия высших учебных заведений. Геодезия и аэрофотосъемка. — 2016. — Т. 60, № 5. — С. 123–128 [[↗]](https://elibrary.ru/item.asp?id=27224121)
2. **Абдуллин Р. К., Пономарчук А. И.** Технологии интернет-картографирования: учебное пособие / Пермский государственный национальный исследовательский университет. - Пермь, 2020. – 132 с.: ил. [[↗]](https://gis.psu.ru/publications/технологии-интернет-картографирован/)
3. **Берлянт А. М.** Геоинформационное Картографирование. М.: Моск. гос. Ун-т им. М. В. Ломоносова, Рос. акад. естеств. наук, 1997. [[↗]](https://rusneb.ru/catalog/000199_000009_000611203/)
4. **Каргашин П. Е.** Основы цифровой картографии: Учебное пособие для бакалавров. 5-е изд., перераб. — Москва: Издательско-торговая корпорация Дашков и К, 2023. — 106 с. [[↗]](https://istina.msu.ru/publications/book/557759518/)
5. **Лурье И. К.**, Самсонов Т.Е. Структура и содержание базы пространственных данных для мультимасштабного картографирования // Геодезия и картография. – 2010. – № 11. –С. 17-23. [[↗]](https://istina.msu.ru/publications/article/427465/)
6. **Титов Г. С., Прасолова А. И., Каргашин П. Е.** Веб-картографирование ресурсов солнечной энергии Якутии // ИнтерКарто. ИнтерГИС. — 2021. — Т. 27, № 3. — С. 210–220. [[↗]](https://istina.msu.ru/publications/article/412375618/)
7. **Титов Г. С.** Текущие проблемы терминологического аппарата отечественной веб-картографии // Геодезия, картография, геоинформатика и кадастры. Производство и образование : Сб. материалов IV Всероссийской науч.-практ. конф. — СПб Политехника: 2021. — С. 317–323. [[↗]](https://istina.msu.ru/publications/article/716105082/)
8. **Kraak M. J.** Web Cartography: Developments and Prospects. Edited by M. J. Kraak and Allan Brown. New York: Taylor & Francis, 2001. [[↗]](https://doi.org/10.1201/9781482289237)
9. **Muehlenhaus I.** Web Cartography: Map Design for Interactive and Mobile Devices. Boca Raton, FL: CRC Press, 2014. [[↗]](https://doi.org/10.1201/b16229)
10. **Neumann A.** Web Mapping and Web Cartography. In Springer Handbook of Geographic Information, edited by Wolfgang Kresse and David M. Danko, 273–87. Berlin, Heidelberg: Springer Berlin Heidelberg, 2011. [[↗]](https://doi.org/10.1007/978-3-540-72680-7_14)
11. **Myslenkov S., Samsonov T., Shurygina A. et al.** Wind waves web atlas of the russian seas // Water. — 2023. — Vol. 15, no. 11. — P. 2036. [[↗]](http://dx.doi.org/10.3390/w15112036)
12. ГОСТ Р 58570-2019. Инфраструктура Пространственных Данных. Общие Требования // Стандартинформ, 2019. [[↗]](https://docs.cntd.ru/document/1200168445)
1. **Берлянт А. М.** Геоинформационное Картографирование. М.: Моск. гос. Ун-т им. М. В. Ломоносова, Рос. акад. естеств. наук, 1997. [[↗]](https://rusneb.ru/catalog/000199_000009_000611203/)
1. **Каргашин П. Е.** Основы цифровой картографии: Учебное пособие для бакалавров. 5-е изд., перераб. — Москва: Издательско-торговая корпорация Дашков и К, 2023. — 106 с. [[↗]](https://istina.msu.ru/publications/book/557759518/)
1. **Лурье И. К., Самсонов Т.Е.** Структура и содержание базы пространственных данных для мультимасштабного картографирования // Геодезия и картография. – 2010. – № 11. –С. 17-23. [[↗]](https://istina.msu.ru/publications/article/427465/)
1. **Титов Г. С., Прасолова А. И., Каргашин П. Е.** Веб-картографирование ресурсов солнечной энергии Якутии // ИнтерКарто. ИнтерГИС. — 2021. — Т. 27, № 3. — С. 210–220. [[↗]](https://istina.msu.ru/publications/article/412375618/)
1. **Титов Г. С.** Текущие проблемы терминологического аппарата отечественной веб-картографии // Геодезия, картография, геоинформатика и кадастры. Производство и образование : Сб. материалов IV Всероссийской науч.-практ. конф. — СПб Политехника: 2021. — С. 317–323. [[↗]](https://istina.msu.ru/publications/article/716105082/)
1. **Kraak M. J.** Web Cartography: Developments and Prospects. Edited by M. J. Kraak and Allan Brown. New York: Taylor & Francis, 2001. [[↗]](https://doi.org/10.1201/9781482289237)
1. **Muehlenhaus I.** Web Cartography: Map Design for Interactive and Mobile Devices. Boca Raton, FL: CRC Press, 2014. [[↗]](https://doi.org/10.1201/b16229)
1. **Neumann A.** Web Mapping and Web Cartography. In Springer Handbook of Geographic Information, edited by Wolfgang Kresse and David M. Danko, 273–87. Berlin, Heidelberg: Springer Berlin Heidelberg, 2011. [[↗]](https://doi.org/10.1007/978-3-540-72680-7_14)
1. **Myslenkov S., Samsonov T., Shurygina A. et al.** Wind waves web atlas of the russian seas // Water. — 2023. — Vol. 15, no. 11. — P. 2036. [[↗]](http://dx.doi.org/10.3390/w15112036)
1. ГОСТ Р 58570-2019. Инфраструктура Пространственных Данных. Общие Требования // Стандартинформ, 2019. [[↗]](https://docs.cntd.ru/document/1200168445)
Пособие призвано ввести читателя в сферу веб-картографии через практику. Мы будем акцентировать внимание на принципах работы веб-карт. Это позволит в короткие сроки освоить ключевые навыки, необходимые для веб-картографирования.
Чтобы сделать карту реально доступной, надо думать о том, как сделать её доступной через Интернет. За короткий срок веб-карта стала привычным интерфейсом доступа к информации о местности.
Книга будет полезна специалистам в области картографии, которые хотят выяснить, как работают карты в Интернете, и веб-разработчикам, которые хотят понять особенности картографических интерфейсов и пространственных данных.
Пособие призвано через практику ввести читателя в сферу веб-картографии.
Пособие базируется на [курсе по веб-картографии](https://cartetika.ru/webcartography-i), который регулярно читается в Картетике, и многолетнем опыте работы на пересечении картографии и веб-разработки.
Мы будем акцентировать внимание на принципах работы веб-карт. Это позволит в короткие сроки освоить ключевые навыки, необходимые для веб-картографирования, и получить прочный задел для дальнейшего роста в этой сфере.
```sh title="Пишем код"
Главный способ донесения информации --- практика
```
Основу пособия составляют практические упражнения. В каждом упражнении мы создадим функциональную веб-карту.
Пособие базируется на [курсе по веб-картографии](https://cartetika.ru/webcartography-i), который регулярно читается в Картетике, и многолетнем опыте работы на пересечении картографии и веб-разработки.
## Кому адресовано
Содержание пособия *протестировано* на следующих группах
1. Картографы и географы, которые хотят разобраться, как работают **веб**-карты
2. Веб-разработчики, которые хотят разобраться, как работают веб-**карты**
Картографы и географы выяснят, как представить свои материалы и наработки в виде доступной через Интернет интерактивной карты. Веб-разработчики поймут особенности картографических интерфейсов и пространственных данных.
А если вы не относитесь ни к одной из этих групп, то вы можете узнать всё это сразу! Но потребуется больше работы.
Читать пособие будет проще с базовыми навыками в HTML, CSS, JavaScript и знанием основ геоинформационного картографирования.
## Содержание
Основу пособия составляют практические упражнения. Они последовательно знакомят с подходами создания веб-карт от простого к сложному.
В каждом упражнении мы создаём функциональную веб-карту.
---
Каждая позволяет на практике закрепить принципы веб-картографирования.
Каждая знакомит с устоявшимися подходами к созданию веб-карт.
Каждая является практичной заготовкой для решения собственных задач.
---
В разделе "Литература" перечислены теоретические и практические публикации по веб-картографии, использованные в качестве источников для данного пособия. В разделе "Внеклассное чтение" предлагаются заметки, углубляющие содержание некоторых разделов.
## Обратная связь
Каждая позволит на практике закрепить базовые принципы веб-картографирования.
Замечания и предложения принимаются через [репозиторий](https://github.com/gtitov/wm101/issues) пособия. Пожалуйста, не стесняйтесь сообщать об ошибках, неточностях, опечатках.
Каждая познакомит с устоявшимися подходами к созданию веб-карт.
Каждая является практичной заготовкой для решения собственных задач.
gman
5 months ago