Перейти к содержимому

Температура сфинкса: Температура тела у сфинксов — какая должна быть

ТЕМПЕРАТУРА У СФИНКСА - ЧТО ДЕЛАТЬ?

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

Многие факторы, включённые в процесс поддержания температуры тела, ещё полностью не изучены. 
У кошек считается нормальной температура, находящаяся в диапазоне 37,5 – 39 градусов. При этом каждая кошка имеет свой индивидуальный показатель нормы температуры тела. 
Тем не менее, оказывается, что температура взрослых канадских сфинксов в здоровом состоянии такая же, как и у обычных кошек, не смотря на то, что сфинксы тактильно кажутся намного горячее своих кошачьих собратьев.

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

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

У сфинксов очень высокий энергообмен, поэтому температура тела у них все-таки на 0,5 — 1 градус выше, чем у обычных кошек.  

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

У здоровых взрослых сфинксов температура тела в среднем составляет 38-38,5 градусов. У маленьких котят она может быть немного больше, примерно до 39 градусов.
Температура выше 39 градусов - котенок заболел!

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

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

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

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

Лучше, если владелец знает, какая у его котенка должна быть температура в норме, ведь эти показатели все таки индивидуальны. 
Для этого в течение нескольких дней у здорового котенка необходимо было производить измерения температуры тела утром и вечером.
Тогда легко определить, насколько будут отличаться эти значения у заболевшего малыша.
И в дальнейшем, вы всегда сможете правильно сориентироваться по температуре тела котенка: болен он или здоров.
Чаще всего дальше на различных сайтах рассказывается, насколько данная процедура  для кошки неприятна и что к ней хозяевам животного необходимо тщательно подготовиться. При чем, лучше, если владелец животного будет проводить измерение не один, а с помощником.
"Перед началом измерения лапы кошки необходимо зафиксировать, запеленав её прочным полотенцем достаточного размера; голову следует придерживать за загривок, так как животное может пытаться укусить; кончик градусника аккуратно вводится в задний проход на глубину около двух см и выдерживается там необходимое время. Затем снимаются показания, а градусник протирается спиртом."

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

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

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

Если это маленький котёнок, то при высокой температуре у него появляется слабость. 

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

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

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

Если же проблема не исчезла, то необходимо срочно обращаться в ветеринарную клинику. Отправляясь к ветеринару, сфинкса нужно завернуть во что-нибудь тёплое. Специалист точно определит причину заболевания и назначит необходимое лечение.

Вы собираетесь купить канадского сфинкса? Это очень важный шаг!

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

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

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

Терморегуляция сфинкса. Температура тела сфинкса.

Терморегуляция сфинкса

 

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

 

Новорожденные котята сфинксы не в состоянии самостоятельно поддерживать температуру тела. Без материнского тепла даже при температуре + 18 °C они могут погибнуть от переохлаждения. Котята греются от матери-кошки. А когда жарко расползаются друг от друга. Именно в подсосном периоде котята сфинксы учатся отыскивать тепло и сохранять постоянную температуру тела, используя внешний источник тепла.

 

Нормальная температура тела котенка сфинкса в среднем от 38,5 до 39,5 °C. В растущем организме обменные процессы происходят быстрее, поэтому и температура тела выше. У взрослых кошек этот показатель колеблется между 38,0 и 39,0 °C. Если внешняя среда каким-то образом будет воздействовать на организм кошки, будь то холод или жара, животное будет предпринимать меры чтобы нормализовать температуру тела.

 

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

 

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

 

КАК ПОМОЧЬ СФИНКСУ ПЕРЕЖИТЬ ЖАРУ

 

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

 

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

 

Если у сфинкса нет возможности уйти от жары

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

 

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

 

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

 

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

 

ТЕПЛОВОЙ УДАР: СИМПТОМЫ И ПЕРВАЯ ПОМОЩЬ

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


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

 

 


Вернуться назад

Развенчаем пару мифов о сфинксах

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

Миф первый. Сфинксы не вызывают аллергии.

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

Миф второй. Температура тела сфинкса 42 градуса. 

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

 

 

Миф третий. Сфинксы очень сложны в уходе и содержании. 

