Содержание

Садовые дорожки — из чего и как это делается

Садовые аллейки должны быть размечены и оформлены таким образом, чтобы соответствовать общему дизайну садового участка. Этому должно быть посвящено все — структура, контуры, материал и тип мощения. Из чего делать такие дорожки, должно определяться в зависимости от интенсивности использования.

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

Дорожка из гравия

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

Если недалеко находится ЖБК или карьер, изготавливающие или применяющие щебень, то с материалом для постройки не будет никаких проблем. Тропинки из щебня или гравия просто делаются и долго служат. Для изготовления такой тропинки вначале необходимо изготовить ложе согласно проложенному контуру глубиной примерно 15 см. Дно получившейся канавки необходимо тщательно утрамбовать (утоптать) и затем высыпать ровным слоем гравий покрупнее, перемешав его с тяжелой жирной глиной. Толщину нижнего слоя нужно выдержать в пределах 10-12 см.

После этого получившийся слой полить водой, вновь утрамбовать и покатать катком для прочности. Для укладки верхнего слоя берется гравий помельче и укладывается слоем 3-5 см. Его также следует утрамбовать, поливая водой, чтобы добиться усадки.

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

Чтобы гравийная тропинка не осыпалась, ее можно укрепить с боков бордюрным камнем. Он может находиться вровень с полотном или чуть возвышаться над ней — на 5-7 см. В таком случае при планировании необходимо учитывать толщину бордюров — по 20 см с обеих сторон. Для укладки бордюра можно выполнить фундамент в виде бетонной подушки.

Точно так же, как и гравийную, можно изготовить песчаную дорожку. Просто гравий можно заменить на крупнозернистый песок (речной).

Дорожка из шпал

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

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

Технология изготовления дорожки такова:

Необходимо взять веревку (можно использовать садовый шланг) и метр или рулетку. При помощи этого инструмента размечается дорожка около 70 см шириной. Затем, согласно разметке, делается ложе (канавка глубиной 20-30 см) для будущей дорожки. Дно засыпаются слоем песка толщиной около 10 см. По сторонам устанавливается бортик из соединенных между собой деревянных столбиков.

Берут либо шпалы по 50-55 см длиной или же бруски, нарезанные на куски того же размера. Нижние и боковые (которые будут в земле) грани обрабатываются гидроизоляционным покрытием, а верхняя поверхность — пинотексом. Шпалы укладываются на подготовленную отмостку из песка с зазорами по 4-7 см. Пространство между шпалами или брусками заполняется гравием с последующей трамбовкой.

Дорожка из кирпичного боя или шлака

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

Как и при обустройстве тропки из гравия, делается канавка глубиной сантиметров 15, причем дно желательно сделать выпуклым. Затем все утрамбовать, и высыпать крупный строительный мусор (шлак или бой кирпича), чтобы получился слой в 10-12 см. Все это хорошенько утрамбовать, поливая водой. Затем вторыми слоем насыпать мелочь до необходимого уровня или чуть выше. Желательно покрыть тропинку «финишным» слоем глины в 1-2 см, перемешав с очень мелким щебнем. И снова хорошо утрамбовать.

Дорожка из брусчатки

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

Толщина такой подушки должна быть около 5 см. Расход песка составит 0,5 м3 на 20 квадратных метров. Однако если на дорожку все же планируется большая нагрузка, лучше использовать для крепления брусчатки строительный раствор.

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

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

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

После окончания укладки промежутки между плитками можно заделать раствором из цемента и песка (в соотношении 3:1). На таких типах дорожек бордюрные камни обычно не предусматриваются, чтобы обеспечить водосток.

Дорожки из кирпича

Кирпичные дорожки всегда получаются практичными и служат долго. Кирпич можно выкладывать различными схемами: как плашмя, так и на ребро. Готовить основание необходимо так же, как и для строительного шлака. Только в качестве нижнего опорного слоя лучше использовать слой крупнозернистого речного песка толщиной 10 см, формирующий выпуклость в ходе трамбовки. После подготовки песок смачивают водой для устойчивости и укладывают дорожку, используя выбранный рисунок кладки. По бокам аллейки ряд кирпичей укладывают на ребро, чтобы образовался бордюрчик.

Дорожка из бетонных плит

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

Для укладки предварительно делают ровное основание (из песка). На него и укладывают плиты, выравнивая по верхней поверхности. Промежутки между плитами можно делать шириной до 4-6 см. Их можно затем засыпать грунтом и засеять травой.

Бетонные плиты для дорожки можно изготовить самостоятельно. Нужна самодельная опалубка из брусков одинакового размера. Лучше всего, 50 на 50. Форма должна быть идеально прямоугольной. В качестве основания подойдет любая не пропускающая воду ровная поверхность.

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

Природный камень

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

Выкладываются камни на песчаное основание, размеры которого определяются по размеру самых больших булыжников. Плоские камни выкладываются на песчаное основание толщиной от 1 до 5 см. Расстояние между камнями рекомендуют делать 2-3 см. Промежутки лучше всего заполнить раствором до уровня поверхности камней. Делать глубокую расшивку в таких случаях не советуют, чтобы в зимний период влага не приводила к разрушению покрытия. Крупные булыжники лучше укладывать с промежутками 5-8 см, заполняя пространство между ними землей и засеивая травкой.

Дорожки «вразбежку»

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

Дорожки из тротуарной плитки

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

Самые популярные виды плитки: Волна, Булыжник и Классика. Для прямых дорожек лучше всего подойдет Брусчатка. Но при работе с тротуарной плиткой можно отойти от унылой прямолинейности и постараться выложить на дорожках (если позволяет ширина плитки) круги, фигуры и разводы. Для этого лучше использовать плитку типа Классика.

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

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

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

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

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

Перейти в раздел: Ландшафтные материалы и элементы благоустройства → Плитка тротуарная вибропрессованная

Дорожки и тропинки

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

Прокладка дорожек

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

Особенно «завлекательны» дорожки, ведущие как бы в неведомое. Благодаря смещениям высокие растения закрывают перспективу, извилистая тропинка вдоль живой изгороди придает прогулке по саду некоторую таинственность. Тогда, если дорожки ведут еще к укромному уголку сада, например, к беседке или к какому-нибудь особенно красивому кусту, вы всегда с удовольствием идете по ней до конца.

Ширина дорожек

В зависимости от своего предназначения дорожка должна иметь соответствующую ширину. Главная дорожка, по которой часто ходят и возят тележку, должна иметь ширину минимум 90 см. У входа, то есть в палисаднике, прокладываем дорожку шириной 120-150 см, чтобы по ней могли пройти без проблем рядом два человека. В отдаленных частях сада и в огороде достаточно 40-50 см, а между грядками еще уже.

Покрытия

Дорожки, по которым часто ходят, мостят твердыми, прочными плитами или камнем. Нужно, чтобы материал соответствовал характеру сада. В продаже имеется большой выбор: брусчатка из природного камня, кирпич, плитка, прессованная из осколков камня, и многие другие виды дорожных покрытий в большом ассортименте. Подходят и дощатые мостовые. Хорошо впишутся в посадки деревянная мостовая, брусчатый настил или просто гравий. Второстепенные дорожки, по которым ходят реже, можно выложить мягким покрытием. По мульче из древесной коры или по дорожке, покрытой травой, можно идти, как по бархату. Очень натурально выглядят покрытия с зазорами или из решетчатых каменных плит. Таким образом остается пространство для зелени.

Камни, на которые наступают

Легче и менее компактно, чем сплошное покрытие, выглядят отдельные камни, которые выполняют ту же функцию, что и дорожки. Чтобы ходить по ним было удобно, величина их должна быть 40×40 см. Отдельные плитки, природные камни, или плоские булыжники, а также деревянные круги или брус раскладываются на равном расстоянии друг от друга на газоне, между грядками или даже через мелкую часть пруда. При этом следует учитывать средний размер шага (60-65 см от середины одной плитки до середины другой).

Въезд в гараж и автостоянка

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

Лестницы

Перепад высоты больше 5% должен быть соединен лестницей. Часто терраса находится выше остального уровня сада. Тогда несколько ступенек удобно соединяют дом и сад. Оптимальная высота ступени составляет 12-17 см. Для определения идеальной глубины ступеньки исходят из длины шага и высоты ступеньки. По формуле «две высоты ступеньки плюс глубина ступеньки равны идеальной длине шага в 67 см» легко вычислить требуемую длину. Ступеньки у лестниц всегда должны быть одинаковой глубины и высоты, и эти нечетко видные уступы должны быть обязательно занесены в план. Ступеньки неравной высоты опасны, о них можно споткнуться. Различают несколько видов ступенек. Приставные ступеньки состоят из фронтальной и горизонтальной плит, а есть ступеньки из укладываемых друг на друга слоями плит и блоков из массивных тесаных камней. Чтобы общая картина была гармоничной, лестницы делают обычно из того же материала, что и дорожки, и каменные стены.

Похожие материалы

Деревянные дорожки на даче своими руками: тропинки из дерева

Стремление к красоте присуще человеку от природы. Поэтому, оформляя ландшафтный дизайн и обустраивая приусадебный или дачный участок, мы стараемся создавать вещи не только практичными, но и красивыми.

 

Садовые дорожки из дерева своими руками

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

Садовые дорожки на даче или приусадебном участке могут быть выполнены из различных материалов: из гравия, песчаника, камня, бетона, кирпича, тротуарной плитки, брусчатки и даже из пробок от пластиковых бутылок. Но, что может быть более естественно, чем применить для устройства дорожки в саду натуральное дерево. Причем во всем своём многообразии.

Деревянные дорожки возле дома могут быть реализованы в самых разных формах и видах. Главное, что дорожки или тропинки из дерева можно изготовить своими руками, не затрачивая больших средств.

Виды и типы дорожек из дерева

Разные варианты в зависимости от применяемой древесины.

Дорожки из спила дерева

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

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

Деревянные дорожки из спилов дерева

Дорожки из деревянных досок

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

Дорожки из деревянных досок

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

Пенотекс позволит придать древесине нужный оттенок.

Схема устройства деревянных дорожек из досок

Дорожки из деревянного бруса

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

Дорожки из деревянного бруса

Дорожки из деревянных щитов (садового паркета)

В качестве материала используются щиты, изготовленные из досок или композитного материала. Наиболее популярный вариант — садовый паркет декинг (садовое покрытие, плитка), который может быть из лиственницы, сосны, термоберезы, ДПК.

Дорожки из садового паркета, деревянных щитовУстройство и укладка садового паркета

Фигурные деревянные дорожки

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

Фигурные (резные) элементы для мощения деревянных дорожекКреативные фигурные деревянные дорожки — дубовый, кленовый лист, лапы

Дорожки из коры деревьев (мульчи)

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

Дорожки из коры деревьев (из мульчи)

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

Засыпка мульчи — как сделать дорожку из коры дерева

Дорожки из скорлупы орехов (декоративные садовые дорожки)

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

Скорлупа кедрового ореха и вид дорожки из кедровой скорлупы

Дорожки из веток, стволов не крупных деревьев или бамбуковых стеблей

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

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

Дорожки из веток и некрупных стволов деревьев

Кроме того, помимо одноуровневых садовых дорожек из дерева (расположенных в одной плоскости) возможно устройство многоуровневых (многоярусных) в виде ступенек.

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

Как сделать деревянную садовую дорожку своими руками

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

Материал
  • Доска обрезная, брус, садовый паркет, спилы (порода древесины выбирается произвольно, например, сосна, дуб, лиственница, тополь)
  • Материл для бордюр, бортиков (деревянный, бетонный, металлический)
  • Песок, гравий, галька (для засыпки подушки и заполнения промежутков)
  • Обмазочная и рулонная гидроизоляция, для придания цвета – пинотекс желаемого оттенка
Инструмент
  • Бензопила
  • Электрорубанок
  • Ножовка
  • Рулетка
  • Лопата
  • Молоток, киянка

Технология устройства дорожек и площадок из дерева

  1. Разметка дорожки (с помощью рулетки и веревки с колышками размечаем нужную траекторию будущей тропы. Ширина дорожки выставляется произвольно, оптимально 0,5-1 метр)
  2. Подготовка основания (на размеченной полосе нужно снять верхний слой дерна. Глубина углубления зависит от выбранного материала для дорожки. Достаточно 20-40 см)
  3. Устройство гравийно-песчаной подушки (дно выкопанной канавы застилается слоем рулонной гидроизоляции или просто пленкой. Это исключит проникновение сырости и нежелательный рост сорняков и травы. Поверх гидроизоляции засыпается слой песка или гравия, которые послужат основой для укладки и будут выполнять роль дренажной системы)
  4. Установка бордюра (если предусмотрены бортики, то они устанавливаются по краю траншеи)
  5. Укладка дорожного материала (доски, брус, щиты, срезы дерева) Предварительно пиломатериал нужно нарезать нужной длины и обработать: поверхность досок и бруса можно обстрогать электрорубанком. После этого следует проолифить, обработать древесным антисептиком, обмазочной гидроизоляцией или битумом.
  6. Выкладка пиломатериала на подушку (укладка выполняется с учетом запланированного расположения, т.е. с промежутками или без. Ориентировочно, расстояние между досками, брусом или пеньками может быть в пределах 5-8 см)
  7. Уложенный деревянный материал нужно выровнять (уплотнить), для этого лучше использовать киянку, а не молоток. Благодаря её резиновой основе исключается вероятность повреждения пиломатериала (трещины, вмятины)
  8. Пространство между пиломатериалом (промежутки) засыпаются галькой, гравием или другими сыпучими элементами.

Вывод

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

Дорожки из дерева — фото

Дорожки и ступеньки из дерева в ландшафтном дизайнеДекоративная дорожка из круглых деревянная дисковСадовая дорожка из деревянных щитов квадратной и прямоугольной формыТропинка к дому из досок с фигурно вырезанной кромкойДеревянная дорожка для дачи из состаренной доскиПодсветка деревянной дорожки и помостаДеревянный настил-дорожка в ландшафтном дизайне садового участкаДеревянная дорожка из бруса возле загородного дома

Садовая дорожка из бетона


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


Планировка садовой дорожки.


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

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

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

Ширину дорожек из бетона выбирают исходя из функциональных назначений и комфорта: для основных дорожек применима ширина в 80-100 см., для второстепенных достаточно будет 30-40 см. Если же речь идет о дорожке у гаража, то для ориентира берется ширина автомобиля.


Выбор качественного материала.


Для бетонной дорожки рекомендовано применять пескобетон или песчано-цементную смесь марки по прочности на сжатие не менее М200. Чем выше марка раствора, тем выше показатели долговечности. Оптимальным решением для садовой дорожки является марка М300. Качественный пескобетон имеет ряд преимуществ за счет правильного соотношения песка и цемента, и также его использование избавит от хлопот с приготовлением самодельного раствора: добавлением правильных пропорций цемента в раствор, поиском хорошего песка и его просеивания.

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


Последовательность работ при устройстве садовой дорожи:


1. Снятие дерна и выкапывание траншеи под основание.

источник: forumhouse


