content_mgmt

Доп возможности:

Блок стиля предупреждения

p(#error_note). Текст

Блок стиля заметки

p(#side_note). Текст

Ссылка на документацию PDF

p(pdf_link). Текст

Требуется отступ (пустая строка) после параграфа для корректной работы блока.

Форматирование оглавления:

Оглавление

* "Name_of_the_section":#link_to_section

...

Затем в тексте 

h2. %(#link_to_section)Name_of_the_section%

Таким образом при нажатии на ссылку в содержании окно браузера автоматически будет перенесено к фрагменту #link_to_section

http://habrahabr.ru/post/269665/

http://txstyle.org/article/44/an-overview-of-the-textile-syntax

• Делаем фтп-аккаунт для зерга

http://wavedrom.com/
диаграма вместо рисунки.

22 правила повествования от Pixar перевод
Работа с анимацией и 3D-графикой*

Эти правила впервые появились в твитах автора сценариев из Pixar, Эммы Коатс [Emma Coats]. Кстати, правило №9,– если вы застряли, сделайте список того, что не может произойти,- подойдёт для писателей, работающих в любых жанрах.

1. Восхищайтесь персонажем за его старания больше, чем за его успехи В теле статьи описывать конкретные действия , без выводов, все выводы - в конце статей. 
    2. Отдавайте предпочтение тому, что интересно вам как зрителю, а не тому, что прикольно делать писателю. Эти два параметра могут сильно отличаться. Уровень читателя часто отличается от уровня специалиста в данной области, описание должно быть лаконичным, понятным, доступным, без академических вставок.
    3. Стремиться к выражению лейтмотива – это замечательно, но пока вы не закончите историю, вы не сможете понять, о чём она на самом деле. А теперь перепишите её заново. текст статью подлежит многостадийной правке, от скелетного оформления до конечного результата, при этом в статье должна присутствовать одна центральная тема, о чем статья.
    4. Жили-были… Каждый день они… А однажды… Из-за этого… Из-за того… Пока наконец не… В статье описываются ответы на вопросы: как, зачем, , когда, почему именно так, почему не по другому, другому,  в чем необходимость именно этой статьи.
    5. Упрощайте. Концентрируйтесь. Комбинируйте персонажей. Не отвлекайтесь на второстепенные сюжеты. Вы можете почувствовать, что упускаете нечто важное, но зато будете более свободным. П.п. 3 - в статье должна быть центральная тема, с небольшими отклонениями, для уточнения. все отклонения выполняются в виде ссылок на внешние ресурсы, статьи.
    6. В чём ваш персонаж преуспевает, что ему нравится? Дайте ему прямую противоположность. Бросьте вызов. И как он будет справляться с этим? Обоснование предложенного в статье решениея, метода, подхода,  описание превосходства над аналогичными методами, решениями, подходами.
    7. Придумайте конец раньше середины. Реально, окончания придумывать труднее, поэтому озаботьтесь о том, чтобы ваше сработало, заранее. Эксперимент ставится с целью подтвердить и ли опровергнуть результаты гипотезы, аналдолгично статья - подтверждение или опровержение предложенного решения.
    8. Закончив историю, отложите её, даже если она несовершенна. В идеальном мире всё было бы по-другому. В следующий раз сделаете лучше. Завершенная статья подвергается рецензированию. Результаты рецензирования - пункты правки, шаблоны для последующих статей.
    9. Если вы застряли, сделайте список того, что НЕ может произойти. Часто после этого вы находите подходящий материал.
    10. Разберите истории, которые вам нравятся. То, что вам в них нравится, является частью вас – вам нужно распознать это перед тем, как вы сможете это использовать. Перед написанием статьи - необходимо рассмотреть существующие медоды, их преимущества и недостатки. на основаниии этого делается вывод о необходимости написании новой статьи.
    11. Вы сможете исправить идею только после того, как оформите её на бумаге. Если она останется у вас в голове, вы не сможете ею поделиться. Материал статьи должен быть изложен в печатном виде. 
    12. Отбросьте первое, что приходит в голову. А затем второе, третье, четвёртое и пятое. Все очевидные вещи. Удивите себя. Перед составлением материалам статьи - неодбходим плат работ по материалам и по сопутствующим инструментам.
    13. Снабдите персонажа мнением. Пассивные и покладистые персонажи могут нравиться вам, но не вашей аудитории.  хороший, теплый ламповый коментарий (С)
    14. Почему вам необходимо рассказать именно эту историю? Какое из ваших убеждений её подпитывает? Является её сердцем? (no comment)
    15. Как бы вы чувствовали себя, находись вы на месте вашего персонажа? Честность добавляет правдоподобия в невероятные ситуации.+(no comment)+
    16. Что на кону? Почему мы должны переживать за персонажа? Что случится, если они не добьются успеха? 
    17. Работа зря не пропадает. Если это не работает сейчас, отложите идею – она обязательно пригодится в другом месте. Описательная часть выводов.
    18. Познайте себя и почувствуйте разницу между достижением наилучшего результата и беспокойством из-за пустяков.
    19. Случайности, втягивающие персонажей в неприятности, отлично играют. Случайности, выручающие их оттуда, выглядят, как обман. Работа по плану  и содержанию, без отклонений от центральной темы статьи.
    20. Упражнение: возьмите составные части кинофильма, который вам не понравился. Как бы вы перераспределили их так, чтобы он стал вам нравиться?
    21. Необходимо идентифицировать себя с ситуацией и персонажем. Что заставило бы вас лично действовать подобным образом? Описание от первого, третьего лица. 
    22. В сём суть вашей истории? Как максимально эффективно рассказать её? Определитесь, и отталкивайтесь от этого. Краткость и точность выводов, возможность использования выводов качестве

Выпилить кнопки в редмайне.

Youtube:

<div class="video_frameWrap"><iframe class="video_frame" width="960" height="540" src="https://www.youtube.com/embed/IEzH6rZCFjQ"></iframe></div>

Добавлен новый стиль для табличных и фото сносок:

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

p=. !http://xdevs.com/doc/xDevs.com/Neutron/sch/sch_fdrv.png!
%(imgref)Image 1: MOSFET driver schematics, single-channel%

По мотивам Common Textile Problems and Questions

[_image[*_1*].jpg_]

Тестирование для textile:

http://txstyle.org/

Как там наш текстильчик поживает?

Список тегов, на всякий пожарный:

MODIFIERS = {
    "*" => 'strong', # bold
    "_" => 'em',     # italic
    "+" => 'ins',    # underline
    "-" => 'del',    # deleted
    "^" => 'sup',    # superscript
    "~" => 'sub'     # subscript
  }

Например ^super _sub

Тестовый сайт реализован в #1297

Izerg wrote:

- вложенное форматирование не работает

Например? Ссылку с нерабочим примером на сайте было бы здорово посмотреть.

- методику отображения картинок нужно поэтапно описывать

Верно. Кусок можешь позаимствовать отсюда

- эпизодическое выпадание сайта в осадок при некорректных действиях

Пример, ссылку. А то будет "У меня все хорошо, ничего не вижу". Нужно взять за правило - что-то не так, показываем где именно, а не отдаем на откуп хрустальному шару.

- разбить статью на 2 части - собственно textile и собственно "литературная стилистика", перваяя часть - чисто техническая с примерами, вторая - методы и стили подачи информации ( описания, обращения, пояснения, дополнения, исправления)

Я против :). Давай сперва осилим единую одну статью, а там будет видно разбивать или нет.

- заключительная часть - выводы.

Стилистика статьи, шаблонные примеры
- Работа с содержаниями-
Оформление параграфов
Работа с ссылками и разделами статьи
Оформление и форматирование
Работа с изображениями
Работа со ссылками на внутренние источники и внешние источники
Работа с таблицами
Работа с выделением
Работа с фрагментами кода
Работа с сокращениями и аббревиатурами
Сноски и подготовка изображений и публикации
Переводы и синхронизация мультиязычных статей
Дополнительные возможности движка xDevs.com в оформлении статей
Блок для вставки видеофрагментов с youtube
- Блоки заметок, важных примечаний и предупреждений-
Ссылки на трекер redmine

tin wrote:

Izerg wrote:

- вложенное форматирование не работает

Например? Ссылку с нерабочим примером на сайте было бы здорово посмотреть.

Да-да ... вот как допишу - там будет красная нотатка "так делать не надо, не работает" :)

- эпизодическое выпадание сайта в осадок при некорректных действиях

Пример, ссылку. А то будет "У меня все хорошо, ничего не вижу". Нужно взять за правило - что-то не так, показываем где именно, а не отдаем на откуп хрустальному шару.

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

- разбить статью на 2 части - собственно textile и собственно "литературная стилистика", перваяя часть - чисто техническая с примерами, вторая - методы и стили подачи информации ( описания, обращения, пояснения, дополнения, исправления)

Я против :). Давай сперва осилим единую одну статью, а там будет видно разбивать или нет.

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