Мне часто задают вопросы: А правда, что сфинксов надо купать каждый день? А правда, что сфинксам необходимо чистить уши каждый день? А правда, что сфинксам нужно смазывать кожу маслом или кремом? А правда, что сфинксы очень мерзнут и их необходимо одевать? 
Нет, не правда! Конечно, сфинксов необходимо купать время от времени, но только по мере загрязнения, а здоровые и находящиеся на правильном и подходящем питании сфинксы практически не пачкаются.Из пяти сфинксов живущих у меня двоих можно купать раз в пол года, троих раз в месяц.
Уши у сфинксов загрязняются быстрее и больше, чем у обычных кошек, это правда, но чистки здоровые уши сфинкса требуют раз в две недели, если уши пачкаются быстрее, то необходимо пересмотреть рацион питания, так как не неподходящем и/или слишком жирном корме и сам сфинкс и его уши могут сильно пачкаться, так же необходимо показать сфинкса ветеринару и сдать анализы. Только вот с ветеринарами тоже будьте осторожны, многие ветеринары не зная специфики породы ставят диагноз ушной клещ и залечивают бедного сфинкса. Поэтому прежде всего сдайте анализы и не верьте ветеринарам на слово! 
Ни в каких кремах и маслах кожа канадского сфинкса не нуждается. 
Канадские сфинксы не тепличные животные, поэтому в одежде для дома они тоже не нуждаются. У меня есть одежда для каждого моего питомца, но мы одеваем ее только в дорогу в холодное время года и берем на выставки, так как иногда в больших залах бывает слишком холодно. Дома мои сфинксы никакой одежды не носят. Да и не к чему она им.

 

 

 

Миф четвертый. Сфинксы- египетские кошки.

Несмотря на то, что сфинксы ассоциируются с Египтом, породу, которую мы привыкли видеть, вывели в Канаде, и именно поэтому ее название всегда имеет приставку «канадский». Египетских же сфинксов не бывает (за исключением, разумеется, знаменитого памятника архитектуры!), это всего лишь миф, как и большинство мифов о животных, хотя, безусловно, голые кошки жили и в древние времена. Определенные виды таких животных встречались еще у ацтеков и позднее их называли мексиканскими бесшерстными кошками – в Америку, а затем и в Европу они были завезены именно из Мексики.

 Все основное время они были голыми, однако зимой на их теле вырастала длинная шерсть, которая держалась до потепления. Их демонстрировали на первых кошачьих выставках 20-х годов ХХ ст. в США, и последняя пара таких животных дожила до 30-х гг., но, к сожалению, не оставила потомства. Именно тогда ей на смену пришли канадские голые кошки, которые сегодня являются королями всех выставок и любимцами многочисленных заводчиков.

 Появились голые кошки с канадской «пропиской» еще 40 лет назад и почти сразу завоевали мир. Впрочем, есть и другие разновидности сфинксов:

 -донские сфинксы – выведены в России и по-другому могут называться русскими бесшерстными,

-петербургские сфинксы – также выведены в России, но в особых условиях сурового петербургского климата (также могут носить название питерболд).

 

Миф пятый. Сфинксов вывели при помощи генной инженерии в лаборатории.

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

 

 

Миф шестой. Сфинкс- это обязательно "голая" кошка. 

Не обязательно! Например, канадский сфинкс на ощупь как персик. Его кожа покрыта мельчайшими мягкими волосками. Донские и петербургские сфинксы могут быть как абсолютно голыми (что называется «резиновыми»), так и брашевыми («браш» - щётка – англ.), т.е. покрыты жесткими волосками без подшёрстка. Между «голостью» и «брашевостью» есть ещё промежуточные варианты типа шерсти(велюр,флок).


использована информация с сайта sph-nv.ru

Сфинксы и особенности их содержания

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

Особенности содержания сфинксов

Кожа

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

Зубы и когти

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

Читайте также: Мейн-кун: история породы, характер и уход

Питание

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

Температура тела

Главный враг сфинксов - холод. Первые кошки этой породы жили в Египте, поэтому они очень любят тепло. Температура тела взрослой особи варьируется от 38 до 40 градусов. У котят она может доходить до 42 градусов. Чтобы у котенка сформировался иммунитет, не укутывайте его сильно.

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

