SAPID - персональная CMS открытая для развития - [1] :: Системы управления сайтами

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

На самом деле, DDC представляет собой алгоритм, описанный в синтаксисе XML Sapiens.
Рассмотрим, например, контейнер построения новостной ленты:

Код:

<?xml version="1.0"?>
<sapi version="1.0" xmlns:sapi="http://www.xmlsapiens.org/spec/sapi.dtd">
<sapi:ddc name="news" title="ddc" ns="site1" category="news">
<sapi:author>
<sapi:name>Max Baryshnikov</sapi:name>
<sapi:email>mb@rg.by</sapi:email>
<sapi:url>www.redgraphic.com</sapi:url>
</sapi:author>
<sapi:comments>Infochannel. CMS SAPID.</sapi:comments>
<sapi:choose>
<sapi:when exp="1">
<sapi:for-each select="get_news('news.xml')" name="enum">
<sapi:choose>
<sapi:when exp="1">
<sapi:code>
<div class="date"><sapi:apply name="this.this.date.value" /></div>
<div class="news_title"><sapi:apply name="this.this.title.value" /></div>
<div class="content"><sapi:apply name="this.this.text.value" /></div>
<div class="more">
<a href="<sapi:apply name="this.this.more.value" />" title="Read more">Read more
<img src="/usr/content/images/i_more.gif" width="10" height="7" alt="Read more" /></a>
</div>
<hr />
</sapi:code>
</sapi:when>
</sapi:choose>
</sapi:for-each>
</sapi:when>
</sapi:choose>
</sapi:ddc>

Сначала идет шапка с описанием и авторством:

Код:

Открываем блок условий:

Код:

<sapi:choose>

Открываем условие (выполняется всегда, потому, что в атрибуте exp указано выражение, всегда принимающее значение true):

Код:

<sapi:when exp="1">

Далее (внимание!) открываем цикл, в котором будет перебираться массив значений, который вернет функция get_news (описанная в автоматически включаемом файле usr/extensions/get_news.inc.php); массив двухмерный, логически предстваляет собой таблицу, т.е. в тело цикла будет передаваться строка с атрибутмаи текущей новости (дата, тело новости...)

Код:

<sapi:for-each select="get_news('news.xml')" name="enum">

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

Код:

<sapi:choose>
<sapi:when exp="1">

Описание того, что будет выводить DDC. В коде стоят указатели на элементы перебираемого массива: пример указателя <sapi:apply name="this.this.date.value" /> - будет указывать на элемент массива массив[текущая строка]['date']:

Код:

<sapi:code>
<div class="date"><sapi:apply name="this.this.date.value" /></div>
<div class="news_title"><sapi:apply name="this.this.title.value" /></div>
<div class="content"><sapi:apply name="this.this.text.value" /></div>
<div class="more">
<a href="<sapi:apply name="this.this.more.value" />" title="Read more">Read more
<img src="/usr/content/images/i_more.gif" width="10" height="7" alt="Read more" /></a>
</div>
<hr />
</sapi:code>

Потом закрытие всего, что мы пооткрывали ранее:

Код:

</sapi:when>
</sapi:choose>
</sapi:for-each>
</sapi:when>
</sapi:choose>
</sapi:ddc>
</sapi>

Вот, в прнципе, и все по этому контейнеру.
Примерно такой формат мануала подойдет?

Модерирует : Antuan
Версия для печати • Подписаться • Добавить в закладки
Страницы: 1 2 3