Руководство по содержанию иероглифового питона (Python sebae) в неволе
Ареал обитания
Вид широко распространен по всей Африке к югу от пустыни Сахара.
Охранный статус
Популяция иероглифовых питонов имеет достаточную численность, но она неуклонно снижается. Эти крупные животные постепенно исчезают из-за негативного воздействия человека. Этих змей истребляют из-за красивой кожи, квоты на экспорт составили 9300 экз. только в 2002 году. При встрече с человеком иероглифовый питон чаще всего бывает немедленно убит для получения кожи и мяса, а иногда – просто потому, что это змея.
Описание
Иероглифовый питон имеет светло коричневый или серовато-коричневый окрас с поперечными пятнами и темными полосами на теле. На боках рисунок вкраплениями серый, коричневый и черный.
Иероглифовый питон – змея, способная достичь гигантских размеров и имеющая дурную репутацию. Это самый крупный из африканских душителей, зачастую ведущий себя более агрессивно, чем другие боиды.
Правда, рожденные в неволе малыши, как правило, приручаются и становятся адекватными домашними животными.
Избегайте крупных животных, пойманных в природе – скорее всего, они так и останутся нервными и агрессивными и никогда не станут ручными.
Правильно выращенный в неволе и регулярно приручаемый, иероглифовый питон может стать терпимым к различным манипуляциям и остается ручным впоследствии.
Первоначально животное, скорее всего, будет проявлять агрессию и кусаться из-за страха (используйте перчатки), но впоследствии сформируется доверие и агрессия прекратится. Однако при любом раскладе не следует забывать, что это очень мощный зверь, и обращаться с ним следует с соответствующими предосторожностями.
Размер и продолжительность жизни
Детеныши имеют размер 35-45см, самки – в среднем около 5м и более. Самцы обычно не превышают 3,5м в длину. Отдельные экземпляры этого вида могут достигать размера более 6м и весить более 90 кг.
Продолжительность жизни иероглифовых питонов в неволе может составлять 30 и более лет.
Морфы и цветовые вариации
Морфы иероглифового питона включают patternless, hypomelanistic и различные формы аберрантных раскрасок, генетически закрепленных и не закрепленных.
Содержание в неволе
Уровень сложности
Из-за больших размеров и явно выраженной тенденции к агрессивности, мы не рекомендуем иероглифового питона в качестве змеи для новичка. Мы считаем, что это животное больше подходит для опытных киперов, имеющих опыт обращения с крупными и иногда не предсказуемыми боидами.
К сожалению, низкая цена и доступность в продаже иероглифовых питонов часто приводит к неприятным последствиям как для новичка, так и для самого питона.
В хороших руках эта змея может стать спокойной и ручной, а приручение ее – вызовом и наградой для заводчика с достаточным опытом.
Но мы все еще рекомендуем для начала обратить внимание на змей с более покладистым характером.
Террариум
Устройство террариума может быть простым или сложным – как вам больше нравится. Однако помните, что чем больше элементов вы поместите туда – тем больше вещей вам придется регулярно мыть и дезинфицировать. Так же важно помнить, что иероглифовые питоны – очень сильные, мощные животные, поэтому крепкий, надежно закрывающийся террариум является ОБЯЗАТЕЛЬНЫМ!
Но, кроме террариума, есть много емкостей, которые хорошо зарекомендовали себя при содержании иероглифовых питонов: это пластиковые коробки для одежды (к примеру, Rubbermaid), специально выпускаемые садки для содержания рептилий (к примеру, Vision Herp).
Емкости из стекла также подходят для содержания иероглифовых питонов.
Для крупных животных необходимо предоставить настолько большой террариум, насколько это вообще возможно.
Помните, что вне зависимости от того, какого размера змея, в террариуме должен иметься перепад температур для осуществления ей терморегуляции. Места должно быть достаточно для того, чтобы между зоной прогрева и холодным углом питон мог выбрать себе нужную температуру. Об этом всегда следует помнить, планируя новый дом для большого иероглифового питона.
Субстраты
Есть несколько видов субстратов, которые хорошо себя зарекомендовали при содержании этого вида. Газеты являются наиболее дешевым и простым способом поддержания чистоты в террариуме, их легко сменить.
Мульчированные субстраты являются прекрасным способом поддерживать влажность, но помните, что избыточная влажность может быть так же (если не более) вредна для данного вида, как и недостаточная.
Никогда не используйте субстраты, содержащие кедр, это губительно для рептилий!
Температура
Иероглифовому питону необходимо обеспечить температуру в точке прогрева 31-33С и 26-27С фоновую. Фоновая температура не должна опускаться ниже 24С.
Жизненно необходимо точно знать температуры, при которых содержится ваша змея. Точно, знать, а не ДОГАДЫВАТЬСЯ! Лучшим способом для этого является использование цифровых термометров с зондом.
Приклеив термометр-стикер в холодном углу внутри террариума, и опустив зонд в зону прогрева, вы будете обладать нужной информацией о температурных условиях.
Есть несколько способов обеспечить обогрев в террариуме.
Греющие коврики, керамические греющие элементы, лампы накаливания – только некоторые из вариантов. При использовании греющих элементов и ламп накаливания нужно очень внимательно следить за уровнем влажности внутри террариума, особенно, если верх террариума является открытым – воздух станет сухим очень быстро.
Для контроля за уровнем температуры используйте термостаты.
Горячие камни не подходят для террариумов со змеями, т.к. часто сильно разогреваются на некоторых участках и могут серьезно обжечь животное.
Влажность
Иероглифовых питонов часто находят в болотистых районах и норах – местах с более высоким уровнем влажности, чем везде. Поэтому питону желательно поставить камеру влажности, которая не только обеспечит локально влажное место в террариуме, но также и может быть использовано в качестве второго убежища.
Сделать камеру влажности просто. Возьмите пластиковый контейнер с влажным сфагнумом (хорошо отжатым от лишней воды), и прорежьте в нем отверстие сверху или снизу и поставьте ее в террариум так, чтобы питону было удобно в нее залазить.
Для крупных иероглифовых питонов можно использовать коробки Rubbermaid, если в террариуме хватит места, чтобы ее поставить. Если нет, то есть другой способ повысить влажность, поместив смесь сфагнума и мульчи кипариса в теплом углу террариума, и периодически увлажняя ее.
Помните также, что теплый воздух содержит больше влаги, чем холодный.
Ваша цель – увлажнить террариум, но не сделать его мокрым. Содержание в сыром террариуме может привести к бактериальной и грибковой инфекции, что может быть смертельно опасным для животного.
Освещение
В дополнительном освещении для этого вида нет необходимости, но если вы будете его использовать, то необходимо соблюдать дневные циклы: 12 часов включено, 12 – выключено. Непрерывное яркое освещение приводит к стрессу для змей, особенно для сумеречных видов, таких, как этот.
Вода
У иероглифового питона всегда должен быть доступ к чистой воде. Размер поилки зависит от вашего желания. Если емкость с водой будет достаточно большой для, чтобы питон мог туда целиком залезть, то рано или поздно ваша змея будет пользоваться ей для купания.
Убедитесь, что емкость не слишком глубока для ювенильных животных – 5-10см или около того будет достаточно.
Змеи многих видов периодически испражняются в свои бассейны, поэтому будьте готовы к мытью/дезинфекции и смене воды. Удобно иметь несколько сменяемых емкостей для этих целей.
Аксессуары
Иероглифовые питоны имеют тенденцию к тревожности и, как следствие, агрессивности, поэтому им желательно обеспечить условия, в которых они будут чувствовать себя в безопасности.
Обустройство убежища (а может даже нескольких) поможет этому процессу. Сделайте два укрытия и поставьте их в разных концах террариума, чтобы животному не пришлось выбирать между безопасностью и терморегуляцией.
Глиняные и пластиковые цветочные горшки, покупные убежища для террариумных животных вполне подходят для этих целей.
Для крупных особей простым и доступным способом создать «укрытие» является драпировка одного угла террариума темной бумагой.
Только убедитесь, что метод, который вы выбрали, не мешает вашим манипуляциям с животным.
Кормление
Кормите свою змею еженедельно грызуном соответствующего размера. Новорожденные иероглифовые питоны начинают питаться со взрослых мышей или крысят-ползунков.
Питоны могут питаться крысами всю молодость: начиная с крысят-ползунков и увеличивая размер кормового объекта по мере роста змеи. С того момента, как змея достигнет размера 90см, она может съесть крысенка-подростка. С размера 1,2м иероглифовые питоны, как правило, могут справиться со взрослой крысой.
Не тревожьте змею по крайней мере день после того, как она пообедала, потому что это может привести к срыгиванию пищи.
Большинство иероглифовых питонов имеют потрясающий пищевой инстинкт, и обычно их очень легко перевести на размороженную или предубитую пищу. Никогда не оставляйте несъеденных грызунов в террариуме с любой змеей.
Кормите змей по крайней мере каждые 10 дней, особенно молодых иероглифовых питонов.
Несмотря на то, что ограничение пищи позволяет контролировать темпы роста змеи, не забывайте, что при слишком редком кормлении змея будет постоянно голодной, что может спровоцировать запуск пищевого поведения при контактировании с хозяином.
С другой стороны, слишком частое кормление 1-2 раза в неделю спровоцирует бурный рост животного. Поэтому следует хорошо подумать, какие темпы роста вам нужны.
При обращении с иероглифовыми питонами соблюдение правил безопасности при кормлении имеет решающее значение для кипера, т.к. иероглифовые питоны невероятно сильные змеи, и это сила, с которой приходится считаться. Никогда не берите змею после того, как подержали грызуна, иначе по ошибке вы можете быть принятым за пищу.
После того, как змея достигает размера около 2,0м, имеет смысл перейти на кормление мертвыми кормовыми объектами, помещенными в террариум, чтобы змея могла найти их. Возможно, это позволит несколько смягчить пищевой инстинкт.
Поддержание чистоты
Производите локальную уборку в террариуме у питона по мере необходимости. Старайтесь как можно скорее удалять кал, мочу или не съеденные кормовые объекты. Еженедельно необходимо чистить и дезинфицировать поилку.
Раз в месяц следует проводить генеральную уборку. Удалите все из террариума и промойте поверхности 5% раствором хлорного отбеливателя, затем дайте просохнуть.
Основная информация по размножению
Иероглифовые питоны достигают половой зрелости в возрасте от 18 месяцев (самцы) до 4 лет (самки). Самцы могут размножаться при достижении 1,8м в длину, самки – 2,8м и более.
Животные, допущенные к размножению, должны быть хорошо адаптировавшимися и находиться в отличном состоянии. Сезон размножения при содержании в неволе обычно проходит с ноября по март. Кормить в этот период животных не следует.
Половое поведение может быть спровоцировано снижением дневного фотопериода до 8-10 часов, снижением дневных температур ниже 27С, ночных – примерно до 21С. Самку подсаживают в террариум к самцу. Опрыскиванием животных также стимулирует к размножению.
Обычно через 14-20+ дней после овуляции самки уходят в линьку. Откладка яиц, как правило, происходит в интервале 30 дней после постовуляционной линьки.
Кладка иероглифовых питонов может быть свыше 80 яиц, при этом 20-40 считается нормой. При температуре инкубации 31-32С (оптимальная), змееныши вылупляются через 70-80 дней.
Заключение
Иероглифовые питоны долгое время имели плохую репутацию из-за крайней агрессивности пойманных в природе экземпляров, и даже отдельных особей, выведенных в неволе. Их размер и сила делают их потенциально опасными животными.
В то же время пытливая, даже кажущая интеллектуальной, натура иероглифового питона может сделать общение с ним настоящей наградой для кипера, сумевшего наладить отношения.
Перевод: Елена
Источник: http://www.newenglandreptile.com/CareAfRock.html
Питон иероглифовый | Мир Чудес
Питон иероглифовый (Python sebae) относится к самым удивительным рептилиям Африки. С длиной тела 6-8 м эта черно-бурая гигантская змея с красивым рисунком на спине является не только одной из самых крупных змей Африки, но и всего мира.
Питон иероглифовый — сгусток силы и специалист в голодании.Когда-то родиной питона иероглифового была вся Африка южнее Сахары; сегодня в своей первоначальной области распространения он стал редким животным. Самое главное для него — иметь доступ к источнику воды, поэтому он живет на берегах болот или медленно текущих рек.
ТЕРПЕЛИВЫЕ ОХОТНИКИ В ЗАСАДЕ
Как все змеи, питоны иероглифовые питаются только мясом, но в отличие от ядовитых змей они убивают свою добычу не ядом, а силой своих мускулов. В то время как молодые змеи добывают небольших грызунов, находящихся в гнездах птиц и млекопитающих, взрослые экземпляры могут одолеть и водоплавающих птиц, мелких антилоп, обезьян, бородавочников и других более крупных животных. Превосходные пловцы, они охотно заползают в воду и поджидают там в засаде неосторожную жертву. На поверхности видны только глаза и ноздри.
На суше активный преимущественно в сумерки питон применяет ту же тактику: не преследование, а выжидание в засаде и нападение из укрытия.
УТОМИТЕЛЬНОЕ ПОГЛОЩЕНИЕ ДОБЫЧИ
Чтобы проглотить животное, которое явно больше его ротового отверстия, питон иероглифовый должен широко раздвигать в стороны челюсти. Когда питон иероглифовый обвивает добычу, он дышит с помощью специального удлинения дыхательного горла, которое широко открывается в полости рта. После роскошной трапезы заметно увеличившаяся в середине туловища змея удаляется для переваривания пищи. До следующей удачной охоты может пройти много времени, но питоны иероглифовые невзыскательны: доказано, что они могут голодать 29 месяцев.
ОСМОТРИТЕЛЬНЫЕ МАТЕРИ
Как и все питоны, самки питонов иероглифовых откладывают яйца — до 100 штук в одной кладке. В это время мать не принимает никакой пищи и покидает яйца только для того, чтобы утолить жажду. Если становится слишком холодно, она может поднять вибрацией мускулов на несколько градусов температуру тела и согреть яйца. Когда приблизительно через 90 дней вылупляется потомство, мать покидает гнездо и старается восстановить свой прежний вес.
ВРАГИ И ОПАСНОСТИ
Несмотря на размеры, даже у взрослых особей имеются враги. Они могут стать жертвой, например, львов и леопардов.
Но самым страшным врагом для них является человек. Он потребляет в пищу их мясо, а кожа пользуется большим спросом на рынке. Из нее изготавливают одежду, обувь, сумки.
ИНТЕРЕСНЫЕ ФАКТЫ
КАКИМ ОБРАЗОМ ГИГАНТСКИЕ ЗМЕИ ОПРЕДЕЛЯЮТ МЕСТОНАХОЖДЕНИЕ СВОЕЙ ДОБЫЧИ?
Питоны иероглифовые определяют местонахождение своей добычи оптически и с помощью хорошо развитого обоняния. Кроме того, они располагают дополнительной возможностью: могут воспринимать инфракрасное, тепловое излучение, используя органы чувств, расположенные в губных пазухах (органы пазух). Через отверстие пазухи инфракрасное излучение попадает на хорошо снабжаемую кровью мембрану на дне пазухи. Там находятся рецепторы теплового излучения. Поскольку губные пазухи расположены по обеим сторонам пасти, питон в состоянии точно установить источники тепла, например теплокровную добычу в виде к млекопитающих и птиц, даже при плохой видимости или ночью на некотором удалении.
КРАТКАЯ ХАРАКТЕРИСТИКА
Питон иероглифовый (Python sebae)
- Класс рептилии.
- Отряд чешуйчатые рептилии.
- Семейство змеи гигантские.
- Распространение: Африка — южнее Сахары.
- Длина: 6-8 м.
- Питание:птицы, млекопитающие (например, антилопы, обезьяны).
- Количество яиц: до 100.
- Время вылупливания: через 90 дней.
Категория Статьи
Животные нашей Планеты
hieroglyph · PyPI
Hieroglyph — это расширение для Sphinx, которое строит HTML презентации из документов ReStructured Text.
Установка
Вы можете установить Hieroglyph , используя easy_install или pip:
$ пип установить иероглиф
Вы также можете установить последнюю разрабатываемую версию, которая может содержат новые функции:
$ pip установить git+https://github.com/nyergler/hieroglyph#egg=hieroglyph
Hieroglyph поддерживает Sphinx 2.4 и более поздние версии, а также Python 3.7 и более поздние версии.
Использование иероглифа
Вы можете начать новую презентацию Hieroglyph , используя прилагаемый скрипт быстрого запуска:
$ иероглиф-быстрый старт
Будет сгенерирована конфигурация Sphinx вместе с необязательным Makefile и пакетный файл с включенным Hieroglyph.
Если вы используете что-то похожее на UNIX (Linux, Mac OS X и т. д.), вы можете сгенерируйте свои слайды, запустив make:
$ сделать слайды
Вы также можете добавить Иероглиф в качестве расширения Sphinx для вашего существующая конфигурация:
расширений = [ 'иероглиф', ]
Прочтите документацию для получения подробной информации об использовании, настройка и расширение Hieroglyph.
Подключить
Вы можете связаться с другими пользователями Hieroglyph и разработчиками через список адресов электронной почты пользователей-иероглифов (группы Google). Архив Gmane так же доступно.
Проявка
Выпуск
Hieroglyph использует Versioneer для управления номерами версий. Версионер возможность получить разумный номер версии, используя теги git в качестве источника правда.
Чтобы создать выпуск, выполните следующие действия:
Обновление журнала изменений (NEWS.txt)
Пометить коммит релиза как hieroglyph-x.y.z
Сборка дистрибутивов с помощью setup.py :
$ python setup.py sdist bdist_wheel
Отправьте изменения на Github и загрузите в PyPI с помощью Twine:
$ git push origin head $ шпагат загрузки dist/<встроенные имена файлов>
Лицензия
Hieroglyph доступен по лицензии BSD; см.
Включены слайды CSS и JavaScript, изначально основанные на слайдах HTML 5. и проекты io-2012-slides под лицензией Apache Public Лицензия.
Новости
2.1
Дата выпуска: 4 июля 2020 г.
2,0
Дата выпуска: 27 июня 2020 г.
Отказ от поддержки Python 2.x
Опора для Sphinx < 2,0
Исправление совместимости со Sphinx 2 и 3
Включено параллельное чтение исходных файлов
1,0
Дата выпуска: 7 сентября 2017 г.
Добавить однофайловые слайды конструктор
Исправление совместимости со Sphinx >
Переход на семантическое управление версиями; бамп основной версии указывает назад несовместимые изменения (прекращение поддержки Sphinx 1.2, 1.3)
0.7.1
Дата выпуска: 28 марта 2015 г.
Добавить заголовок-изображение класс слайдов
Исправление ошибки: slides2 тема включает дополнительные слайды (#92)
Исправление ошибки: вызов точки входа зависит от новых инструментов настройки (#94)
Исправление ошибки: кавычки RST вызывают исключения (#93)
0,7
Дата выпуска: 16 марта 2015 г.
Темы теперь используют фрагмент шаблона для рендеринга отдельных слайдов. (Выпуск №49)
Исправление ошибки: файлы в html_static_dir теперь переопределяют файлы темы. (Выпуск №54)
Добавлен параметр конфигурации slide_title. (выпуск №56)
Добавлена тема slides2 на основе обновленного слайда Google HTML 5. шаблоны. (Выпуск №48)
Добавлены более гибкие дополнительные слайды с использованием классов build-item-*.
Документация по созданию темы (#53)
CSS слайда раздела обновлен для печати.
Обрабатывать заголовки со встроенной разметкой с директивой nextslide. (#85)
Улучшенный сценарий быстрого запуска
0,6,5
Дата выпуска: 1 марта 2014 г.
Вернуть «Загрузка Javascript теперь отложена до конца документ.» Это вызвало проблемы с содержимым в блоках ifnotslides. (выпуск №33)
Исправлена проблема с изменением пути для сгенерированных изображений (т.е. из блокдиаг).
Добавлена поддержка slide_footer (выпуск № 44)
Преобразованная обработка директивы состояния слайда для использования Docutils трансформируется. Это позволяет отображать заголовки разделов в таблицах содержание правильно. (Выпуск №25)
Добавлена директива nextslide для разделения разделов. (Выпуск №46)
Классы разделов теперь добавляются к сгенерированным слайдам (выпуск №50).
0,6
Дата выпуска: 8 августа 2013 г.
Директива примечания на слайде теперь отображается как примечания в консоль ведущего. Спасибо, Дуг Хеллманн!
Загрузка Javascript теперь откладывается до конца документа.
Разрешить проектам указывать пользовательский Javascript для включения в слайды.
slides.js теперь запускает событие при изменении размера слайдов.
Поддержка установки классов по умолчанию для слайдов в документе.
Добавлены классы слайдов появления и плавного появления для альтернативных переходы.
Добавлен скрипт быстрого запуска иероглифов.
Добавлена среда тестирования, начальные тесты для директив
Исправлена ошибка, из-за которой содержимое не удалялось с автослайдами. инвалид
Слайды, созданные с помощью директивы slide, могут не иметь только заголовка, или только контент (выпуск №30)
Нумерация слайдов часто была неправильной при работе с несколькими слайдами уровни; это было правильно (выпуск № 26)
Улучшена обработка разрывов страниц при печати слайдов (PR #31). Спасибо, тядеврис!
0,5,5
Дата выпуска: 19 марта 2013 г.
Переписана, обновлена и дополнена документация, включая дополнение руководства по началу работы.
В директиву слайда добавлена опция встроенного содержимого.
Исправлена ошибка расчета пути к изображению для документов во вложенных деревьях. В первую очередь это коснулось изображений, созданных другими расширениями, такими как как блокдиаг.
Добавлена поддержка пометки раздела как слайда при включении автослайдов. неполноценный.
Все узлы, связанные со слайдом, теперь остаются нетронутыми при обрезке дерева.
Исправлена ошибка, связанная со сменой тем между документами, что приводило к в Sphinx Report Template Not Found.
Расчет фиксированного уровня для слайдов, созданных с помощью слайда директива.
Упрощенная обработка узлов slideconf: ранее была попытка было сделано, чтобы удалить их, когда не строят слайды. Это было хрупко, и привело к поломке в сборщиках латекса и texinfo. Они сейчас правильно пропущен для всех встроенных сборщиков Sphinx.
Обновлен Javascript для дополнительных слайдов для работы с последними сборками из хрома
0,5
Дата выпуска: 24 декабря 2012 г.
Добавлена поддержка директивы слайда
Добавлен параметр конфигурации автослайдов, позволяющий отключить автоматическое генерация слайдов из текста документа.
Добавлен встроенный конструктор слайдов.
Директивы slides и notslides переименованы в ifslides и если не скользит, соответственно. Старые имена будут продолжать работать какое-то время переименование просто делает их более выразительными.
Изменена клавиша для переключения вида таблицы слайдов на t (было ESC).
Исправлены проблемы со стилем вложенных списков
Исправлена несовместимость с компоновщиком латекс-pdf
0,4
Дата выпуска: 27 сентября 2012 г.
Стиль печати для печати слайдов
Очистка/реорганизация шаблона и JavaScript
Более точное отображение масштабированных слайдов в таблице слайдов
Первоначальная реализация Presenter Console
Темы и документы включают файлы шрифтов локально
Изменены ключи конфигурации соединения для большей согласованности.
Поддержка конфигурации темы для конкретного файла
Подставка для нумерации слайдов
0.3.2
Дата выпуска: 5 июня 2012 г.
0.3.1
Дата выпуска: 5 июня 2012 г.
Добавлен контент, код отсутствует в версии 0.3.
Обновлен файл README с учетом изменений версии 0.3.
Изменена конфигурация документов для создания HTML + Slides.
0,3
Дата выпуска: 4 июня 2012 г.
Предоставление каталогов и автономных компоновщиков.
Добавлены директивы slides и notslides.
Исправление абсолютных путей к изображениям из таких вещей, как blockdiag
Предварительная поддержка связи между HTML и слайдами
Предварительная опора стола скольжения
Обратно несовместимые изменения:
0,2
Дата выпуска: 10 марта 2012 г.
Начало работы с Hieroglyph — документация Hieroglyph 2.0.0+10.g843ed95
Hieroglyph — это расширение для Sphinx, которое создает HTML-слайды из Реструктурированные текстовые документы. Hieroglyph позволяет использовать Sphinx и его большая коллекция расширений для создания богатых документов, которые доступны любому, у кого есть веб-браузер. Он также включает в себя инструменты которые помогут вам, как выступающему, поделиться своей презентацией.
Этот документ описывает создание презентации с помощью Hieroglyph и Сфинкс. Прочитав это, вы сможете использовать Hieroglyph для создавать слайды и быть готовым изучить дополнительные функции и расширения доступны через Sphinx.
Установка Hieroglyph и зависимостей
Для начала вам необходимо установить Hieroglyph и его зависимости. Hieroglyph написан на Python, так что если он у вас не установлен, вам нужно сначала установить его.
После установки Python вы можете установить Hieroglyph (вместе с необходимые ему зависимости с помощью easy_install или pip.
$ иероглиф easy_install
При установке Hieroglyph также будут установлены его зависимости, в том числе Sphinx и docutils, если необходимо.
Создать проект
После того, как вы установили Hieroglyph и Sphinx, вы можете создать новый проект. Проект Sphinx определяет, где искать исходные файлы. и какие расширения включить. Вы можете начать свой проект, используя hieroglyph-quickstart программа, входящая в состав Hieroglyph.
$ иероглиф-быстрый старт
hieroglyph-quickstart задаст вам вопросы о вашем презентационный проект. Не все из них имеют смысл, если вы просто создание презентации (в отличие от презентации и других документацию одновременно), поэтому обычно можно просто принять значения по умолчанию.
Примечание
Внимание, пользователи Mac
Пользователи Mac могут столкнуться с ошибкой, когда зависимость не найдена, например, с этой ошибкой ниже.
$ иероглиф-быстрый старт Traceback (последний последний вызов): Файл "/usr/local/bin/hieroglyph-quickstart", строка 5, виз pkg_resources импортировать load_entry_point : pkg_resources.DistributionNotFound: шесть
Это результат конфликта установленной версии Python с той, которую Apple предоставляет как часть Mac OS X. Это можно исправить, просто отредактировав первую строку только что установленного /usr/local/bin/ иероглиф-быстрый старт
. Измените его с #!/usr/bin/python
на #!/usr/bin/env python
.
Еще одна проблема, с которой вы можете столкнуться, заключается в том, что для оболочки Sphinx может потребоваться определенная версия, то есть все, что выглядит как «== 1. 1.2» в /usr/local/bin/sphinx-сборка
. Если у вас уже установлена другая версия Sphinx, то, скорее всего, она новее и сможет с ней справиться. IOW, просто удалите ссылки на «== 1.1.2» в этом файле, и он должен работать.
Добавление Hieroglyph к существующему проекту
Если у вас есть существующий проект Sphinx или вы использовали sphinx-quickstart вместо hieroglyph-quickstart , вам нужно включить иероглиф в
файл конфигурации conf.py
.
Откройте conf.py
и найдите extensions
определение:
extensions = [ ]
Ваше определение может содержать элементы в списке, если вы ответили «да» на
любой из вопросов Sphinx Quickstart. Нам нужно добавить иероглиф
в этот список:
расширений = ['иероглиф']
Активирует Hieroglyph для проекта.
Создание слайдов
После того, как вы включили Hieroglyph для своего проекта Sphinx, вы можете начать создание ваших слайдов. Hieroglyph использует реструктурированный текст для слайды, а по умолчанию разделы в документе сопоставляются со слайдами.
Вы можете открыть index.rst
(при условии, что вы выбрали имя по умолчанию
когда вы запустили быстрый запуск) и добавьте некоторый контент.
==================== Название презентации ===================== Первый слайд =========== Некоторый контент на первом слайде. Второй слайд ============ * А * Маркированный * Список
Здесь мы сделали три слайда: титульный слайд (с надписью «Название презентации» на нем), первый слайд с предложением на нем, а второй слайд с маркированный список.
Создание слайдов
Теперь, когда мы написали несколько простых слайдов в реструктурированном тексте, мы можем сгенерируйте HTML-слайды из этого. Для этого воспользуемся одним из включенных Строители иероглифов.
$ sphinx-build -b слайды . ./_сборка/слайды
В качестве альтернативы, если в вашей системе есть make
, быстрый запуск устанавливает директиву slides
в Makefile
, который выполняет sphinx-build
, поэтому все, что вам нужно сделать, это следующее:
$ сделать слайды
sphinx-build прочитает файл conf. py
, загрузит index.rst
, который мы редактировали, и генерируем слайды в Каталог ./_build/slides
. После запуска sphinx-build ,
этот каталог будет содержать файл index.html
вместе со всеми
CSS и Javascript, необходимые для отображения слайдов.
Пошаговые слайды
Обычно слайд со списком элементов отображается по очереди.
время. Hieroglpyh поддерживает это за счет использования числа 9.0521 сборка сорт. Давайте добавим третий слайд к index.rst
, который постепенно
отображает маркированный список.
Показывать маркеры постепенно =========================== .. первый класс::сборка - Добавление класса ``build`` в контейнер - Для постепенного отображения его содержимого - Помните, что *Sphinx* сопоставляет базовую директиву class с ``первоклассный``
Здесь директива первого класса
вызывает следующий элемент
строиться поэтапно.
Отображение изображений
Вы можете включить любое изображение в слайд, используя изображение
директива. Просто поместите их в каталог _static
в вашем
проект.
Hieroglyph также включает некоторую поддержку отображения изображения как полного
слайд с использованием директивы фигура
. Например,
Вводная колода слайдов Hieroglyph использует следующую разметку:
.. figure:: /_static/hieroglyphs.jpg :класс: заполнить CC BY-SA http://www.flickr.com/photos/tamburix/29093/
Заголовок (информация о лицензии выше) оформлен как наложение на изображение.
Цитаты
Стандартная цитата reStructuredText будет интерпретироваться как слайд цитаты, множественные цитаты или дополнительный контент (на одном слайде) не поддерживаются.
Атрибуция стандартная reStructuredText и необязательная.
Обратите внимание, что большинство тем включают класс quote
, который вы можете применить к
директива slide
(или раздел) для лучшего форматирования.
Директива
по слайду
Помимо сопоставления разделов реструктурированного текста со слайдами, вы можете
создать слайд в любой точке документа с помощью кнопки слайд
директива. Директива slide
позволяет вам
вставьте слайд в какое-либо место, кроме заголовка. Это может быть полезно
когда вы пишете один документ, который вы будете представлять в виде слайдов
ну и текст. Например, если вы пишете повествовательный учебник и
хотите включить слайды в один и тот же документ, слайд
директива делает это простым.
Давайте рассмотрим, как будет выглядеть пример пошагового слайда
используя директиву slide
:
.. slide:: Показать маркеры постепенно :уровень 2 .. первый класс::сборка - Добавление класса ``build`` в контейнер - Для постепенного отображения его содержимого - Помните, что *Sphinx* сопоставляет базовую директиву class с ``первоклассный``
Обратите внимание, что здесь нам нужно указать уровень
вариант отпустить сфинкса
знать, какому уровню соответствует этот слайд. В Сфинксе и Иероглифе,
заголовок документа имеет уровень 1, следующий уровень заголовка — уровень 2 и т. д.
В отличие от слайдов, созданных автоматически из заголовков и содержимого,
слайды, определенные с помощью директивы slide
, будут отображаться только
при создании слайдов. Если вы создаете обычный вывод HTML или PDF
вашего проекта Sphinx, содержимое директивы будет удалено.
В этом примере показано, как добавить слайды с помощью слайд
директива, но иногда вы только хотите использовать слайд
директивы. В этом случае вы можете отключить автослайды
.
Содержимое, состоящее только из слайдов и не являющееся слайдом
Еще один полезный инструмент для смешивания описательной документации со слайдами
возможность исключить контент из слайдов или наоборот. Иероглиф
предоставляет две директивы только для этой цели. ifslides
директива включает только свое содержимое при создании слайдов.
аналог, ifnotslides
включает его содержимое только тогда, когда
построение других целей. Последние, в частности, могут быть использованы для
включать заметки, которые вы хотели бы распечатать с выводом HTML или PDF, но
не включать в слайды.
Заметки докладчика
Используйте директиву note
для вставки «заметок докладчика», которые
виден только на консоли докладчика. Полный реструктурированный текст
форматирование поддерживается в примечаниях.
.. примечание:: * Обязательно упомяните важную предысторию для этот слайд.
Просмотр слайдов
Когда вы открываете HTML-слайд в браузере, он выглядит примерно так: это:
Вы можете использовать клавишу пробела для перехода к следующему слайду или левую и стрелки вправо для перемещения назад и вперед соответственно.
Иногда хочется быстро просмотреть слайды, чтобы найти
что-то, или прыгать вперед или назад. Вы можете использовать представление Slide Table для этого. Просто нажмите t
в браузере и слайды сожмутся
вниз.
Вы можете нажать на слайд, чтобы перейти туда, или снова нажать t
, чтобы выйти
слайд-стол.
Presenter Console
Если вы представляете свои слайды, часто полезно иметь возможность видеть
что будет дальше. Hieroglyph включает в себя Presenter’s Console для
эта цель. Просто нажмите c
при просмотре слайдов и консоли
откроется в новом окне.
Перемещение слайдов назад или вперед в любом окне сохранит другое синхронно.
Оформление слайдов
Самый простой способ оформить презентацию — добавить пользовательский CSS файл. Чтобы добавить пользовательский CSS, нужно выполнить два шага: во-первых, создать CSS файл, а во-вторых, скажите Hieroglyph включить его в вывод.
Иероглиф генерирует теги статьи
для слайдов и добавляет классы
исходя из их уровня. Этого достаточно, чтобы начать базовую укладку.
Создайте новый файл custom.css
в каталоге _static
в
ваш проект. В этом примере мы изменим цвет фона
сделать все слайды голубыми, а текст титульного слайда (
)
красный.
артикул { цвет фона: голубой; } статья h2 { красный цвет; }
Каталог _static
содержит статические активы, которые можно включить
в вашем выводе.
После того, как вы создали файл CSS, сообщите об этом Sphinx, установив slide_theme_options
в conf.py
:
slide_theme_options = {'custom_css': 'custom.css'}
После повторной сборки слайдов вы увидите, как новый CSS вступит в силу.
Дополнительные параметры
Hieroglyph имеет несколько параметров конфигурации, которые позволяют контролировать, как он генерирует слайды и как эти слайды связаны с HTML-вывод. Полный список см. в разделе «Параметры конфигурации».
Sphinx Extensions
Hieroglyph построен на Sphinx, который имеет множество расширений доступный. Эти расширения могут помочь вам создавать диаграммы, включая фрагменты кода, отображать математические формулы или вставлять карты. Все эти расширения доступны для Hieroglpyh, что делает его гибкая и расширяемая программа для создания презентаций.