Распланировав расположение и ширину бетонной дорожки на участке устанавливается разбивка: по всей длине будущей дорожки вбиваются колья на расстоянии 1,5 – 2,5 м друг от друга, на изгибах применимо расстояние 30-50 см. Между кольями натягивается шнур. И выкапывается траншея согласно разметке.

Глубина траншей для пешеходных дорожек — 25-30 см (без учета толщины плодородного слоя). Для бетонной дорожки под стоянку автомобиля толщина увеличивается до 40 см. Если на участке глинистый грунт, то выемку нужно сделать глубже, так как такой грунт имеет способность пропускать через себя воду, а склонность к морозному пучению (увеличение объема грунта при замерзании и его уменьшение – при оттаивании) увеличивается;


2. Установка опалубки.

источник: forumhouse


Опалубку крепят к колышкам разметки так, чтобы они оставались снаружи. Над уровнем грунта опалубка должна возвышаться на 4-5 см. За счет того, что раствор важно заливать частями, чтобы получить поперечные швы для компенсации циклов сжатий и расширений бетона под воздействием температуры, опалубку также возможно устанавливать частями по дорожке. Если опалубка уже установлена на всю длину дорожки, то ее необходимо разбить на небольшие участки;


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


Важно. При устройстве бетонных дорожек (из растворных или бетонных смесей) необходимо устраивать поперечные швы на расстоянии 1.5-2.0 метра друг от друга для предотвращения появления деформационных трещин. Чем короче эти отрезки, тем прочнее будет дорожка, тем больше она защищена от трещин, которые могут образоваться от перепадов температур и механических нагрузок.


3. Устройство песчано-щебневой подушки, т.е. основания дорожки.

источник: forumhouse


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

Для пешеходных дорожек бетонный слой составит 8 – 10 см, для автомобильных – 10 – 15 см., соответственно все остальное это и будет основание.

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


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


4. Укладка арматурной сетки.


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

Лучшим армирующим слоем для бетонной дорожки считается сетка с ячейками 10х10 см, сваренная из прутьев диаметром 8 мм, или прутья, связанные в армирующий каркас. Также для армирования применяют фиброволокно или сетку рабицу. Сетка должна быть поднята над уровнем пленки минимум на 15 мм, так как должна иметь защитный слой, который будет предотвращать коррозию металлических деталей армирующего каркаса. Сетка или прутья должны быть объединены в общий каркас, так чтобы он воспринимал нагрузку, как одно целое;


5. Бетонирование дорожки.


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

Если есть необходимость придать раствору более высокую подвижность лучше заменить привычную воду на всего добавки-пластификаторы. Золотое правило: «больше воды – ниже прочность».

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

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


Совет: Используемый раствор должен быть ни густым, ни жидким – жидкий будет трескаться при высыхании, а слишком густой невозможно распределить по опалубке. Добавки – пластификаторы помогут довести смесь до нужной консистенции. Рекомендуем использовать добавки в жидком виде, и обязательно выполнять требования инструкций к их применению.

источник: forumhouse


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

источник: forumhouse


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

Залитый бетонный раствор разравнивают правилом и с силой уплотняют.


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

из чего и как выложить садовые дорожки самостоятельно?: Общество: Облгазета

При устройстве дорожек нужно помнить, что они должны максимально удобно связывать все важные и часто посещаемые объекты на участке. Фото: Наталья Шадрина

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

Прямые или извилистые

– Самое главное – тщательно продумать план своего садового участка, учитывая его площадь и назначение дорожек. Важно исходить из функциональности сада и грамотно соединить дорожками те участки, куда вы чаще всего направляетесь, – комментирует «Облгазете» ландшафтный дизайнер из Екатеринбурга Наталья Шадрина. – Например, кому-то нужно только дойти до грядок и какой-то хозяйственной постройки, а кому-то хочется устроить прогулочную тропу и велодорожку по периметру.

Чаще всего об устройстве дорожно-тропиночной системы задумываются при покупке нового садового участка, где ничего нет. Тогда можно действительно сделать тот сад, который хочется. Однако иногда появляется желание кардинально изменить внешний вид и старого садового участка, что сложнее. Особенно если это территория, где уже десятилетиями протоптали и сделали все дорожки. Но и таким участкам можно дать вторую жизнь. Для этого стоит ещё в начале дачного сезона забыть о прежнем устройстве сада и нарисовать план желаемых изменений, учитывая имеющиеся постройки, которые нельзя перенести. Тогда можно, например, зону отдыха обустроить или декоративный водоём сделать, и вести новую тропиночную сеть вокруг них и других объектов.

– Дорожки бывают разные и устраиваются в соответствии с типом и площадью участка. Например, дорожки в деревенском саду могут быть узкими (60–80 сантиметров) и не капитальными. А в классическом саду шире (до полутора метров), чтобы по ним можно было, например, свободно проехать с коляской или с мелкой садовой техникой, – рассказывает Наталья Юрьевна. – Прямые линии дорожек прекрасно впишутся в регулярный сад с геометрически правильной планировкой, а петляющие – для сада лесного или восточного стиля. А если просторы позволяют, то стоит сделать извилистую прогулочную тропу, за каждым поворотом которой будет какой-то «сюрприз»: декоративный куст, цветник, рокарий, садовая фигура. Но многие просто сочетают дорожки строгих линий с живописными кривыми.

Камень или дресва

Мощение садовых дорожек сегодня не менее разнообразно, чем их формы. Всё зависит от стиля садового участка, основной постройки на нём, назначения тропинок и… свободных средств.

Так, наиболее бюджетным и распространённым вариантом, по словам эксперта, остаются дорожки с мягким покрытием: дресва, гравий, галька, песок, трава. Чаще всего эти материалы используются для дорожек на чисто рабочих садовых участках или для пешеходных тропинок и довольно симпатично смотрятся, особенно если выложить ими какой-то узор или рисунок. Но, увы, эти дорожки самые недолговечные. Материалы с них рассеиваются, осыпаются и разрушаются, поэтому за такими тропками придётся больше ухаживать и обновлять их каждые два-три года. К менее долговечным относятся и садовые дорожки из дерева, древесных спилов и искусственных покрытий: пластиковая плитка, резина, искусственная трава.

– Мягкие покрытия неплохи, но многие сегодня отдают предпочтения дорожкам из твёрдых материалов: камень, бетон, плитка. Плитка более эстетична, чем бетон, но самым лучшим вариантом будет камень, например плитняк. О проблемах с такими дорожками можно забыть на много лет, но они же и самые дорогостоящие, – говорит Наталья Шадрина. – Но многие выбирают смешанный тип покрытий: центральные тропинки в саду делают из камня, а соединительные и второстепенные, допустим, из дресвы или песка. Главное – сохранять стилевое единство дорожек.

Слой за слоем

Прежде чем начинать устройство дорожек в саду самим, важно обозначить их контур и снять грунт на этом месте не менее чем на 15 сантиметров. Для выравнивая покрытия на утрамбованную поверхность лучше досыпать песка. Для сохранения ровности краёв будущей тропы внутри, по всей длине стенок котлована, лучше установить доски. Укладку дорожки, как рассказывает Наталья Юрьевна, проводят на сухую смесь, бетон или песок, так что стоит заранее продумать будущую «подушку» тропинки.

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

После необходимо только дождаться, чтобы любая садовая дорожка «осела», и украсить её. Например, бордюрами вдоль неё, садовыми фигурами или другими декоративными элементами.

КСТАТИ

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

  • Опубликовано в №84 от 18.05.2019 

Устройство садовой дорожки

Мощеная дорожка в саду должна быть не только красивой и удобной, но и, что не менее важно, долговечной и не нарушающей естественного стока воды на участке. 

Долговечность мощеной дорожке может придать только высококачественный плотный геотекстиль, уложенный в два слоя. Если Вы делаете мощеную дорожку для себя и не хотите спустя 2-3 года ее перекладывать, то в данном случае рекомендуется применять геотекстиль. 

 

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

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

 

Применение геотекстиля влечет за собой ряд преимущсетв:

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

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

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

 

 Правильная технология создания долговечной и красивой мощёной дорожки такова:

  1.  Разложите прямо на землю тротуарную плитку (брусчатку) по месту будущей дорожки — так будет легче определить контур канавки для ее укладки.

  2. Выкопайте канавку глубиной в 1,5 штыка лопаты по ширине дорожки. Выровняйте дно канавки, убрав оттуда все острые предметы — камни, стекло и т.п. Если поперек канавки проходит корень близстоящего дерева — его можно оставить и не вырубать. Дорожке он не помешает, а дерево не будет травмировано.

  3. На дно канавки корытом укладывается первый слой геотекстиля так, чтобы его края слегка выступали над уровнем земли (фото 1).

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

  5. На щебенку настилается корытом еще один слой геотекстиля, поверх которого насыпается слой слегка влажного песка толщиной примерно 10 см (фото 1 и 4).

  6. На песок уложите тротуарную плитку (брусчатку) необходимым узором. Каждая плитка должна быть плотно утрамбована по месту резиновым молотком (фото 2). 

  7. После того, как вся плитка (брусчатка) уложена, обрежьте выступающие над уровнем земли края геотекстиля. 

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

  9. Засыпьте все щели вдоль готовой дорожки землей и посейте семена газонной травы, смешанные с песком. Через 1-2 недели дорожка будет выглядеть так, будто она длительное время является является неотъемлемой частью ландшафта Вашего участка.

 

Для данного вида работ рекомендуется применять геотекстиль следующих плотностей: 100, 150, 200, 250. 

фото 55 оригинальных идей оформления

Элегантная дорожка, всплывающая среди белоснежных камешков

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

Более всего популярны потрясающие аллеи и тропинки, сооружённые из натурального камня. Они сами по себе могут прекрасно дополнять текстуры и разнообразить сочную зелень, но можно проявить капельку креатива и создать великолепные шедевры со своим оригинальным сюжетом, очарованием контуров и грубоватыми формами.

Сказочная тропинка среди буйства декоративных насаждений

Прямоугольные фрагменты породы в окружении разноцветной гальки

Простая, но аккуратная тропинка

Каменные плиты, выложенные между прекрасными клумбами

Даже простота может эффектно выглядеть

С крупных обломков можно скомбинировать не только аллею, но и ступеньки

Композиционные контрасты

То, на что способна ваша фантазия

Красивая лестница

Неповторимый образ

Уютный сад

Лаконичный ландшафтный дизайн

Сказочная композиция

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

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

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

Элегантное украшение

Интригующие композиции из разных материалов

Извилистая тропинка

Уникальный авторский букет

Аллея для современного сада с минималистичным дизайном

Оригинальные декорации

Дорога в сказку

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

Очаровательная дорога сквозь ухоженный газон

Извивающаяся бетонная тропа в окружении разноцветных клумб

Скромный дизайн

Кому-то кирпич может показаться не совсем актуальным материалом, но если правильно сформулировать образ, выбрать нестандартные узоры, то вы получите замечательный декор. Причём можно скомбинировать его с другими фактурами, что бы получился броский контраст.

Замысловатый мотив

Стильная аллея

Удобный путь сквозь роскошную галерею

Простые, но эффектные решения

Брусчатка, сформированная в стильный образ

Дорога, вдоль которой ваша прогулка будет незабываемой

Интересный способ кладки

Шикарный ландшафтный дизайн

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

Игривая комбинация

Достойное украшение

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

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

Аллея между прекрасными клумбами

Впечатляющая композиция в оригинальном обрамлении

Асфальтированные дорожки

Добавление интереса с помощью увлекательных деталей

Великолепные ступени

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

Необычная, но красивая дорожка из деревянных колод, закопанных в землю

Креативный подход к обустройству тропинки

Даже простые поддоны будут выполнять самую простую задачу

Уникальный узор, материал для которого можно найти среди нашего мусора

Проход между клумбами

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

Шикарное рукотворное озеро

Экзотическая терраса

Роскошный ландшафтный дизайн

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

Заманчивый вариант для оформления дорожки

Современный дизайн террасы

Чудная тропинка

Волшебная дорога

Внесите разнообразие красок

Визуальная привлекательность каждой детали

Великолепный ландшафт с превосходными декорациями

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

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

ёQˠ— достаточно добавить выше предложенные дополнения, и вы окажитесь мысленно на юге Франции.

Определение пути по Merriam-Webster

\ дорожка

, дорожка \

множественные пути \
ˈPat͟hz
, ˈPaths, ˈpät͟hz, päths

\

1

: проторенный путь

извилистая тропа через лес

2

: трек, специально созданный для конкретного использования.

садовая дорожка из каменных плит

б

: образ жизни, поведения или мысли

определилась с карьерой в медицине

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

б

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

1

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

натур путь

2

а

: страдающий расстройством (такой части или системы)

психо путь

б

: воспринимающий

теле путь

путей — SVG 2

путей — SVG 2

Содержание

    1. 9.1. Введение
    2. 9.2. Элемент «путь»
    3. 9.3. Данные пути
      1. 9.3.1. Общая информация о данных пути
      2. 9.3.2. Указание данных пути: свойство «d»
      3. 9.3.3. «moveto» команд
      4. 9.3.4. Команда «closepath»
        1. 9.3.4.1. Завершающая сегмент операция закрытия пути
      5. 9.3.5. Команды «lineto»
      6. 9.3.6. Кубическая кривая Безье дает команду
      7. 9.3.7. Квадратичная кривая Безье дает команду
      8. 9.3.8. Команды эллиптической дуги
      9. 9.3.9. Грамматика данных пути
    4. 9.4. Направленность трассы
    5. 9.5. Примечания по реализации
      1. 9.5.1. Параметры эллиптической дуги вне допустимого диапазона
      2. 9.5.2. Отраженные контрольные точки
      3. 9.5.3. Сегменты пути нулевой длины
      4. 9.5.4. Обработка ошибок в данных пути
    6. 9.6. Расстояние по трассе
      1. 9.6.1. Атрибут pathLength
    7. 9.7. Интерфейсы DOM
      1. 9.7.1. Интерфейс SVGPathElement

9.1. Введение

Путь представляет собой контур фигуры, который можно заливать или
погладил. Путь также можно использовать в качестве обтравочного контура для описания
анимация или позиционирование текста. Путь может использоваться более чем для одного из
эти функции одновременно. (Видеть
Серверы заливки, обводки и покраски,
Обрезка и маскирование,
Анимация (‘animateMotion’),
и текст по контуру.)

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

Пути представляют собой геометрию контура объекта,
определяется в терминах перейти к (установить новую текущую точку),
От до (начертить прямую), от до (начертить
кривая с использованием кубической кривой Безье), arc (эллиптическая
или дуги окружности) и closepath (замкнуть текущую
shape, подключившись к последним командам moveto ).Составные пути (т. Е. Путь с несколькими подпутьями) являются
можно разрешить такие эффекты, как «дырки от бублика» в объектах.

В этой главе описываются синтаксис, поведение и DOM.
интерфейсы для путей SVG. Различные примечания по реализации для SVG
пути можно найти в реализации элемента «path»
Примечания.

Путь определяется в SVG с помощью элемента «path».

Все основные формы описаны с точки зрения их
эквивалентный путь — это
какова их форма как тропинка.(Эквивалентный путь
Элемент «path» — это просто сам путь.)
Чтобы определить основные формы как эквивалентные пути,
определена завершающая сегмент операция замыкания пути,
который в настоящее время не может быть представлен в синтаксисе основного пути.