Читайте также: Породы кошек, которые любят купаться

Жизнедеятельность

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

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

Читайте также: Бурма: история породы, характер, уход

Фото: domikdomovenka.ru

Параметры индексирования Sphinx

Параметры index Sphinx настраиваются в секции index {} в виде param = value .

Минимальный набор:

параметр пример значения описание
исходный код EOL ;?> имя источника
путь EOL ; ?> путь
docinfo extern способ хранения опций
морфология stem_ru морфология, возможно указать несколько: stem_ru, stem_en или stem_enru, Soundex, Metaphone (поиск по совпадению звучания)
min_stemming_len 3 минимальная длина слова, при которой включается стемминг
enable_star 1) 1 звездочки в запросах, например * борон * => оборона, борона
min_word_len 2 минимальная длина слова для индексации
min_infix_len 2 минимальная длина инфиниксов
min_prefix_len 3 минимальная длина префикса
charset_type 2) utf-8 кодировка
charset_table /, 0..9, A..Z-> a..z, a..z, U + 410..U + 42F-> U + 430..U + 44F, U + 430..U + 44F, U + 401 -> U + 435, U + 451-> U + 435 таблица допустимых символов
html_strip 1 1 - удалить HTML -теги, 0 - не удалять
словоформы /path/wordforms.txt словоформы, для исправления ошибок стемминга, а также можно использовать как словарь синонимов в формате ispell или MySpell (можно сделать в Open Office)
стоп-слов / путь / стоп-слова.txt стоп-слова, не индексируются
blend_chars - смешанные символы: и допустимы с словах, и разделители слов одновременно

Дополнительные опции:

html_remove_elements скрипт какие HTML элементы удалять
html_index_attrs img = alt, title; a = title индексирование HTML -атрибутов
expand_keywords 1 автоматически расширяет поисковый запрос до трех запросов работает => работает + * выполняется * + = выполняется
index_exact_words 1 хранить оригинальное слово, увеличивает релевантность, если выставлена ​​опция expand_keywords
ignore_chars U + AD игнорировать символы, как их вообще нет в тексте, слова «склеятся» и будут считаться одним словом, в примерах - символы мягкого переноса

min_infix_len

Если min_infix_len = 2 , то test будет искаться по te , es , st , tes , est .

Меньшее значение слишком много мусора и сильно увеличивает индекс. Рекомендуемое значение min_infix_len = 3 .

При большом количестве документов лавинообразно растет индекс.

min_prefix_len

Если min_prefix_len = 3 , то «пример» будет искаться как «exa», «экзамен», «пример», «экзамен» и все слово.

charset_table

U + 401-> U + 435, U + 451-> U + 435 - заставляет не делать различия между «Е» и «Ё».

index_exact_words

Если также выставлена ​​опция expand_keywords , результаты становятся более релевантны за счет хранения оригинального слова, а не его части.

Увеличивает размер индекса.

.

Делаем учебник или документацию за час на Сфинксе / Хабр

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

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


Устанавливаем Питон и инструменты

На платформе Windows вам понадобится Питон, и его установку я оставляю вам в качестве домашнего задания.Кроме Питона нужен пакет distribute и curl (или wget). Скачиваем и устанавливаем distribute и pip:

  curl http://python-distribute.org/distribute_setup.py | питон
    curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | питон
  

Теперь можно установить сам Sphinx:

  pip install sphinx
  

* в Ubuntu / Debian добавить sudo

Создаём проект учебника

После этой достаточно создать папку для проекта и в ней запустить скрипт sphinx-quickstart .Он задаст несколько вопросов. Из них, на мой взгяд, по-другому надо ответить на два:

 > Разделить каталоги исходного кода и сборки (да / нет) [n]: y (Сделать ли раздельные папки исходников и готовых страниц - Да)
    > Создать командный файл Windows? (Y / n) [y]: n (Сделать ли файл .bat, - нет, если у вас Linux)
  

Заготовка проекта готова. Дальше можно открывать index.rst и пробовать править.