- заключительная часть - выводы.

вон пример, когда редмайн даже собственное формотирование прожевал и проглотил :)

Хз, у меня ОК, если ты про https://izerg.xdevs.com/article/Textile/
З.ы. урлы именуем маленькими буковками (они же Case-sensetive). Можешь добавить в гайд.

хорошо, добавлю.

Оглавление неправильно сделано :)

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

- заключительная часть - выводы.

вон пример, когда редмайн даже собственное формотирование прожевал и проглотил :)

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

Оглавление неправильно сделано

Там совсем не работало "от рождения" , суть не в блекджеке :-)

ящичек пандоры

Special symbols in articles

Cтатья уже нужна, два автора ждутъ руководств :(

так: текущий вопрос:
работа с содержанием и линками вообще:
открываем статью https://izerg.xdevs.com/article/rpi_spi/
оглавление работает только, если линки открывать в новой вкладке броузера, на локальной странице навигация по оглавлению не работает.
открываем в соседней вкладке туже статью но https://xdevs.com/article/rpi_spi/
и о чудо - навигация работает локально на странице - никакие новые вкладки не нужны ...
броузер фирефокс, 43.0.1.
Обновил фирефокс до 44.0 - страницы заработали одинаково. Навигация по содержанию работает.
какого рожна ему надо?

а шо в админке в редакторе статей кнопка "линк" так странно работает:
запрашивает название - ввожу "Введение"
запрашивает сам линк - ввожу "#vvedenie"
в итоге получаю строчку " "Your text to link here...(Введение)":#vvedenie "
это зачем оно так ?

Победил стиль оглавления, кратко описал на примере.
дальше по списку работа с параграфами,

Жму ссылку, все работает как положено, в том же окне.

Opera 34.0.2036.50
Firefox 43.0.4
Chrome Version 48.0.2564.97 m

Кнопки забиты гвоздями.

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

Все должно уже работать без ограничений.

Работа со ссылками на внутренние источники и внешние источники

Эмм? Кто здесь..

tin wrote:

Эмм? Кто здесь..

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

Ехал на велике сегодня и пришла мысля что надо бы во введение написать зачем вообще статьи писать.

• Для документирования проекта
• "напоминалка" самому себе на будущее, когда надо будет вернуться к проекту
• Руководство последователям
• Как элемент резюме у автора.

Добавлен пункт: Вставка спец-символов в статью, например ½

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

Пример использования:

Резистор 1000 Ω был измерен с точностью ±0.10% + поправка 560µΩ. Температура среды равна +23.6°C. Измерение проведено с помощью Δ-Σ ADC.

Выходная строка:

Резистор 1000 Ω был измерен с точностью ±0.10% + поправка 560µΩ. Температура среды равна +23.6°C. Измерение проведено с помощью Δ-Σ ADC.

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

tin wrote:

• Для документирования проекта
• "напоминалка" самому себе на будущее, когда надо будет вернуться к проекту
• Руководство последователям
• Как элемент резюме у автора.

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

tin wrote:

Добавлен пункт: Вставка спец-символов в статью, например ½

Ок, дойду - разберусь - сделаю.

Все хорошо!

рабочий пример должен выглядеть так:
https://xdevs.com/article/hp3458b/

внутренние - тот же домен

просто вместо ссылки на https://xdevs.com/doc/testfolder/document.pdf просто пишем ссылку на /doc/testfolder/document.pdf

питон пишем. Кратко картинки правила пишем, для примера.