9.2. Элемент «путь»

path

Категории:
Графический элемент, визуализируемый элемент, элемент формы
Модель содержимого:
Любое количество следующих элементов в любом порядке: clipPath, маркер, маска, скрипт, стиль
Атрибуты:
  • атрибуты aria — ‘aria-activedescendant’, ‘aria-atomic’, ‘aria-autocomplete’, ‘aria-busy’, ‘aria-checked’, ‘aria-colcount’, ‘aria-colindex’ , ‘aria-colspan’, ‘aria-controls’, ‘aria-current’, ‘aria -hibitedby’, ‘aria-details’, ‘aria-disabled’, ‘aria-dropeffect’, ‘aria-errormessage’, ‘ aria-extended, aria-flowto, aria-grabbed, aria-haspopup, aria-hidden, aria-invalid, aria-keyshortcuts, aria-label, aria- labelledby ‘,’ aria-level ‘,’ aria-live ‘,’ aria-modal ‘,’ aria-multiline ‘,’ aria-multiselectable ‘,’ aria-Ориентация ‘,’ aria-owns ‘,’ aria-placeholder ‘ , ‘aria-posinset’, ‘aria-press’, ‘aria-readonly’, ‘aria-related’, ‘aria-required’, ‘aria-roledescription’, ‘aria-rowcount’, ‘aria-rowindex’, ‘aria-rowspan’, ‘aria-selected’, ‘aria-setsize’, ‘aria-sort’, ‘aria-valuemax’, ‘aria-valuemin’, ‘aria-valuenow’, ‘aria -valuetext ‘,’ role ‘
  • атрибутов условной обработки -‘ requiredExtensions ‘,’ systemLanguage ‘
  • основных атрибутов -‘ id ‘,’ tabindex ‘,’ lang ‘,’ xml: space ‘,’ class ‘,’ style ‘
  • глобальные атрибуты событий — oncancel, oncanplay, oncanplaythrough, onchange, onclick, onclose, oncuechange, ondblclick, ondrag, ondragend, ondragenter, ondragexit, ondragleave, ondragover, ondragstart, ondrop, ondurationchange, onemptied, onended, onerror, onfocus, oninput, oninvalid, onkeydown ‘,’ onkeypress ‘,’ onkeyup ‘,’ onload ‘,’ onloadeddata ‘,’ onloadedmetadata ‘,’ onloadstart ‘,’ onmousedown ‘,’ onmouseenter ‘,’ onmouseleave ‘,’ onmousemove ‘,’ onmouseout ‘,’ onmouseover ‘, onmouseup, onmousewheel, onpause, onplay, onplaying, onprogress, onratechange, onreset, onresize, onscroll, onseeke d ‘,’ onseeking ‘,’ onselect ‘,’ onshow ‘,’ onstalled ‘,’ onsubmit ‘,’ onsuspend ‘,’ ontimeupdate ‘,’ onggle ‘,’ onvolumechange ‘,’ onwaiting ‘
  • атрибуты событий элемента документа -‘ oncopy ‘,’ oncut ‘,’ onpaste ‘
  • графические атрибуты событий -‘ onfocusin ‘,’ onfocusout ‘
  • атрибуты презентации —
  • ‘ pathLength ‘
Свойства геометрии:
Интерфейсы DOM:

Контур формы для элемента «путь» задается с помощью d
свойство.См. Данные о пути ниже.

9,3. Данные пути

9.3.1. Общая информация о данных пути

Путь определяется включением «пути»
элемент, для которого свойство d указывает
данные пути. Данные пути содержат
перейти на , линейно на , кривая на (как кубическая, так и
квадратичный Безье), arc и closepath
инструкции.