Как изучить разметку ReStructured Text? Хороший софт не требует чтения документации.Сфинкс - не исключение: на всех сделанных им страницах есть ссылка «Показать исходный код» («Показать исходный код») . Подглядывая в чужие исходники, можно научиться очень многому и быстро. Смотрите и экспериментируйте.

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

  make html
  

Открываем из папок _build / html страницу index.html, и радуемся. У нас готов статический сайт с поиском (на JavaScript).

Автосборка

Наконец, когда мы стали редактировать файлы, оказывается, что каждый раз запускать make html и обновлять броузер - очень нудное занятие.Пакет inotify позволяет следить за изменениями файлов и запускать команды. Устанавливаем infotify-tools и xdotool:

  sudo apt-get install inotify-tools xdotool
  

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

  inotifywait -mr source --exclude _build -e close_write -e create -e delete -e move | при чтении файла событие; делать
сделать singlehtml html
xdotool search --name Chromium key --window% @ F5
сделанный
  

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

  inotifywait -mr source --exclude _build -e close_write -e create -e delete -e move --format '% w% e% T' --timefmt '% H% M% S' | при чтении файла событие tm; делать
current = $ (дата + '% H% M% S')
delta = ʻexpr $ current - $ tm`
если [$ delta -lt 2 -a $ delta -gt -2]; тогда
sleep 1 # спать 1 секунду на случай если не все файлы скопированы
сделать html singlehtml
xdotool search --name Chromium key --window% @ F5
фи
сделанный
  

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

Вы также можете встроить его в Makefile:

  .PHONY autobuild
автосборка:
<скрипт>
  
Форматы документации

Сфинкс умеет делать многостраничный HTML, умеет сделать единый файл, а также PDF, электронные книги (EPUB) и кто-то делал CHM.

Сделать PDF есть 2 Способ: установить Latex, выкачав 1 ГБ пакетов, зато на выходе будет кофетка. Другой вариант - новый питоновский пакет rst2pdf, быстрый и простой, выдаст PDF очень простецкого вида. Над ним придётся потрудиться, чтобы довести стиль до приличного.

Скачивание документации в PDF

Я добавляю ссылку на скачивание PDF на главной странице, это инструкция скачать. Чтобы она не была видна в самóм PDF, есть блок только:

  .. only :: html
        Этот учебник можно скачать: скачать: `в формате PDF <../build/latex/manual.pdf> `.
  

Внимание: когда Сфинкс собирает HTML, он скопирует этот файл в папку статики. Поэтому чтобы версии совпадали, надо генерировать сначала PDF, только потом HTML.

Публикация

Есть 3 варианта. Простейший - залить проект на BitBucket, к репозиторию бесплатный сервис Прочтите документы, зарегистрироваться на ReadTheDocs и создать там проект. Когда вы будете заливать новые ревизии в главной ветке, RTD будет скачивать их и переделывать документацию.Таким образом, документацией для программной библиотеки специально заниматься не нужно: поддерживать в актуальном состоянии докстринги.

Если же хочется держать закрытый сайт для своих, можно сделать простой запароленный сайт и собирать его вручную. В корень сайта достаточно закачать содержимое папки _build / html. Я для этого использую rsync и написал 2 строки в Makefile:

  .PHONY: sync
синхронизация: latexpdf html
rsync -ave ssh build / html / siberiano @ хостинг: / home / siberiano / webapps / course_manual / --delete
  

Сначала будет собрана документация в формате latexpdf, затем в html (и в «загрузить» будет добавлена ​​PDF), затем rsync залёт файлы на хостинг, удалив старые (опция --delete).

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

Красивое оформление

Сфинкс использует «темы», это шаблоны Jinja плюс статические файлы, сложенные в одну. Я выложил несколько собранных из свободного доступа тем. Чтобы включить тему, нужно настроить 2 строки conf.py:

  html_theme = 'armstrong' # имя темы
html_theme_path = ['themes'] # папка внутри источника, где лежат папки тем
  

Результат:

Резюме


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

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

Добавление от 11.10.12: на ГитХабе я нашёл редактор преформатированных таблиц для SublimeText, сделанный специально для тех, кто редактирует RST и Markdown.

.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *