Секреты "Apache Forrest"

Сейчас создавать сайты на "голом" HTML'е бесмысленно, т.к. уже давно изобретены разные инструменты для их быстрого создания, где вас будет только заботить информационная часть, изредка программная. Но, большинству движков необходим какой-либо скриптовый языка программирования, а так же, базы данных. Но большинство бесплатных хостингов ограничиваются только показом HTML, поэтому я начал искать инструмент для создания статических сайтов. И он был найден. Имя ему - "Apache Forrest". Стоит упомянуть, что данный сайт сделан именно на этом движке. Более подробную информацию вы можете получить на сайте проекта и на - Javable. Скажу лишь, что для создания сайта вам потребуется JVM, знание XML и, если вы будете менять темы - минимальные знание xsl, css, html. Для редактирования xml-файлов, я пользуюсь emacs'ом, чего и вам советую.

Из коробки, forrest, по крайней мере версия 0.6, в pdfках вместо русского текста, генерит решетки "#". Казус весь в настройках шрифтов для fop. Озадачившись этой проблемой, я ринулся в гугл, который меня вывел на сайт Javable, где эта проблема была решена в дистрибутиве метного разлива. Скажем спасибо этим добрым людям или доброму человеку.

Далее будет упомянаться пути на каталоги, где:
$FORREST_HOME - путь до директории, где установлен форрест $FORREST_CONTEXT - путь, где лежат глобальные конфигурационные файлы, к примеру, "$FORREST_HOME/src/core/context"

Нам необходимо будет сгенерировать метрики для шрифтов или взять уже готовые, положить их, к примеру, в каталог "$FORREST_CONTEXT/fontmetrics". Сами шрифты можно будет установить в "$FORREST_CONTEXT/fonts".

Прописываем в "$FORREST_CONTEXT/sitemap.xmap", что используем конфиг для fop:

...
      <map:serializer name="fo2pdf"
      src="org.apache.cocoon.serialization.FOPSerializer"
      mime-type="application/pdf">
        <user-config src="userconfig.xml"/>
      </map:serializer>
...
      

Создаем (копируем) конфиг userconfig.xml в папку "$FORREST_CONTEXT". В этом файле сопоставляем шрифт и метрику. Я его описывать не буду, т.к. описание есть на сайте fop. Шрифты, описанные в этом самом конфиге (в моем примере), копируем в "$FORREST_CONTEXT/fonts".

Заетем, чтобы содержание в начале отображалось на русском языке, меняем файл "$FORREST_CONTEXT/fonts/skins/common/xslt/fo/document2fo.xsl":

..
<xsl:template match="body[count(//section) != 0]">
<xsl:if test="$toc-max-depth > 0">
  <fo:block font-family="serif" font-size="14pt" font-weight="bold"
  space-after="5pt" space-before="5pt" text-align="justify" width="7.5in">
    <!-- insert i18n stuff here -->
    <xsl:text>Table of contents</xsl:text>
  </fo:block>
--  <fo:block font-family="sans" font-size="12pt" space-after="5pt"
++  <fo:block font-family="serif" font-size="12pt" space-after="5pt"
  space-before="0pt" text-align="justify" width="7.5in">
      <xsl:if test="$page-break-top-sections">
        <xsl:attribute name="break-after">page</xsl:attribute>
      </xsl:if>
      <xsl:apply-templates select="section" mode="toc" />
  </fo:block>
</xsl:if>
<xsl:apply-templates />
</xsl:template>
..
      

Вот и все. Теперь в pdfках можно лицезреть русские буковки.

На хостинге www.narod.ru HTML должен "отдаваться" в кодировке windows-1251 (forrest по-умолчанию создает хтмл в юникоде). Для этого меняем в файле "$FORREST_CONTEXT/sitemap.xmap":

...
  <map:serializer name="html" mime-type="text/html" src="org.apache.cocoon.serialization.HTMLSerializer">
    <doctype-public>-//W3C//DTD HTML 4.01 Transitional//EN</doctype-public>
    <doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system>
--    <encoding>UTF-8</encoding>
++    <encoding>WINDOWS-1251</encoding>
  </map:serializer>
...
      

А фича вот в чем. В самом html-коде, вы будете видеть все в кодах символах, к примеру, &0012; и т.д. :). Я сильно парится не стал, слабал скрипт, который все хтмл-файлы перед отправкой на narod.ru перекодирует из юникода в windows-1251. Хотя, можно и оставить, т.к. сам файл будет соответствовать стандартам.