Пример треугольника01
указывает путь в форме треугольника. (В
M указывает переход с на ,
L с означает линий до с, а
z обозначает ближний путь ().

 

   Пример треугольника01 - простой пример "пути" 
   Путь, изображающий треугольник 
  
  
 

Пример треугольника01

Просмотреть этот пример как SVG (только для браузеров с поддержкой SVG)

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

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

  • Все инструкции выражаются одним символом (например,
    moveto выражается как M ).
  • Избыточный пробел и разделители (например, запятые) могут
    быть устраненным; например, следующее содержит ненужные
    мест:

    M 100100 L 200200

    Более компактно это можно выразить как:

    M100 100L200 200

  • Буква команды может быть удалена, если идентичная команда
    в противном случае ему предшествовало бы письмо; например, следующие
    содержит ненужную вторую команду «L»:

    М 100200 л 200100 л -100-200

    Более компактно это можно выразить как:

    M 100200 L 200100-100-200

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

Синтаксис данных пути представляет собой префиксную нотацию (т. Е. Команды
за которыми следуют параметры).Единственная допустимая десятичная точка — это
Юникод
U + 0046 FULL STOP («.») Символ (также называемый в Юникоде как
PERIOD, точка и десятичная точка) и никаких других разделителей
разрешены символы [UNICODE].
(Например, следующее
недопустимое числовое значение в потоке данных пути: «13,000,56».
Вместо этого скажите: «13000,56».)

Для относительных версий команд все координаты
значения относятся к текущей точке в начале
команда.

В таблицах ниже используются следующие обозначения
описать синтаксис заданной команды пути:

  • (): группировка параметров
  • +: требуется 1 или несколько заданных параметров

В описании команд пути cpx и
cpy представляют координаты текущей точки.

9.3.2. Указание данных пути: свойство «d»

Имя: д
Значение: нет |
Начальный: нет
Применимо к: «путь»
Унаследовано:
В процентах: НЕТ
Медиа: визуал
Вычисленное значение: как указано
Анимация: да

Свойство d используется для определения формы элемента «путь».

Значение none указывает, что нет
данные пути для элемента. Для элементов «path» это означает, что
элемент не отображает и не влияет на ограничивающую рамку предка
элементы контейнера.

Путь состоит из нескольких сегментов, и каждая команда, либо явная
или неявно, кроме moveto или closepath,
определяет один сегмент пути .

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

Значение
задает форму, используя строку данных пути. Содержание
Значение должно соответствовать svg-path
Грамматика EBNF определена ниже, и ошибки в строке обрабатываются в соответствии с
правила в разделе Обработка ошибок данных пути.
Если строка данных пути не содержит допустимых команд, то поведение
то же самое, что и значение none.

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

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

Решено, что «d станет атрибутом презентации (без имени
изменить) со строкой данных пути в качестве значения «в
Лондон
Встреча редакторов.

В следующих разделах перечислены команды, которые можно использовать
в строках данных пути. Те, которые
рисовать отрезки прямых линий, включая команды lineto
( л , л ,
H , h , V и v )
и команды закрытия пути
( Z и z ). Эти три группы команд рисуют кривые:

  • Кубический
    Команды Безье ( C ,
    c , S и
    с ).Кубический отрезок Безье определяется
    по начальной, конечной и двум контрольным точкам.
  • Квадратичная
    Команды Безье ( Q ,
    q , T и
    т ). Квадратичный отрезок Безье — это
    определяется начальной точкой, конечной точкой и одним элементом управления
    точка.
  • Эллиптический
    команды arc ( A и a ).
    Сегмент эллиптической дуги рисует сегмент эллипса.

9.3.3.

«moveto» команд

Команды «moveto» ( M или
м ) необходимо установить новую начальную точку
и новая текущая точка.Эффект такой, как если бы «перо» подняли и переместили в
новое место. Сегмент данных пути (если он есть) должен начинаться с «moveto».
команда. Последующие команды «moveto» (т. Е. Когда «moveto»
не первая команда) представляют собой начало нового
подпуть :

Команда Имя Параметры Описание
M (абсолютное)
m (относительное)
moveto (x y) + Начните новый вложенный путь с заданными координатами (x, y). M (верхний регистр) указывает, что абсолютное
координаты последуют; м (строчные)
указывает, что последуют относительные координаты. Если moveto
за которыми следуют несколько пар координат, последующие пары
рассматриваются как неявные команды lineto. Следовательно, неявный lineto
команды будут относительными, если moveto является относительным, и
absolute, если moveto является абсолютным. Если относительный ход
( м ) появляется как первый элемент пути,
тогда он рассматривается как пара абсолютных координат.В этом
случае последующие пары координат рассматриваются как относительные
даже если начальное движение интерпретируется как абсолютное движение.

Когда используется относительная команда m ,
позиция перемещена в ( cpx + x ,
копий + y ).

9.3.4. Команда

«closepath»

«Ближний путь» ( Z или z )
завершает текущий подпуть, возвращая его в исходную точку.Автоматический
от текущей точки к начальной проводится прямая линия
текущего подпути. Этот сегмент пути может быть нулевым
длина.

Если за «closepath» сразу следует «moveto», то
«moveto» определяет начальную точку следующего подпути.
Если за «closepath» сразу следует любая другая команда, то
следующий подпуть начинается в той же начальной точке, что и текущий
подпуть.

Когда подпуть заканчивается «закрытым путем», он отличается по поведению.
из того, что происходит, когда «вручную» закрывает подпуть через
команда «lineto» в способе соединения «штрих-линия»
и «штрих-линейный колпачок».С «closepath» конец последнего сегмента
подпути «соединяется» с началом начального
сегмент подпути, использующий текущее значение «stroke-linejoin».
Если вместо этого вы «вручную» закроете подпуть через «lineto»
команда, начало первого сегмента и конец последнего
сегменты не соединяются, а вместо этого каждый закрывается с помощью
текущее значение «stroke-linecap».
В конце команды новая текущая точка устанавливается на
начальная точка текущего подпути.

Команда Имя Параметры Описание
Z или
z
ближний путь (нет) Закройте текущий подпуть, подключив его обратно к текущему
начальная точка подпути (см. выше). Поскольку
Z и z
Команды не принимают параметров, они имеют идентичный эффект.

Закрытый подпуть должен быть закрыт
команда «closepath», она «соединяет» первый и последний сегменты пути.Любой другой путь — это открытый подпуть .

Закрытый подпуть отличается по поведению
из открытого подпути, конечная координата которого является начальной точкой
подпути.
Первый и последний сегменты открытого подпути не будут
соединены, даже если конечной координатой последнего сегмента пути является
начальная точка подпути. Это приведет к первому и последнему
сегменты контура ограничиваются текущим значением stroke-linecap
вместо того, чтобы соединяться с использованием текущего значения stroke-linejoin.

Если за «closepath» сразу следует
«moveto», затем «moveto» определяет начальную точку
следующий подпуть. Если за «closepath» сразу следует любой
другая команда, то следующий подпуть должен начинаться с той же начальной точки
как текущий подпуть.

9.3.4.1. Завершающая сегмент операция закрытия пути

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

Завершение сегмента закрытие пути операция объединяет с предыдущей командой пути,
с двумя эффектами:

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

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

9.3.5.

«линето» команд

Различные команды «lineto» рисуют прямые линии от
от текущей точки к новой:

Команда Имя Параметры Описание
л (абсолютное)
л (относительное)
линето (x y) + Проведите линию от текущей точки до заданной (x, y)
координата, которая становится новой текущей точкой. L (верхний регистр) указывает, что абсолютное
координаты последуют; л (строчные буквы)
указывает, что последуют относительные координаты. Число
пары координат могут быть указаны для рисования ломаной линии.
В конце команды новая текущая точка устанавливается на
предоставленный окончательный набор координат.
H (абсолютное)
h (относительное)
горизонтальная линия х + Рисует горизонтальную линию от текущей точки. H (верхний регистр) указывает
что последуют абсолютные координаты; ч
(нижний регистр) указывает, что относительные координаты будут
следить. Может быть указано несколько значений x (хотя обычно
это не имеет смысла). Ан H или h
команда эквивалентна L или l
команда с 0 указанным для координаты y.
В конце команды новая текущая точка
берется из окончательного значения координаты.
V (абсолютное)
v (относительное)
вертикальная линия г + Рисует вертикальную линию от текущей точки.
В (верхний регистр) означает, что
последуют абсолютные координаты; v
(нижний регистр) указывает, что относительные координаты будут
следить. Может быть указано несколько значений y (хотя обычно
это не имеет смысла). A V или v
команда эквивалентна L или l
команда с 0 указанным для координаты x.В конце команды новая текущая точка
берется из окончательного значения координаты.

Когда используется относительная команда l ,
конечная точка линии ( cpx + x ,
копий + y ).

Когда используется относительная команда h ,
конечная точка линии ( cpx + x ,
копеек ). Это означает
что команда h с положительным значением x
value рисует горизонтальную линию в направлении положительной оси x.

Когда используется относительная команда v ,
конечная точка линии — ( cpx ,
копий + y ).

9.3.6. Кубическая кривая Безье командует

Кубические команды Безье следующие:

Команда Имя Параметры Описание
C (абсолютный)
c (относительный)
кривой до (x1 y1 x2 y2 x y) + Рисует кубическую кривую Безье по текущему
указать на (x, y), используя (x1, y1) в качестве контрольной точки в
начало кривой и (x2, y2) в качестве контрольной точки в
конец кривой. C (прописные)
указывает, что последуют абсолютные координаты;
c (нижний регистр) указывает, что относительный
координаты последуют. Несколько наборов координат могут
указать, чтобы нарисовать полибезье. В конце
команда, новая текущая точка становится последней (x, y)
пара координат, используемая в полибезье.
S (абсолютное)
s (относительное)
сокращение / плавная кривая до (x2 y2 x y) + Рисует кубическую кривую Безье по текущему
указать на (x, y).Предполагается, что первая контрольная точка
отражение второй контрольной точки на предыдущей
команду относительно текущей точки. (Если нет
предыдущая команда или если предыдущая команда не была C,
c, S или s, предположим, что первая контрольная точка совпадает
с текущей точкой.) (x2, y2) — второй элемент управления
точка (т. е. контрольная точка в конце кривой).
S (верхний регистр) указывает, что абсолютное
координаты последуют; с (строчные буквы)
указывает, что последуют относительные координаты.Несколько
наборы координат могут быть указаны для рисования
полибезье. В конце команды новый
текущая точка становится последней используемой парой координат (x, y)
в полибезье.

При родственнике с или с
используется команда, каждая из относительных пар координат
вычисляется так же, как в команде m .
Например, конечная контрольная точка кривой
обе команды: ( cpx + x ,
копий + y ).

Пример cubic01 показывает некоторые
простое использование кубических команд Безье в пути. В
пример использует внутреннюю таблицу стилей CSS для назначения стиля
характеристики. Обратите внимание, что контрольной точкой для команды «S» является
вычисляется автоматически как отражение контрольной точки
для предыдущей команды «C» относительно начальной точки
Команда «S».

 

   Пример cubic01 - кубические команды Безье в данных пути 
   Изображение, показывающее простой пример данных пути
        используя команды "C" и "S",
        вместе с аннотациями, показывающими контрольные точки
        и конечные точки 
  

  

  
  
  
  
  
  <круг cx = "100" cy = "200" r = "10" />
  <круг cx = "250" cy = "200" r = "10" />
  <круг cx = "400" cy = "200" r = "10" />
  <круг cx = "100" cy = "100" r = "10" />
  <круг cx = "250" cy = "100" r = "10" />
  <круг cx = "400" cy = "300" r = "10" />
  
   M100,200 C100,100 250,100 250,200 
   S400,300 400,200 
 

Пример cubic01

Просмотреть этот пример как SVG (только браузеры с поддержкой SVG)

На следующем рисунке показано, как кубический Безье
кривые меняют свою форму в зависимости от положения
контрольные точки.Первые пять примеров иллюстрируют один
кубический отрезок пути Безье. Пример внизу
справа показана команда «C», за которой следует команда «S».

Просмотр
этот пример как SVG (только браузеры с поддержкой SVG)

9.3.7. Квадратичная кривая Безье дает команду

Квадратичные команды Безье следующие:

Команда Имя Параметры Описание
Q (абсолютный)
q (относительный)
квадратичная кривая Безье до (x1 y1 x y) + Рисует квадратичную кривую Безье по текущему
укажите на (x, y), используя (x1, y1) в качестве контрольной точки. Q (верхний регистр) указывает, что абсолютное
координаты последуют; q (строчные буквы)
указывает, что последуют относительные координаты. Несколько
наборы координат могут быть указаны для рисования
полибезье. В конце команды новый
текущая точка становится последней используемой парой координат (x, y)
в полибезье.
T (абсолютное)
t (относительное)
Сокращение / гладкая квадратичная кривая Безье до (x y) + Рисует квадратичную кривую Безье по текущему
указать на (x, y).Предполагается, что контрольной точкой является
отражение контрольной точки на предыдущей команде
относительно текущей точки. (Если нет предыдущего
команда или если предыдущая команда не была Q, q, T или t,
предположим, что контрольная точка совпадает с текущей
точки.) T (верхний регистр) означает, что
последуют абсолютные координаты; т
(нижний регистр) указывает, что относительные координаты будут
следить. В конце команды новая текущая точка
становится последней парой координат (x, y), используемой в
полибезье.

Когда родственник q или t
используется команда, каждая из относительных пар координат
вычисляется так же, как в команде m .
Например, конечная контрольная точка кривой
обе команды: ( cpx + x ,
копий + y ).

Пример quad01 показывает некоторые
простое использование квадратичных команд Безье внутри контура.
Обратите внимание, что контрольная точка для команды «T» вычисляется
автоматически как отражение контрольной точки для
предыдущая команда «Q» относительно начальной точки «T»
команда.

 

   Пример quad01 - квадратичные команды Безье в данных пути 
   Изображение, показывающее команду "Q" и "T",
        вместе с аннотациями, показывающими контрольные точки
        и конечные точки 
  

  
  
  
    <круг cx = "200" cy = "300" r = "10" />
    
    <круг cx = "1000" cy = "300" r = "10" />
  
  
  
    
    
  
  
 

Пример quad01

Просмотрите этот пример как SVG (только для браузеров с поддержкой SVG)

9.3.8. Команды эллиптической кривой дуги

SVG 2 Требование: Упростите рисование дуг в синтаксисе пути SVG.
Разрешение: Упростите создание дуг в путях.
Назначение: Чтобы облегчить авторам запись данных пути с дугами вручную.
Владелец: Кэмерон (ACTION-3151)

Команды эллиптической дуги следующие:

Команда Имя Параметры Описание
A (абсолютное)
a (относительное)
эллиптическая дуга (rx ry x-axis-rotation big-arc-flag sweep-flag x
г) +
Рисует эллиптическую дугу от текущей точки до
( x , y ).Размер и
ориентация эллипса определяется двумя радиусами
( rx , и ) и
x-axis-rotation , который указывает, как
эллипс в целом поворачивается в градусах относительно текущего
система координат. Центр ( сх , г.
cy ) эллипса вычисляется
автоматически, чтобы удовлетворить ограничения, налагаемые
другие параметры. флаг с большой дугой и
флаг развертки вносит вклад в автоматический
расчеты и помогают определить, как нарисована дуга.

Когда используется относительная команда , конечная точка
дуги составляет ( cpx + x ,
копий + y ).

Пример arcs01 показывает некоторые
простое использование команд дуги внутри контура.

 

   Пример arcs01 - команды дуги в данных пути 
   Изображение круговой диаграммы с двумя секторами и
        изображение линии с метками по дуге 
  

  
  

  
 

Пример arcs01

Просмотреть этот пример как SVG (только браузеры с поддержкой SVG)

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

  • дуга начинается в текущей точке
  • дуга заканчивается в точке ( x ,
    л )
  • эллипс имеет два радиуса ( rx ,
    ры )
  • ось абсцисс эллипса поворачивается на
    x-axis-вращение градуса относительно x-оси
    текущая система координат.

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

  • Из четырех возможных вариантов развертки дуги два будут представлять собой
    размах дуги не менее 180 градусов (
    «большая дуга»), а два будут представлять длину дуги менее
    чем или равный 180 градусам («малая дуга»).Если
    large-arc-flag — 1, затем один из двух
    будут выбраны более крупные развертки дуги; в противном случае, если
    large-arc-flag — «0», один из меньших
    будут выбраны развертки дуги,
  • Если флаг развертки равен «1», то дуга будет
    быть нарисованным в направлении «положительного угла» (т. е. эллипс
    формула x = cx + rx * cos (тета)
    и y = cy + ry * sin (theta) равно
    оценивается так, что тета начинается под углом, соответствующим
    текущей точки и увеличивается положительно, пока дуга
    достигает (x, y)).Значение 0 заставляет дугу рисовать в
    направление «отрицательный угол» (т. е. тета начинается под углом
    значение, соответствующее текущей точке, и уменьшается до тех пор, пока
    дуга достигает (x, y)).

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


 

где «?,?» заменяется на «0,0» «0,1» «1,0» и «1,1» на
сгенерируйте четыре возможных случая.

Просмотр
этот пример как SVG (только браузеры с поддержкой SVG)

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

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

9.3.9. Грамматика для данных пути

Данные пути SVG соответствуют следующей грамматике EBNF.

svg_path :: = wsp * moveto? (перейти к drawto_command *)?

drawto_command :: =
    двигаться
    | близкий путь
    | Lineto
    | horizontal_lineto
    | vertical_lineto
    | кривая
    | smooth_curveto
    | quadratic_bezier_curveto
    | smooth_quadratic_bezier_curveto
    | эллиптическая_дуга

moveto :: =
    ("M" | "m") wsp * последовательность_координат

closepath :: =
    ("Z" | "z")

lineto :: =
    ("L" | "l") wsp * последовательность_координат

horizontal_lineto :: =
    ("H" | "h") wsp * последовательность_координат

vertical_lineto :: =
    ("V" | "v") wsp * последовательность_координат

curveto :: =
    ("C" | "c") wsp * curveto_coordinate_sequence

последовательность_координат_кривой :: =
    Coordin_pair_triplet
    | (тройка_координат запятая? последовательность_координат_координат)

smooth_curveto :: =
    ("S" | "s") wsp * smooth_curveto_coordinate_sequence

smooth_curveto_coordinate_sequence :: =
    Coordinate_pair_double
    | (Coordinate_pair_double comma_wsp? smooth_curveto_coordinate_sequence)

quadratic_bezier_curveto :: =
    ("Q" | "q") wsp * quadratic_bezier_curveto_coordinate_sequence

quadratic_bezier_curveto_coordinate_sequence :: =
    Coordinate_pair_double
    | (пара_координат, двойная запятая? wsp? quadratic_bezier_curveto_coordinate_sequence)

smooth_quadratic_bezier_curveto :: =
    ("T" | "t") wsp * последовательность_координат

эллиптическая_дуга :: =
    ("A" | "a") wsp * elliptical_arc_argument_sequence

elliptical_arc_argument_sequence :: =
    elliptical_arc_argument
    | (эллиптическая_дуга_аргумент запятая_всп? эллиптическая_дуга_аргумент_последовательность)

эллиптический_дуговой_аргумент :: =
    число comma_wsp? число comma_wsp? число comma_wsp
    флаг comma_wsp? флаг comma_wsp? Coordin_pair

двойной_координат :: =
    Coordin_pair comma_wsp? Coordin_pair

Coordin_pair_triplet :: =
    ordin_pair comma_wsp? Coordin_pair comma_wsp? Coordin_pair

последовательность_пар_координат :: =
    Coordin_pair | (пара_координат, запятая_wsp? последовательность_пар_координат)

последовательность_координат :: =
    координата | (координата запятая? последовательность_координат)

пара_координат :: = координата запятая_wsp? координировать

координата :: = знак? номер

знак :: = "+" | "-"
число :: = ([0-9]) +
flag :: = ("0" | "1")
comma_wsp :: = (wsp + ","? wsp *) | ("," wsp *)
wsp :: = (# x9 | # x20 | #xA | #xC | #xD)
 

Обработка EBNF должна потреблять как можно больше заданного
Производство EBNF по мере возможности, останавливаясь в момент, когда
встречается персонаж, который больше не удовлетворяет
производство.Таким образом, в строке «М 100-200» первая
координата для «moveto» потребляет символы «100» и
останавливается при встрече со знаком минус, потому что знак минус
не может следовать за цифрой при производстве «координаты». В
в результате первая координата будет «100», а
вторая координата будет «-200».

Аналогично для строки «M 0.6.5» первая координата
«moveto» потребляет символы «0,6» и останавливается на
встречает вторую десятичную точку, потому что производство
«координата» допускает только одну десятичную точку.Результат
что первая координата будет «0,6», а вторая
координата будет «.5».

Обратите внимание, что EBNF разрешает строку данных пути в
d должно быть пустым. Это не
ошибка, вместо этого он отключает отображение пути.
Отрисовка также отключается, когда свойство d
имеет значение none.

Если данные пути не соответствуют грамматике, значит, данные пути ошибочны.
(см. Обработка ошибок).

9,4. Направленность пути

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

Направление пути в указанном
расстояние по пути определяется следующим образом:

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

    Это будет «пройти мимо»
    сегменты нулевой длины и выберите более поздний сегмент, если расстояние
    находится на границе между двумя сегментами ненулевой длины.

  • В противном случае заданное расстояние по пути будет посередине.
    отрезка пути ненулевой длины. Направление — это просто направление
    кривой в этой точке. Если точка лежит на разрыве, например
    куспид в сегменте Безье, то направление не определено; в таком случае,
    направление между входящим и исходящим направлениями вокруг неоднородности
    должен быть использован.

Направление в начале
сегмента пути
определяется следующим образом:

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

Направление в конце пути
сегмент
определяется следующим образом:

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

9,5. Примечания по реализации

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

9.5.1. Параметры эллиптической дуги вне допустимого диапазона

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

  • Если конечная точка ( x , y ) сегмента
    совпадает с текущей точкой
    (е.g., конечная точка предыдущего отрезка),
    тогда это эквивалентно полностью исключению сегмента эллиптической дуги.

  • Если rx или ry равно 0,
    тогда эта дуга рассматривается как отрезок прямой
    («lineto»), соединяющий конечные точки.

  • Если rx или ry
    имеют отрицательные знаки, они опущены;
    вместо этого используется абсолютное значение.

  • Если rx , ry и Вращение по оси x
    таковы, что нет решения
    (в основном эллипс недостаточно большой, чтобы дотянуться до
    от текущей точки до новой конечной точки)
    затем эллипс увеличивается
    равномерно, пока не будет ровно одно решение (пока
    эллипс как раз достаточно большой).

    См. Раздел приложения
    Коррекция радиусов вне допустимого диапазона
    для математической формулы для этой операции масштабирования.

Это снисходительное, но последовательное обращение с выходом за пределы допустимого диапазона
values ​​гарантирует, что:

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

9.5.2. Отраженные контрольные точки

Команды S / s и T / t указывают, что первая контрольная точка
данный кубический сегмент Безье вычисляется по формуле
отражение последней контрольной точки предыдущего сегмента пути
относительно текущей точки. Точная математика выглядит как
следует.

Если текущая точка ( curx , cury ) и
конечная контрольная точка предыдущего отрезка пути —
( oldx2 , oldy2 ), затем отраженная точка (т.е.е., ( новыйx1 ,
newy1 ), первая контрольная точка текущего сегмента пути):

(newx1, newy1) = (curx - (oldx2 - curx), cury - (oldy2 - любопытный))
               = (2 * curx - старыйx2, 2 * cury - oldy2)
 

9.5.3. Сегменты пути нулевой длины

Сегменты пути с нулевой длиной недействительны,
и повлияет на рендеринг в следующих случаях:

  • Если маркеры указаны, то маркер рисуется на
    каждая применимая вершина, даже если данная вершина является
    конечная точка отрезка пути нулевой длины и даже если
    Команды moveto следуют друг за другом.
  • Как указано в Stroke Properties,
    заглушки должны быть окрашены для подпути нулевой длины, когда
    stroke-linecap имеет значение
    круглый или
    квадрат.

9.5.4. Обработка ошибок в данных пути

Нераспознанное содержимое в потоке данных пути (т. Е.
содержимое, которое не является частью грамматики данных пути) является
ошибка.
В таком случае необходимо использовать следующие правила обработки ошибок:

  • Общее правило обработки ошибок в данных пути:
    что пользовательский агент SVG должен отображать элемент «путь» вверх
    к (но не включая) команду пути, содержащую
    первая ошибка в спецификации данных пути.Это будет
    предоставить пользователю или разработчику визуальную подсказку о
    где ошибка может быть в спецификации данных пути.
    Это правило сильно препятствует созданию недействительных
    Данные пути SVG.
  • Если команда данных пути содержит неверный набор
    параметры, то отображается заданная команда данных пути
    до последнего правильно определенного сегмента пути включительно,
    даже если этот сегмент пути является подкомпонентом
    команда данных составного пути, такая как «lineto» с
    несколько пар координат.Например, для пути
    строка данных ‘M 10,10 L 20,20,30’,
    есть нечетное количество параметров для команды «L», которая требует четного
    количество параметров. Пользовательский агент требуется для рисования
    строка от (10,10) до (20,20), а затем выполнить ошибку
    отчет с ‘L 20 20’
    это последний правильно определенный сегмент спецификации данных пути.
  • По возможности, все пользовательские агенты SVG должны сообщать
    все ошибки пользователю.

9.6.Расстояние по тропе

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

Существует точная математика для вычисления расстояния вдоль пути,
но формулы очень сложные и требуют существенного
вычисление. Рекомендуется, чтобы продукты авторинга и пользователь
агенты используют алгоритмы, которые дают столь же точные результаты, как
возможно; однако, чтобы учесть различия в реализации
и помочь при расчетах расстояний получить результаты, которые
приблизительное намерение автора, можно использовать атрибут «pathLength»
предоставить авторский расчет общей длины
путь, чтобы пользовательский агент мог масштабировать расстояние вдоль пути
вычислений по отношению «pathLength» к собственному пользовательскому агенту
вычисленное значение для общей длины пути.

Операция «moveto» в элементе «path» определяется как
нулевая длина. Только различные «lineto», «curveto» и «arcto»
команды участвуют в расчетах длины пути.

9.6.1. Атрибут pathLength

Имя Значение Начальное значение Анимационный
длина пути <номер> (нет) да

Авторский расчет полной длины
путь в пользовательских единицах.Это значение используется для калибровки
собственное расстояние по пути пользовательского агента
расчеты с автором. Пользовательский агент будет
масштабировать все вычисления расстояния вдоль пути по соотношению
«pathLength» пользователю
собственное вычисленное значение общей длины пути агента. «PathLength» потенциально влияет
вычисления текста по пути,
анимация движения и
различные инсультные операции.

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

Отрицательное значение — ошибка (см. Обработка ошибок).

«pathLength» не влияет на процент
расчеты расстояния по траектории.

9,7. DOM интерфейсы

9.7.1. Интерфейс SVGPathElement

Объект SVGPathElement представляет «путь» в DOM.

 [Exposed = Window]
interface  SVGPathElement : SVGGeometryElement {
}; 

неофициальных пешеходных дорожек, которые расстраивают и очаровывают проектировщиков кампуса

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

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

Также известные как «коровьи тропы, пиратские тропы, социальные тропы, kemonomichi (звериные тропы), chemins de l’âne (ослиные тропы) и Olifantenpad (слоновьи тропы)», они являются живыми историями путешественников. бродить по тротуарам, создавать короткие пути, прокладывать собственные тропы и воссоздавать свои сообщества.Вы, наверное, видели их. Некоторые из них слегка отпечатаны на нетронутых лужайках, другие — глубоко в них. Они прорезают травянистые углы, образуют грязные тропы над холмами, топчут диагональные линии от точки A до точки B, а зимой — это шаги, вдавленные в снег.

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

Несколько тропинок желаний пересекают лужайку перед рынком на Гордон-авеню. Изображение любезно предоставлено пользователем Reddit almadison

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

«Мы пытаемся сделать это правильно с первого раза», — сказал Уильямс.«Существует прекрасный баланс между мощением всего кампуса и наличием зеленых насаждений».

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

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

Уильямс сказал, что люди создают пути желаний по трем основным причинам: эффективность использования времени, опыт и сопротивление, в том смысле, что зачем мне делать «X», если я могу делать «Y».

Большая дорога желаний, превращенная в гравий, соединяет два тротуара перед Грейнджер-холлом. Изображение предоставлено stan_x3

Во-первых, как в примере с Деджопом, студент, зачисленный в забитый, чувствительный ко времени график, может создать путь желаний, потому что он быстрее и эффективнее.Фотограф Ян Дирк Ван Дер Бург имеет большую коллекцию таких троп желаний, говоря, что «тротуары с великолепной укладкой, дорожные ограждения и идиллически организованные пешеходные зоны избегаются трезвым взглядом» и что «линии желаний являются осязаемым доказательством того, что люди не позволяют себе быть в смирительной рубашке в публичном пространстве и что у них есть только одна цель: найти кратчайший путь из пункта А в пункт Б. »

Дирк Хельбинг, немецкий профессор физики и математики, изучил trampelpfads — немецкое слово для обозначения путей желаний, которое объединяет слова «топчут» и «путь» — и обнаружил человеческую константу: путешественники образуют путь желаний, если предписано маршрут на 20–30 процентов длиннее.

«Они очень последовательны в этом, поскольку делают это на участках длиной всего десять метров (30 футов)», — сказал Хельбинг. «Это создает удивительные мини-ярлыки, которые вы можете увидеть в парках, где люди предпочитают пройти четыре шага по лугу, а не идти немного более длинным путем».

Рядом с региональным аэропортом округа Дейн тропа желаний проходит через лужайку. Изображение предоставлено jskoker

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

Многие дороги, по которым мы сегодня ездим на автомобилях, когда-то были старыми торговыми путями, ориентированными на самые быстрые межнациональные маршруты, добавил Хелбинг, а это значит, что даже в наших машинах мы следуем путями желаний других. Бродвей, следующий по «Тропе Виквасгека, созданной индейцами», которая, как считается, была кратчайшим путем между доколониальными поселениями на Манхэттене, избегая болот и холмов », считается старейшим путем желаний в США.С.

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

Путь желаний проходит параллельно железнодорожным путям в университетском городке UWs. Изображение любезно предоставлено пользователем Reddit StageCrewNinja

Этот тип пути желаний отражен в трудах Ребекки Солнит, чья книга «Страсть к путешествиям» документирует историю ходьбы и ее связь с культурой и политикой.Она пишет, что именно во время прогулки люди могут вырваться из «ряда интерьеров — дома, машины, спортзала, офиса, магазинов». И именно через пути желаний хождение как «способ создания мира, а также пребывания в нем» приобретает буквальное значение.

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

«Я способный, я могу добраться из пункта А в пункт Б, почему бы и нет?» — представил Уильямс такой тип мышления.

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

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

Например,

Bascom Hill мог быть пространством, испещренным тропами желаний, сказал Уильямс.

«Всякий раз, когда у вас есть большое открытое зеленое пространство, окруженное общественными зданиями [университетского городка], и вы прокладываете ортогональные пути — или пути под углом 90 градусов друг к другу — вы просите обрезать углы или образовывать диагонали», он сказал.

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

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

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

Но пути желаний — это не просто объекты развлечения; они также могут быть неуважительными и опасными.

Несколько тропинок, образованных наверху Observatory Drive, пересекают части существующих курганов. Исторически это был классический путь желаний, который в конечном итоге превратился в постоянный тротуар.По словам Уильямса, по большей части эти пути были удалены, но культурным ресурсам уже нанесен ущерб.

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

Уильямс сказал, что университет установил вдоль Университетской авеню «скобы» — металлические барьеры, которые слишком короткие, чтобы их можно было удобно расположить на корточках, и слишком высокие, чтобы их можно было легко преодолеть через Университетскую авеню, чтобы люди не могли их пересекать и повысить безопасность. У проектировщиков кампусов и ландшафтных архитекторов также есть долгосрочный план по обеспечению более безопасного альтернативного маршрута для людей, которые едут вдоль железнодорожных путей, которые пересекают прямую линию от Юнион-Юг до Юго-западного пригородного маршрута к Центру Коля.

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

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

Создать путь | NationBuilder HOWTOs

Содержание

Цели страны можно разбить на пути их достижения. Пути могут служить картой того, где сейчас находятся отношения. Это пошаговый рабочий процесс для завершения цепочки действий. Пути определяют причины для привлечения сторонников и создания согласованности и подотчетности в организации.
Пути отображаются в разделе People панели управления.

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

1. Определите цель — Включите в имя пути, например «Станьте донором». Завершите путь, когда цель достигнута.

2. Шаги — это рабочий процесс для завершения пути. Включите в название шага глагол, который поможет объяснить, когда человек переходит к этому шагу. Например, «Попросить залог» — это предписывающий шаг, в котором говорится, что пользователь панели управления должен попросить человека дать залог. Например, «Поручительство» — это шаг, на который приходит человек после того, как он предпринял действия. Используя глагол в прошедшем времени, шаг описывает состояние человека. Можно пропустить шаги.

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

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

5. Большинство путей имеют четкую конечную точку. Пути должны быть определены таким образом, чтобы ожидалось завершение. Может быть полезно создать несколько путей, которые не заканчиваются.Примером постоянного пути является «жизненный цикл донора».

Щелкните вкладку Люди . Вы увидите кнопку выбора пути , нажмите на нее.

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

1. Дайте новому пути имя . Например. Посещайте сбор средств.

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

3. Если вы хотите присвоить пути значение , вы можете установить флажок и ввести значение.

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

5. Щелкните Создать путь .

Теперь вам нужно добавить шаги (или элементы действия) к вашему пути.

1. Дайте каждому шагу имя .

2. Установите срок выполнения шага для — Если вы хотите, чтобы этот шаг был завершен в течение определенного периода времени, выберите один из раскрывающегося меню.

3. Назначьте шаг на — если вы хотите назначить ответственным за этот конкретный шаг человека, выберите этого человека в раскрывающемся меню.

4. Щелкните Создать шаг .

Шаги появятся внизу страницы. Чтобы изменить порядок шагов, вы можете щелкнуть и удерживать шаг, чтобы перетащить его на новое место. Чтобы отредактировать шаг, наведите на него курсор и нажмите Изменить .

Причины отказа (необязательно)

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

Причины завершения (необязательно)

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

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

Добавить к шагу пути при контакте с вещательной компанией

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

Добавление людей в путь можно настроить в подразделах «Электронная почта», «Телефон», «Текстовые сообщения», «Twitter» и «Facebook» в меню настроек вещательной компании. Например, когда вещательная компания получает входящую электронную почту и у вас есть путь электронной почты, вы переходите к Связь> [Имя вещательной компании]> Настройки> Электронная почта .

1. В нижней части экрана установите флажок рядом с «Добавить людей, отправляющих электронную почту на шаг пути» . Появятся дополнительные параметры.

2. Выберите путь , на котором должна быть размещена электронная почта.

3. Затем выберите шаг . Вы также можете назначить шаг пользователю панели управления и выбрать срок выполнения шага.

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

Добавить к этапу пути при выполнении действия на веб-сайте

Когда человек выполняет действие на вашем веб-сайте, его можно добавить в путь.

Чтобы добавить эту функцию, перейдите в раздел Website на панели управления.Выберите страницу действия (например, страницы петиции, пожертвования v2, подписки, волонтера, мероприятия, поддержки и опроса).

Перейдите к настройкам [тип страницы]> Основные сведения .

Найдите «Добавить в путь» . Установите флажок, чтобы просмотреть параметры пути. Обязательно нажмите кнопку Сохранить настройки , чтобы сохранить внесенные изменения.

Вы захотите узнать, как просматривать путь, а также как вручную перемещать людей по дорожкам.

Перемещение людей по путям вручную
Просмотр путей

Именование файлов, путей и пространств имен — приложения Win32

  • 14 минут на чтение

В этой статье

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

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

Некоторые файловые системы, такие как NTFS, поддерживают связанные файлы и каталоги, которые также следуют соглашениям и правилам именования файлов, как и обычный файл или каталог. Дополнительные сведения см. В разделах «Жесткие ссылки и переходы», «Точки повторной обработки» и «Операции с файлами».

Для получения дополнительной информации см. Следующие подразделы:

Чтобы узнать о настройке Windows 10 для поддержки длинных путей к файлам, см. Ограничение максимальной длины пути.

Имена файлов и каталогов

Все файловые системы следуют одним и тем же общим соглашениям об именах для отдельных файлов: базовое имя файла и дополнительное расширение, разделенные точкой.Однако каждая файловая система, такая как NTFS, CDFS, exFAT, UDFS, FAT и FAT32, может иметь особые и разные правила формирования отдельных компонентов на пути к каталогу или файлу. Обратите внимание, что каталог — это просто файл со специальным атрибутом, обозначающим его как каталог, но в остальном он должен следовать всем тем же правилам именования, что и обычный файл. Поскольку термин каталог просто относится к особому типу файла в том, что касается файловой системы, в некоторых справочных материалах будет использоваться общий термин файл для охвата концепции каталогов и файлов данных как таковых.По этой причине, если не указано иное, любые правила именования или использования или примеры для файла также должны применяться к каталогу. Термин путь обозначает один или несколько каталогов, обратную косую черту и, возможно, имя тома. Для получения дополнительной информации см. Раздел «Пути».

Ограничения на количество символов также могут быть разными и могут различаться в зависимости от файловой системы и используемого формата префикса имени пути. Это дополнительно осложняется поддержкой механизмов обратной совместимости. Например, более старая файловая система MS-DOS FAT поддерживает максимум 8 символов для основного имени файла и 3 символа для расширения, всего 12 символов, включая разделитель точек.Обычно это имя файла 8.3 . Файловые системы Windows FAT и NTFS не ограничиваются именами файлов формата 8.3, поскольку они имеют длинных имен файлов, поддерживают , но они по-прежнему поддерживают версию длинных файлов 8.3.

Соглашения об именах

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

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

  • Используйте обратную косую черту (\) для разделения компонентов пути . Обратная косая черта отделяет имя файла от пути к нему и одно имя каталога от имени другого каталога в пути. Вы не можете использовать обратную косую черту в имени фактического файла или каталога, потому что это зарезервированный символ, разделяющий имена на компоненты.

  • Используйте обратную косую черту как часть имен томов, например, «C: \» в «C: \ path \ file» или «\\ server \ share» в «\\ server \ share \ path \ file «для имен UNC.Дополнительные сведения об именах UNC см. В разделе «Ограничение максимальной длины пути».

  • Не учитывайте регистр. Например, считайте имена OSCAR, Oscar и oscar одинаковыми, даже если некоторые файловые системы (например, файловая система, совместимая с POSIX) могут рассматривать их как разные. Обратите внимание, что NTFS поддерживает семантику POSIX для чувствительности к регистру, но это не поведение по умолчанию. Для получения дополнительной информации см. CreateFile .

  • Обозначения томов (буквы дисков) также нечувствительны к регистру.Например, «D: \» и «d: \» относятся к одному и тому же тому.

  • Используйте любой символ текущей кодовой страницы для имени, включая символы Unicode и символы из расширенного набора символов (128–255), за исключением следующего:

    • Следующие зарезервированные символы:

      • <(менее)
      • > (больше)
      • : (двоеточие)
      • «(двойная кавычка)
      • / (косая черта)
      • \ (обратная косая черта)
      • | (вертикальный стержень или труба)
      • ? (вопросительный знак)
      • * (звездочка)
    • Целочисленное значение ноль, иногда называемое символом ASCII NUL .

    • Символы, целочисленные представления которых находятся в диапазоне от 1 до 31, за исключением альтернативных потоков данных, где эти символы разрешены. Дополнительные сведения о файловых потоках см. В разделе Файловые потоки.

    • Любой другой символ, запрещенный целевой файловой системой.

  • Используйте точку в качестве каталога , компонент в пути для представления текущего каталога, например «. \ Temp.txt». Для получения дополнительной информации см. Пути.

  • Используйте две последовательные точки (..) в качестве каталога , компонент в пути, представляющем родительский элемент текущего каталога, например «.. \ temp.txt». Для получения дополнительной информации см. Пути.

  • Не используйте следующие зарезервированные имена для имени файла:

    CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, ​​COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 и LPT9. Также избегайте этих имен, за которыми сразу следует расширение; например, NUL.txt не рекомендуется. Для получения дополнительной информации см. Пространства имен.

  • Не заканчивайте имя файла или каталога пробелом или точкой. Хотя базовая файловая система может поддерживать такие имена, оболочка Windows и пользовательский интерфейс — нет. Однако допустимо указывать точку в качестве первого символа имени. Например, «.temp».

Короткие и длинные имена

Длинным именем файла считается любое имя файла, которое превышает короткое имя MS-DOS (также называемое 8.3 ) соглашение об именах стилей. Когда вы создаете длинное имя файла, Windows может также создать короткую форму имени 8.3, названную псевдонимом 8.3 или кратким именем, и также сохранить ее на диске. Этот псевдоним 8.3 может быть отключен по соображениям производительности либо для всей системы, либо для определенного тома, в зависимости от конкретной файловой системы.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: псевдоним 8.3 нельзя отключить для указанных томов до Windows 7 и Windows Server 2008 R2.

Во многих файловых системах имя файла будет содержать тильду (~) в каждом компоненте имени, которое слишком длинное, чтобы соответствовать правилам именования 8.3.

Примечание

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

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

В более новых файловых системах, таких как NTFS, exFAT, UDFS и FAT32, Windows сохраняет длинные имена файлов на диске в Unicode, что означает, что исходное длинное имя файла всегда сохраняется.Это верно, даже если длинное имя файла содержит расширенные символы, независимо от кодовой страницы, которая активна во время операции чтения или записи на диск.

Файлы с длинными именами файлов можно копировать между разделами файловой системы NTFS и разделами файловой системы Windows FAT без потери информации об имени файла. Это может быть неверно для старых файловых систем MS-DOS FAT и некоторых типов файловых систем CDFS (CD-ROM), в зависимости от фактического имени файла. В этом случае, если возможно, подставляется короткое имя файла.

Пути

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

Если компонент пути является именем файла, он должен быть последним компонентом.

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

Полностью квалифицированные и относительные пути

Для функций Windows API, которые манипулируют файлами, имена файлов часто могут относиться к текущему каталогу, в то время как для некоторых API требуется полный путь. Имя файла указывается относительно текущего каталога, если оно не начинается с одного из следующих символов:

  • Имя UNC любого формата, которое всегда начинается с двух символов обратной косой черты («\\»). Для получения дополнительной информации см. Следующий раздел.
  • Обозначение диска с обратной косой чертой, например «C: \» или «d: \».
  • Одиночная обратная косая черта, например, «\ каталог» или «\ file.txt». Это также называется абсолютным путем .

Если имя файла начинается только с указателя диска, но не с обратной косой черты после двоеточия, оно интерпретируется как относительный путь к текущему каталогу на диске с указанной буквой. Обратите внимание, что текущий каталог может быть или не быть корневым, в зависимости от того, что он был установлен во время последней операции «изменения каталога» на этом диске.Примеры этого формата:

  • «C: tmp.txt» относится к файлу с именем «tmp.txt» в текущем каталоге на диске C.
  • «C: tempdir \ tmp.txt» относится к файлу в подкаталоге текущего каталога на диске C.

Путь также называется относительным, если он содержит «двойные точки»; то есть два периода вместе в одном компоненте пути. Этот специальный спецификатор используется для обозначения каталога над текущим каталогом, также известного как «родительский каталог».Примеры этого формата:

  • «.. \ tmp.txt» указывает файл с именем tmp.txt, расположенный в родительском каталоге текущего каталога.
  • «.. \ .. \ tmp.txt» определяет файл, который находится на два каталога выше текущего каталога.
  • «.. \ tempdir \ tmp.txt» указывает файл с именем tmp.txt, расположенный в каталоге с именем tempdir, который является одноранговым каталогом для текущего каталога.

Относительные пути могут сочетать оба типа примеров, например «C: .. \ tmp.txt».Это полезно, потому что, хотя система отслеживает текущий диск вместе с текущим каталогом этого диска, она также отслеживает текущие каталоги в каждой из разных букв дисков (если в вашей системе их больше одной), независимо от какое обозначение привода установлено в качестве текущего привода.

Ограничение максимальной длины пути

В выпусках Windows до Windows 10 версии 1607 максимальная длина пути составляет MAX_PATH , что составляет 260 символов.В более поздних версиях Windows для снятия ограничения требуется изменение раздела реестра или использование инструмента групповой политики. См. Полную информацию в разделе «Ограничение максимальной длины пути».

Пространства имен

Существует две основные категории соглашений о пространствах имен, используемых в API Windows, обычно называемых пространствами имен NT и пространствами имен Win32 . Пространство имен NT было разработано как пространство имен самого нижнего уровня, в котором могли существовать другие подсистемы и пространства имен, включая подсистему Win32 и, как следствие, пространства имен Win32.POSIX — еще один пример подсистемы в Windows, построенной на основе пространства имен NT. Ранние версии Windows также определяли несколько предопределенных или зарезервированных имен для определенных специальных устройств, таких как коммуникационные (последовательные и параллельные) порты и консоль дисплея по умолчанию, как часть того, что теперь называется пространством имен устройств NT, и все еще поддерживаются в текущих версиях. Windows для обратной совместимости.

Пространства имен файлов Win32

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

Для файлового ввода-вывода префикс «\\? \» В строке пути указывает API-интерфейсам Windows отключить весь синтаксический анализ строк и отправить строку, которая следует за ним, прямо в файловую систему.Например, если файловая система поддерживает большие пути и имена файлов, вы можете превысить ограничения MAX_PATH , которые в противном случае применяются API Windows. Дополнительные сведения о обычном ограничении максимального пути см. В предыдущем разделе «Ограничение максимальной длины пути».

Поскольку он отключает автоматическое раскрытие строки пути, префикс «\\? \» Также позволяет использовать «..» и «.» в именах путей, что может быть полезно, если вы пытаетесь выполнить операции с файлом с этими зарезервированными спецификаторами относительного пути как часть полного пути.

Многие, но не все API файлового ввода-вывода поддерживают «\\? \»; вы должны посмотреть справочную тему для каждого API, чтобы быть уверенным.

Обратите внимание, что API Unicode следует использовать, чтобы убедиться, что префикс «\\? \» Позволяет вам превышать MAX_PATH

Пространства имен устройств Win32

Префикс «\\. \» Будет обращаться к пространству имен устройства Win32, а не к пространству имен файлов Win32. Таким образом, доступ к физическим дискам и томам осуществляется напрямую, без прохождения через файловую систему, если API поддерживает этот тип доступа.Таким образом можно получить доступ ко многим устройствам, отличным от дисков (например, с помощью функций CreateFile и DefineDosDevice ).

Например, если вы хотите открыть системный последовательный коммуникационный порт 1, вы можете использовать «COM1» в вызове функции CreateFile . Это работает, потому что COM1 – COM9 являются частью зарезервированных имен в пространстве имен NT, хотя использование префикса «\\. \» Также будет работать с этими именами устройств. Для сравнения: если у вас установлена ​​плата расширения последовательного порта на 100 портов и вы хотите открыть COM56, вы не сможете открыть ее с помощью «COM56», потому что для COM56 нет предопределенного пространства имен NT.Вам нужно будет открыть его, используя «\\. \ COM56», потому что «\\. \» Переходит непосредственно в пространство имен устройства, не пытаясь найти предопределенный псевдоним.

Другой пример использования пространства имен устройства Win32 — использование функции CreateFile с «\\. \ PhysicalDisk X » (где X — допустимое целочисленное значение) или «\\. \ CdRom X ». Это позволяет вам получить доступ к этим устройствам напрямую, минуя файловую систему. Это работает, потому что эти имена устройств создаются системой по мере перечисления этих устройств, а некоторые драйверы также создают другие псевдонимы в системе.Например, драйвер устройства, реализующий имя «C: \», имеет собственное пространство имен, которое также является файловой системой.

API

, которые проходят через функцию CreateFile , обычно работают с префиксом «\\. \», Потому что CreateFile — это функция, используемая для открытия файлов и устройств, в зависимости от используемых вами параметров.

Если вы работаете с функциями Windows API, вы должны использовать префикс «\\. \» Для доступа только к устройствам, а не к файлам.

Большинство API не поддерживают «\\.\ «; его распознают только те, которые предназначены для работы с пространством имен устройства. Всегда проверяйте справочную тему для каждого API, чтобы быть уверенным.

Пространства имен NT

Существуют также API-интерфейсы, которые позволяют использовать соглашение о пространстве имен NT, но диспетчер объектов Windows делает это ненужным в большинстве случаев. Чтобы проиллюстрировать это, полезно просматривать пространства имен Windows в обозревателе системных объектов с помощью инструмента Windows Sysinternals WinObj. Когда вы запускаете этот инструмент, вы видите пространство имен NT, начинающееся с корня, или «\».Подпапка под названием «Global ??» это то место, где находится пространство имен Win32. Именованные объекты устройств находятся в пространстве имен NT в подкаталоге «Device». Здесь вы также можете найти Serial0 и Serial1, объекты устройства, представляющие первые два COM-порта, если они есть в вашей системе. Объект устройства, представляющий том, будет чем-то вроде «HarddiskVolume1», хотя числовой суффикс может отличаться. Имя «DR0» в подкаталоге «Harddisk0» является примером объекта устройства, представляющего диск, и так далее.

Чтобы сделать эти объекты устройств доступными для приложений Windows, драйверы устройств создают символическую ссылку (символическую ссылку) в пространстве имен Win32, «Global ??», на свои соответствующие объекты устройств. Например, COM0 и COM1 под заголовком «Global ??» подкаталог — это просто символические ссылки на Serial0 и Serial1, «C:» — это символическая ссылка на HarddiskVolume1, «Physicaldrive0» — это символическая ссылка на DR0 и так далее. Без символической ссылки указанное устройство «Xxx» не будет доступно для любого приложения Windows, использующего соглашения о пространстве имен Win32, как описано ранее.Однако дескриптор этого устройства может быть открыт с помощью любых API-интерфейсов, которые поддерживают абсолютный путь пространства имен NT в формате «\ Device \ Xxx».

С добавлением многопользовательской поддержки через службы терминалов и виртуальные машины возникла необходимость виртуализировать общесистемное корневое устройство в пространстве имен Win32. Это было достигнуто путем добавления символической ссылки «GLOBALROOT» в пространство имен Win32, которое вы можете увидеть в «Global ??» подкаталог инструмента браузера WinObj, о котором говорилось ранее, и доступ к нему можно получить по пути «\\? \ GLOBALROOT».Этот префикс гарантирует, что следующий за ним путь будет соответствовать истинному корневому пути диспетчера системных объектов, а не пути, зависящему от сеанса.

Сравнение функций файловой системы

path-help — Команда | Vault от HashiCorp

Search Vault документация

Команда path-help получает справку API для путей. Все конечные точки в Vault
предоставить встроенную справку в формате уценки.Сюда входят системные пути, секрет
двигатели и методы авторизации.

Справочная система — самый простой способ узнать, как использовать различные системы
в Vault, а также позволяет открывать новые пути.

Перед использованием path-help важно понимать «пути» в Vault.
Пути — это параметры, используемые для vault read , vault write и т. Д. Пример
путь — secret / foo или aws / config / root . Доступные пути зависят от
секреты используемых двигателей.По этой причине интерактивная справка является
незаменимый инструмент для определения поддерживаемых путей.

Чтобы узнать, какие пути поддерживаются, используйте vault path-help PATH . Например,
если вы включили механизм секретов AWS, вы можете использовать vault path-help aws , чтобы найти
пути, поддерживаемые этим сервером. Пути показаны обычными
выражения, которые могут затруднить их синтаксический анализ, но они также чрезвычайно
точный.

»Примеры

Получить вывод справки для механизма секретов KV:

 $ vault path-help secret
#

Бэкэнд KV читает и записывает произвольные секреты в бэкэнд.Секреты зашифрованы / расшифрованы Vault: они никогда не хранятся
незашифрованный в бэкэнде, и у бэкэнда никогда не будет возможности
увидеть незашифрованное значение.

Аренда может быть установлена ​​для каждого секрета. Эти договоры аренды будут отправлены
когда этот секрет прочитан, и предполагается, что какой-то внешний процесс
отозвать и / или заменить секрет на этом пути.

#

Этот бэкэнд поддерживает следующие пути. Для просмотра справки по
любой из путей ниже, используйте команду справки с любым сопоставлением маршрута
узор пути.. * $
        Сквозное секретное хранилище в серверную часть хранилища, что позволяет
        чтение / запись произвольных данных в секретное хранилище.
 
  $ путь к хранилищу-справка секрет #
Бэкэнд KV читает и записывает произвольные секреты в бэкэнд. Секреты шифруются / дешифруются Vault: они никогда не хранятся незашифрованными в бэкэнде, и бэкэнд никогда не имеет возможности увидеть незашифрованное значение.
Аренда может быть установлена ​​для каждого секрета. Эти аренды будут отправлены вниз, когда этот секрет будет прочитан, и предполагается, что какой-то внешний процесс аннулирует и / или заменит секрет на этом пути.. * $

Сквозное секретное хранилище в серверную часть хранилища, что позволяет
чтение / запись произвольных данных в секретное хранилище.

#

    аренда (строка)
        Время аренды этого ключа при чтении. Пример: 1 час

#

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

Аренда может быть указана при записи в поле «аренда». Если дано, то
когда секрет будет прочитан, Vault сообщит об аренде с этой продолжительностью. Это
ожидается, что потребитель этого бэкэнда правильно запишет обновленные ключи
до истечения срока аренды.. * $
Сквозное секретное хранилище на серверную часть хранилища, позволяющее читать / записывать произвольные данные в секретное хранилище.
#
    lease (строка) Время аренды этого ключа при чтении. Пример: 1 час
#
Сквозной бэкэнд считывает и записывает произвольные данные в секретное хранилище, попутно шифруя их.
Аренда может быть указана при записи в поле «аренда». Если указано, то при чтении секрета Vault сообщит об аренде с этой продолжительностью. Ожидается, что потребитель этого бэкэнда правильно запишет обновленные ключи до истечения срока аренды.Кроме того, отзыв должен обрабатываться пользователем этого серверного интерфейса.  

»Использование

Нет флагов, кроме стандартного набора флагов
включен во все команды.

pathlib — Пути к объектно-ориентированной файловой системе — документация Python 3.9.6

Исходный код: Lib / pathlib.py


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

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

Чистые пути полезны в некоторых особых случаях; например:

  1. Если вы хотите управлять путями Windows на машине Unix (или наоборот).
    Вы не можете создать экземпляр WindowsPath при работе в Unix, но вы
    может создать экземпляр PureWindowsPath .

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

См. Также

PEP 428 : Модуль pathlib — пути объектно-ориентированной файловой системы.

См. Также

Для низкоуровневого управления путями на строках вы также можете использовать
os.path модуль.

Основное использование

Импорт основного класса:

 >>> from pathlib import Path
 

Список подкаталогов:

 >>> p = Путь ('.')
>>> [x вместо x в p.iterdir (), если x.is_dir ()]
[PosixPath ('. Hg'), PosixPath ('docs'), PosixPath ('dist'),
 PosixPath ('__ pycache__'), PosixPath ('сборка')]
 

Отображение исходных файлов Python в этом дереве каталогов:

 >>> список (p.glob ('** / *. Py'))
[PosixPath ('test_pathlib.py'), PosixPath ('setup.ру '),
 PosixPath ('pathlib.py'), PosixPath ('docs / conf.py'),
 PosixPath ('build / lib / pathlib.py')]
 

Навигация по дереву каталогов:

 >>> p = Путь ('/ etc')
>>> q = p / 'init.d' / 'перезагрузка'
>>> q
PosixPath ('/ etc / init.d / reboot')
>>> q.resolve ()
PosixPath ('/ etc / rc.d / init.d / halt')
 

Свойства пути запроса:

 >>> q.exists ()
Истинный
>>> q.is_dir ()
Ложь
 

Открытие файла:

 >>> с q.open () как f: f.readline ()
...
'#! / bin / bash \ n'
 

Чистые пути

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

класс pathlib. PurePath ( * сегменты пути )

Универсальный класс, представляющий тип пути системы (создание экземпляра
он создает либо PurePosixPath , либо PureWindowsPath ):

 >>> PurePath ('setup.py ') # Запуск на машине Unix
PurePosixPath ('setup.py')
 

Каждый элемент сегментов пути может быть либо строкой, представляющей
сегмент пути, объект, реализующий интерфейс os.PathLike
который возвращает строку или другой объект пути:

 >>> PurePath ('foo', 'некоторый / путь', 'бар')
PurePosixPath ('foo / some / path / bar')
>>> PurePath (Путь ('foo'), Путь ('bar'))
PurePosixPath ('foo / bar')
 

Если pathsegments пусто, предполагается текущий каталог:

 >>> PurePath ()
PurePosixPath ('.')
 

Когда даны несколько абсолютных путей, последний берется в качестве якоря.
(имитирует поведение os.path.join () ):

 >>> PurePath ('/ и т.д.', '/ usr', 'lib64')
PurePosixPath ('/ usr / lib64')
>>> PureWindowsPath ('c: / Windows', 'd: bar')
PureWindowsPath ('д: бар')
 

Однако в пути Windows изменение локального корня не отменяет
предыдущая настройка привода:

 >>> PureWindowsPath ('c: / Windows', '/ Program Files')
PureWindowsPath ('c: / Program Files')
 

Ложные косые черты и одиночные точки удаляются, а двойные точки ( '.. ' )
нет, так как это изменило бы смысл пути перед лицом
символические ссылки:

 >>> PurePath ('foo // bar')
PurePosixPath ('foo / bar')
>>> PurePath ('foo /./ bar')
PurePosixPath ('foo / bar')
>>> PurePath ('foo /../ bar')
PurePosixPath ('foo /../ bar')
 

(наивный подход сделает PurePosixPath ('foo /../ bar') эквивалентом
на PurePosixPath ('bar') , что неверно, если foo является символической ссылкой
в другой каталог)

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

Изменено в версии 3.6: Добавлена ​​поддержка интерфейса os.PathLike .

класс pathlib. PurePosixPath ( * сегменты пути )

Подкласс PurePath , этот вариант пути представляет не Windows
пути файловой системы:

 >>> PurePosixPath ('/ etc')
PurePosixPath ('/ и т. Д.')
 

сегментов пути задается аналогично PurePath .

класс pathlib. PureWindowsPath ( * сегменты пути )

Подкласс PurePath , этот вариант пути представляет Windows
пути файловой системы:

 >>> PureWindowsPath ('c: / Program Files /')
PureWindowsPath ('c: / Program Files')
 

сегментов пути задается аналогично PurePath .

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

Общая недвижимость

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

 >>> PurePosixPath ('foo') == PurePosixPath ('FOO')
Ложь
>>> PureWindowsPath ('foo') == PureWindowsPath ('FOO')
Истинный
>>> PureWindowsPath ('FOO') в {PureWindowsPath ('foo')}
Истинный
>>> PureWindowsPath ('C:') 

Пути разных вкусов сравниваются неравно и не могут быть заказаны:

 >>> PureWindowsPath ('foo') == PurePosixPath ('foo')
Ложь
>>> PureWindowsPath ('foo') ", строка 1, в 
TypeError: '<' не поддерживается между экземплярами 'PureWindowsPath' и 'PurePosixPath'
 

Операторы

Оператор косой черты помогает создавать дочерние пути, аналогично os.path.join () :

 >>> p = PurePath ('/ и т.д.')
>>> p
PurePosixPath ('/ и т. Д.')
>>> p / 'init.d' / 'apache2'
PurePosixPath ('/ etc / init.d / apache2')
>>> q = PurePath ('корзина')
>>> '/ usr' / q
PurePosixPath ('/ usr / bin')
 

Объект пути может использоваться в любом месте объекта, реализующего os.PathLike
принято:

 >>> импорт ОС
>>> p = PurePath ('/ и т.д.')
>>> os.fspath (p)
'/так далее'
 

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

 >>> p = PurePath ('/ и т.д.')
>>> str (p)
'/так далее'
>>> p = PureWindowsPath ('c: / Program Files')
>>> str (p)
'c: \\ Program Files'
 

Аналогично, вызов байтов в пути дает необработанный путь файловой системы как
объект bytes в кодировке os.fsencode () :

Примечание

Вызов байт рекомендуется только в Unix.Под Windows,
форма Unicode - это каноническое представление путей файловой системы.

Доступ к деталям

Для доступа к отдельным «частям» (компонентам) пути используйте следующие
недвижимость:

PurePath. детали

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

 >>> p = PurePath ('/ usr / bin / python3')
>>> части
('/', 'usr', 'bin', 'python3')

>>> p = PureWindowsPath ('c: / Program Files / PSF')
>>> стр.части
('c: \\', 'Программные файлы', 'PSF')
 

(обратите внимание, как диск и локальный корень перегруппированы в одну часть)

Методы и свойства

Чистые пути предоставляют следующие методы и свойства:

PurePath. привод

Строка, представляющая букву или имя диска, если есть:

 >>> PureWindowsPath ('c: / Program Files /'). Диск
'c:'
>>> PureWindowsPath ('/ Программные файлы /').привод
''
>>> PurePosixPath ('/ etc'). Диск
''
 

акций UNC также считаются дисками:

 >>> PureWindowsPath ('// host / share / foo.txt'). Диск
'\\\\ host \\ share'
 
PurePath. корень

Строка, представляющая (локальный или глобальный) корень, если есть:

 >>> PureWindowsPath ('c: / Program Files /'). Корень
'\\'
>>> PureWindowsPath ('c: Program Files /'). Root
''
>>> PurePosixPath ('/ etc').корень
'/'
 

общих ресурсов UNC всегда имеют корень:

 >>> PureWindowsPath ('// хост / общий ресурс'). Root
'\\'
 
PurePath. якорь

Объединение диска и корня:

 >>> PureWindowsPath ('c: / Program Files /'). Привязка
'c: \\'
>>> PureWindowsPath ('c: Program Files /'). Привязка
'c:'
>>> PurePosixPath ('/ etc'). Привязка
'/'
>>> PureWindowsPath ('// хост / общий ресурс'). Привязка
'\\\\ host \\ share \\'
 
PurePath. родители

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

 >>> p = PureWindowsPath ('c: /foo/bar/setup.py')
>>> p.parents [0]
PureWindowsPath ('c: / foo / bar')
>>> p.parents [1]
PureWindowsPath ('c: / foo')
>>> p.parents [2]
PureWindowsPath ('c: /')
 
PurePath. родитель

Логический родитель пути:

 >>> p = PurePosixPath ('/ a / b / c / d')
>>> стр.родитель
PurePosixPath ('/ a / b / c')
 

Вы не можете пройти мимо якоря или пустого пути:

 >>> p = PurePosixPath ('/')
>>> p.parent
PurePosixPath ('/')
>>> p = PurePosixPath ('.')
>>> p.parent
PurePosixPath ('.')
 

Примечание

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

 >>> p = PurePosixPath ('foo / ..')
>>> p.parent
PurePosixPath ('фу')
 

Если вы хотите пройти произвольный путь файловой системы вверх, это
рекомендуется сначала позвонить по пути .resolve () , чтобы разрешить
символические ссылки и удалите «..» компонентов.

PurePath. наименование

Строка, представляющая последний компонент пути, исключая диск и
корень, если есть:

 >>> PurePosixPath ('my / library / setup.py'). Имя
'setup.py'
 

Имена дисков UNC не рассматриваются:

 >>> PureWindowsPath ('// some / share / setup.py'). Имя
'setup.py'
>>> PureWindowsPath ('// некоторые / поделиться').название
''
 
PurePath. суффикс

Расширение файла последнего компонента, если есть:

 >>> PurePosixPath ('my / library / setup.py'). Суффикс
'.py'
>>> PurePosixPath ('my / library.tar.gz'). Суффикс
'.gz'
>>> PurePosixPath ('моя / библиотека'). Суффикс
''
 
PurePath. суффиксы

Список расширений файлов пути:

 >>> PurePosixPath ('my / library.tar.gar '). суффиксы
['.tar', '.gar']
>>> PurePosixPath ('my / library.tar.gz'). Суффиксы
['.tar', '.gz']
>>> PurePosixPath ('моя / библиотека'). Суффиксы
[]
 
PurePath. шток

Последний компонент пути без суффикса:

 >>> PurePosixPath ('my / library.tar.gz'). Основа
'library.tar'
>>> PurePosixPath ('my / library.tar'). Основа
'библиотека'
>>> PurePosixPath ('моя / библиотека'). Основа
'библиотека'
 
PurePath. as_posix ()

Вернуть строковое представление пути с косой чертой (/):

 >>> p = PureWindowsPath ('c: \\ windows')
>>> str (p)
'c: \\ windows'
>>> p.as_posix ()
'c: / windows'
 
PurePath. as_uri ()

Представляет путь как файл URI. ValueError возникает, если
путь не абсолютен.

 >>> p = PurePosixPath ('/ etc / passwd')
>>> стр.as_uri ()
'файл: /// и т.д. / пароль'
>>> p = PureWindowsPath ('c: / Windows')
>>> p.as_uri ()
'файл: /// c: / Windows'
 
PurePath. ис_абсолютное ()

Вернуть, является ли путь абсолютным или нет. Путь считается абсолютным
если у него есть и корень, и (если позволяет вкус) диск:

 >>> PurePosixPath ('/ a / b'). Is_absolute ()
Истинный
>>> PurePosixPath ('a / b'). Is_absolute ()
Ложь

>>> PureWindowsPath ('c: / a / b').is_absolute ()
Истинный
>>> PureWindowsPath ('/ a / b'). Is_absolute ()
Ложь
>>> PureWindowsPath ('c:'). Is_absolute ()
Ложь
>>> PureWindowsPath ('// некоторые / поделиться'). Is_absolute ()
Истинный
 
PurePath. is_relative_to ( * другое )

Вернуть, относится ли этот путь к другому пути .

 >>> p = PurePath ('/ etc / passwd')
>>> p.is_relative_to ('/ etc')
Истинный
>>> стр.is_relative_to ('/ usr')
Ложь
 
PurePath. is_reserved ()

С PureWindowsPath вернуть True , если путь учитывается
зарезервировано под Windows, Ложь в противном случае. С PurePosixPath ,
Ложь возвращается всегда.

 >>> PureWindowsPath ('нуль'). Is_reserved ()
Истинный
>>> PurePosixPath ('нуль'). Is_reserved ()
Ложь
 

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

PurePath. путь соединения ( * другое )

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

 >>> PurePosixPath ('/ etc'). Joinpath ('passwd')
PurePosixPath ('/ etc / passwd')
>>> PurePosixPath ('/ etc'). Joinpath (PurePosixPath ('passwd'))
PurePosixPath ('/ etc / passwd')
>>> PurePosixPath ('/ etc'). Joinpath ('init.d', 'apache2')
PurePosixPath ('/ etc / init.d / apache2 ')
>>> PureWindowsPath ('c:'). Joinpath ('/ Программные файлы')
PureWindowsPath ('c: / Program Files')
 
PurePath. соответствует ( шаблон )

Сопоставьте этот путь с предоставленным шаблоном стиля глобуса. Возврат Истина
если сопоставление прошло успешно, Ложь, иначе .

Если образец является относительным, путь может быть относительным или абсолютным,
и сопоставление выполняется справа:

 >>> PurePath ('a / b.py '). match (' *. py ')
Истинный
>>> PurePath ('/ a / b / c.py'). Match ('b / *. Py')
Истинный
>>> PurePath ('/ a / b / c.py'). Match ('a / *. Py')
Ложь
 

Если шаблон является абсолютным, путь должен быть абсолютным, и весь путь
должно соответствовать:

 >>> PurePath ('/ a.py'). Match ('/ *. Py')
Истинный
>>> PurePath ('a / b.py'). Match ('/ *. Py')
Ложь
 

Как и в других методах, чувствительность к регистру соответствует настройкам платформы по умолчанию:

 >>> PurePosixPath ('b.py'). Match ('*.PY ')
Ложь
>>> PureWindowsPath ('b.py'). Match ('*. PY')
Истинный
 
PurePath. relative_to ( * прочие )

Вычислить версию этого пути относительно пути, представленного
прочие . Если это невозможно, возникает ValueError:

.

 >>> p = PurePosixPath ('/ etc / passwd')
>>> p.relative_to ('/')
PurePosixPath ('etc / passwd')
>>> p.relative_to ('/ и т.д.')
PurePosixPath ('пароль')
>>> стр.относительное_то ('/ usr')
Отслеживание (последний вызов последний):
  Файл "", строка 1, в 
  Файл "pathlib.py", строка 694, в relative_to
    .format (str (собственное), str (отформатированное)))
ValueError: '/ etc / passwd' не находится в подпутье '/ usr' ИЛИ ​​один путь является относительным, а другой абсолютным.
 

ПРИМЕЧАНИЕ. Эта функция является частью PurePath и работает со строками. Он не проверяет и не обращается к базовой файловой структуре.

PurePath. with_name ( name )

Вернуть новый путь с измененным именем . Если исходный путь
не имеет имени, возникает ошибка ValueError:

 >>> p = PureWindowsPath ('c: /Downloads/pathlib.tar.gz')
>>> p.with_name ('setup.py')
PureWindowsPath ('c: /Downloads/setup.py')
>>> p = PureWindowsPath ('c: /')
>>> p.with_name ('setup.py')
Отслеживание (последний вызов последний):
  Файл "", строка 1, в 
  Файл "/ home / antoine / cpython / default / Lib / pathlib.py ", строка 751, в with_name
    Raise ValueError ("% r имеет пустое имя"% (self,))
ValueError: PureWindowsPath ('c: /') имеет пустое имя
 
PurePath. со стержнем ( стержень )

Вернуть новую траекторию с измененной штангой . Если исходный путь
не имеет имени, возникает ошибка ValueError:

 >>> p = PureWindowsPath ('c: /Downloads/draft.txt')
>>> p.with_stem ('окончательный')
PureWindowsPath ('c: / Downloads / final.текст')
>>> p = PureWindowsPath ('c: /Downloads/pathlib.tar.gz')
>>> p.with_stem ('библиотека')
PureWindowsPath ('c: /Downloads/lib.gz')
>>> p = PureWindowsPath ('c: /')
>>> p.with_stem ('')
Отслеживание (последний вызов последний):
  Файл "", строка 1, в 
  Файл "/home/antoine/cpython/default/Lib/pathlib.py", строка 861, в with_stem
    вернуть self.with_name (основа + self.suffix)
  Файл "/home/antoine/cpython/default/Lib/pathlib.py", строка 851, в with_name
    Raise ValueError ("% r имеет пустое имя"% (self,))
ValueError: PureWindowsPath ('c: /') имеет пустое имя
 
PurePath. с суффиксом (суффикс )

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

 >>> p = PureWindowsPath ('c: /Downloads/pathlib.tar.gz')
>>> p.with_suffix ('. bz2')
PureWindowsPath ('c: /Downloads/pathlib.tar.bz2')
>>> p = PureWindowsPath ('README')
>>> стр.with_suffix ('. txt')
PureWindowsPath ('README.txt')
>>> p = PureWindowsPath ('README.txt')
>>> p.with_suffix ('')
PureWindowsPath ('README')
 

Бетонные дорожки

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

класс pathlib. Путь ( * сегменты пути )

Подкласс PurePath , этот класс представляет конкретные пути
аромат пути системы (создание его экземпляра создает либо
PosixPath или WindowsPath ):

 >>> Путь ('setup.ру ')
PosixPath ('setup.py')
 

сегментов пути задается аналогично PurePath .

класс pathlib. PosixPath ( * сегменты пути )

Подкласс Path и PurePosixPath , этот класс
представляет конкретные пути файловой системы, отличной от Windows:

 >>> PosixPath ('/ etc')
PosixPath ('/ и т. Д.')
 

сегментов пути задается аналогично PurePath .

класс pathlib. WindowsPath ( * сегменты пути )

Подкласс Path и PureWindowsPath , этот класс
представляет конкретные пути файловой системы Windows:

 >>> WindowsPath ('c: / Program Files /')
WindowsPath ('c: / Program Files')
 

сегментов пути задается аналогично PurePath .

Вы можете создать только тот класс, который соответствует вашей системе.
(разрешение системных вызовов на несовместимых вариантах пути может привести к
ошибки или сбои в вашем приложении):

 >>> импорт ОС
>>> os.название
'posix'
>>> Путь ('setup.py')
PosixPath ('setup.py')
>>> PosixPath ('setup.py')
PosixPath ('setup.py')
>>> WindowsPath ('setup.py')
Отслеживание (последний вызов последний):
  Файл "", строка 1, в 
  Файл "pathlib.py", строка 798, в __new__
    % (cls .__ name__,))
NotImplementedError: не удается создать экземпляр WindowsPath в вашей системе
 

Методы

Бетонные пути предоставляют следующие методы в дополнение к чистым путям
методы. Многие из этих методов могут вызвать ошибку OSError , если система
вызов не выполняется (например, потому что путь не существует).

classmethod Путь. кд ()

Вернуть новый объект пути, представляющий текущий каталог (как возвращено
по os.getcwd () ):

 >>> Path.cwd ()
PosixPath ('/ главная / антуан / pathlib')
 
classmethod Путь. дом ()

Вернуть новый объект пути, представляющий домашний каталог пользователя (как
возвращено os.path.expanduser () с конструкцией ~ ):

 >>> Path.home ()
PosixPath ('/ главная / антуан')
 
Путь. стат ()

Вернуть объект os.stat_result , содержащий информацию об этом пути, например os.stat () .
Результат просматривается при каждом вызове этого метода.

 >>> p = Путь ('setup.py')
>>> p.stat (). st_size
956
>>> p.stat (). st_mtime
1327883547.852554
 
Путь. chmod (режим )

Измените режим файла и разрешения, например os.chmod () :

 >>> p = Путь ('setup.py')
>>> p.stat (). st_mode
33277
>>> p.chmod (0o444)
>>> p.stat (). st_mode
33060
 
Путь. существует ()

Указывает ли путь на существующий файл или каталог:

 >>> Путь ('.').существует()
Истинный
>>> Путь ('setup.py'). Exists ()
Истинный
>>> Путь ('/ etc'). Exists ()
Истинный
>>> Путь ('несуществующий файл'). Существует ()
Ложь
 

Примечание

Если путь указывает на символическую ссылку, exists () возвращает,
символическая ссылка указывает на существующий файл или каталог.

Путь. расширить пользователь ()

Вернуть новый путь с расширенными конструкциями ~ и ~ пользователь ,
как возвращено os.path.expanduser () :

 >>> p = PosixPath ('~ / movies / Monty Python')
>>> p.expanduser ()
PosixPath ('/ главная / Эрик / фильмы / Монти Пайтон')
 
Путь. шар ( узор )

Поместить данный относительный шаблон в каталог, представленный этим путем,
получение всех подходящих файлов (любого типа):

 >>> отсортировано (Путь ('.'). Glob ('*. Py'))
[PosixPath ('pathlib.py'), PosixPath ('setup.py '), PosixPath (' test_pathlib.py ')]
>>> отсортировано (Путь ('.'). glob ('* / *. py'))
[PosixPath ('docs / conf.py')]
 

Шаблон « ** » означает «этот каталог и все подкаталоги,
рекурсивно ». Другими словами, он разрешает рекурсивную подстановку:

 >>> отсортировано (Путь ('.'). Glob ('** / *. Py'))
[PosixPath ('build / lib / pathlib.py'),
 PosixPath ('docs / conf.py'),
 PosixPath ('pathlib.py'),
 PosixPath ('setup.py'),
 PosixPath ('test_pathlib.py')]
 

Примечание

Использование шаблона « ** » в больших деревьях каталогов может потребовать
чрезмерное количество времени.

Вызывает событие аудита pathlib.Path.glob с аргументами self , шаблон .

Путь. группа ()

Возвращает имя группы, владеющей файлом. KeyError поднят
если gid файла не найден в системной базе данных.

Путь. is_dir ()

Вернуть Истина , если путь указывает на каталог (или символическую ссылку
указывает на каталог), Ложь , если он указывает на другой тип файла.

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

Путь. is_file ()

Вернуть Истина , если путь указывает на обычный файл (или символическую ссылку
указывает на обычный файл), Ложь , если указывает на другой тип файла.

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

Путь. is_mount ()

Вернуть Истина , если путь является точкой подключения : точка в
файловая система, в которой смонтирована другая файловая система. В POSIX
функция проверяет, находится ли родительский элемент path , path / .. , на другом
устройство, чем путь , или путь / .. и путь указывают на одно и то же
i-node на том же устройстве - это должно определять точки монтирования для всех Unix
и варианты POSIX.Не реализовано в Windows.

Путь. is_symlink ()

Вернуть Истина , если путь указывает на символическую ссылку, Ложь в противном случае.

Ложь также возвращается, если путь не существует; другие ошибки (такие
как ошибки разрешений).

Путь. is_socket ()

Вернуть Истина , если путь указывает на сокет Unix (или символическую ссылку
указывает на сокет Unix), Ложь , если он указывает на другой тип файла.

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

Путь. is_fifo ()

Вернуть Истина , если путь указывает на FIFO (или символическую ссылку
указывает на FIFO), Ложь , если указывает на другой тип файла.

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

Путь. is_block_device ()

Вернуть Истина , если путь указывает на блочное устройство (или символическую ссылку
указывает на блочное устройство), Ложь , если он указывает на другой тип файла.

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

Путь. is_char_device ()

Вернуть Истина , если путь указывает на символьное устройство (или символическую ссылку
указывает на символьное устройство), Ложь , если указывает на другой тип файла.

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

Путь. iterdir ()

Когда путь указывает на каталог, вывести объекты пути каталога
содержание:

 >>> p = Путь ('документы')
>>> для ребенка в p.iterdir (): child
...
PosixPath ('документы / conf.py')
PosixPath ('документы / _templates')
PosixPath ('docs / make.летучая мышь')
PosixPath ('документы / index.rst')
PosixPath ('документы / _build')
PosixPath ('документы / _static')
PosixPath ('документы / Makefile')
 

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

Путь. lchmod (режим )

Как Путь.chmod () , но если путь указывает на символическую ссылку,
Меняется режим символьной ссылки, а не ее целевой.

Путь. lstat ()

Как Path.stat () , но, если путь указывает на символическую ссылку, вернуть
информация символической ссылки, а не ее цель.

Путь. mkdir ( mode = 0o777 , parent = False , exist_ok = False )

Создайте новый каталог по данному пути.Если задан режим , это
в сочетании со значением umask
процесса ' для определения режима файла
и флаги доступа. Если путь уже существует, FileExistsError
Поднялся.

Если родителей истинно, создаются все отсутствующие родители этого пути.
по мере необходимости; они создаются с разрешениями по умолчанию, не принимая
mode (имитирует команду POSIX mkdir -p ).

Если родителей ложно (по умолчанию), отсутствующий родитель вызывает
Ошибка FileNotFoundError .

Если exist_ok ложно (по умолчанию), FileExistsError является
возникает, если целевой каталог уже существует.

Если exist_ok истинно, FileExistsError исключения будут
игнорируется (то же поведение, что и команда POSIX mkdir -p ), но только если
последний компонент пути не является существующим файлом вне каталога.

Изменено в версии 3.5: добавлен параметр exist_ok .

Путь. открыть ( mode = 'r' , buffering = -1 , encoding = None , errors = None , newline = None )

Откройте файл, на который указывает путь, как встроенный open ()
функция делает:

 >>> p = Путь ('setup.py')
>>> с p.open () как f:
... f.readline ()
...
'#! / usr / bin / env python3 \ n'
 
Путь. собственник ()

Вернуть имя пользователя, владеющего файлом. KeyError поднят
если uid файла не найден в системной базе данных.

Путь. байтов чтения ()

Вернуть двоичное содержимое указанного файла в виде байтового объекта:

 >>> p = Путь ('my_binary_file')
>>> p.write_bytes (b'Содержимое двоичного файла ')
20
>>> p.read_bytes ()
b'Содержимое двоичного файла '
 
Путь. read_text (кодировка = нет , ошибок = нет )

Вернуть декодированное содержимое указанного файла в виде строки:

 >>> p = Путь ('my_text_file')
>>> стр.write_text ('Содержимое текстового файла')
18
>>> p.read_text ()
'Содержимое текстового файла'
 

Файл открывается, а затем закрывается. Необязательные параметры имеют одинаковые
означает как в open () .

Путь. ссылка для чтения ()

Вернуть путь, на который указывает символическая ссылка (как возвращено
os.readlink () ):

 >>> p = Путь ('mylink')
>>> p.symlink_to ('setup.py')
>>> стр.readlink ()
PosixPath ('setup.py')
 
Путь. переименовать ( цель )

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

 >>> p = Путь ('foo')
>>> стр.open ('w'). write ('какой-то текст')
9
>>> target = Путь ('полоса')
>>> p.rename (цель)
PosixPath ('бар')
>>> target.open (). читать ()
'какой-то текст'
 

Целевой путь может быть абсолютным или относительным. Относительные пути интерпретируются
относительно текущего рабочего каталога, , а не , каталог пути
объект.

Изменено в версии 3.8: Добавлено возвращаемое значение, вернуть новый экземпляр Path.

Путь. заменить ( цель )

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

Целевой путь может быть абсолютным или относительным. Относительные пути интерпретируются
относительно текущего рабочего каталога, , а не , каталог пути
объект.

Изменено в версии 3.8: Добавлено возвращаемое значение, вернуть новый экземпляр Path.

Путь. разрешить ( strict = False )

Сделайте путь абсолютным, разрешив все символические ссылки.Новый объект пути
возвращено:

 >>> p = Путь ()
>>> p
PosixPath ('.')
>>> p.resolve ()
PosixPath ('/ главная / антуан / pathlib')
 

Компоненты « .. » также удаляются (это единственный способ сделать это):

 >>> p = Путь ('docs /../ setup.py')
>>> p.resolve ()
PosixPath ('/ home / antoine / pathlib / setup.py')
 

Если путь не существует, а strict - True , FileNotFoundError
Поднялся.Если strict - False , путь разрешен насколько это возможно
и любой остаток добавляется без проверки, существует ли он. Если
бесконечный цикл встречается на пути разрешения, RuntimeError
Поднялся.

Новое в версии 3.6: аргумент strict (поведение до версии 3.6 строгое).

Путь. rglob (образец )

Это похоже на вызов Path.glob () с добавлением « ** / » перед
данный относительный образец :

 >>> отсортировано (Путь (). Rglob ("*. Py"))
[PosixPath ('build / lib / pathlib.py'),
 PosixPath ('docs / conf.py'),
 PosixPath ('pathlib.py'),
 PosixPath ('setup.py'),
 PosixPath ('test_pathlib.py')]
 

Вызывает событие аудита pathlib.Path.rglob с аргументами self , шаблон .

Путь. rmdir ()

Удалите этот каталог.Каталог должен быть пустым.

Путь. тот же файл ( другой_путь )

Вернуть, указывает ли этот путь на тот же файл, что и other_path , который
может быть либо объектом Path, либо строкой. Семантика похожа
по адресу os.path.samefile () и os.path.samestat () .

Ошибка OSError может быть вызвана, если какой-либо файл недоступен для некоторых
причина.

 >>> p = Путь ('спам')
>>> q = Путь ('яйца')
>>> стр.тот же файл (q)
Ложь
>>> p.samefile ('спам')
Истинный
 
Путь. symlink_to ( target , target_is_directory = False )

Сделайте этот путь символической ссылкой на target . Под Windows,
target_is_directory должно быть истинным (по умолчанию ложно ), если цель ссылки
это каталог. В POSIX значение target_is_directory игнорируется.

 >>> p = Путь ('mylink')
>>> стр.symlink_to ('setup.py')
>>> p.resolve ()
PosixPath ('/ home / antoine / pathlib / setup.py')
>>> p.stat (). st_size
956
>>> p.lstat (). st_size
8
 

Примечание

Порядок аргументов (ссылка, цель) обратный.
of os.symlink () ’s.

Путь. link_to ( цель )

Сделайте target жесткой ссылкой на этот путь.

Предупреждение

Эта функция не делает этот путь жесткой ссылкой на target , несмотря на то, что
значение функций и имен аргументов.Порядок аргументов
(target, link) - это обратное значение Path.symlink_to () , но соответствует
что из os.ссылка () .

Путь. сенсорный ( mode = 0o666 , exist_ok = True )

Создайте файл по указанному пути. Если задан режим , он объединяется
со значением процесса ' umask для определения режима файла и доступа
флаги. Если файл уже существует, функция завершится успешно, если exist_ok
истинно (и время его модификации обновлено до текущего времени),
в противном случае возникает ошибка FileExistsError .

Путь. отменить ссылку ( missing_ok = False )

Удалите этот файл или символическую ссылку. Если путь указывает на каталог,
используйте вместо него Path.rmdir () .

Если missing_ok - ложь (по умолчанию), FileNotFoundError -
поднимается, если путь не существует.

Если missing_ok истинно, FileNotFoundError исключения будут
игнорируется (такое же поведение, как у команды POSIX rm -f ).

Изменено в версии 3.8: Добавлен параметр missing_ok .

Путь. write_bytes ( данных )

Откройте указанный файл в байтовом режиме, запишите в него данных и закройте
файл:

 >>> p = Путь ('my_binary_file')
>>> p.write_bytes (b'Содержимое двоичного файла ')
20
>>> p.read_bytes ()
b'Содержимое двоичного файла '
 

Существующий файл с таким же именем перезаписывается.

Путь. write_text ( данные , кодировка = нет , ошибок = нет )

Откройте указанный файл в текстовом режиме, запишите в него данные и закройте
файл:

 >>> p = Путь ('my_text_file')
>>> p.write_text ('Содержимое текстового файла')
18
>>> p.read_text ()
'Содержимое текстового файла'
 

Существующий файл с таким же именем перезаписывается. Необязательные параметры
имеют то же значение, что и в open () .