radiant-turkish_language_pack-extension 1.0.3

data/README

@@ -0,0 +1,9 @@
+= I18n Tr
+
+Turkish language pack for Radiant. Translation consists of
+admin UI strings and description of radiant tags.
+
+== Yapılacaklar (TO-DO's)
+
+Tags in config/locales/tr_available_tags.yml will be translated in Turkish.
+config/locales/tr_available_tags.yml dosyası full türkçeye çevirilecek dikkat edilerek.

data/Rakefile

@@ -0,0 +1,123 @@
+# I think this is the one that should be moved to the extension Rakefile template
+
+# In rails 1.2, plugins aren't available in the path until they're loaded.
+# Check to see if the rspec plugin is installed first and require
+# it if it is.  If not, use the gem version.
+
+# Determine where the RSpec plugin is by loading the boot
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require File.dirname(ENV["RADIANT_ENV_FILE"]) + "/boot"
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../")}/config/boot"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../")}/config/boot"
+  end
+end
+
+require 'rake'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+rspec_base = File.expand_path(RADIANT_ROOT + '/vendor/plugins/rspec/lib')
+$LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
+require 'spec/rake/spectask'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+# Cleanup the RADIANT_ROOT constant so specs will load the environment
+Object.send(:remove_const, :RADIANT_ROOT)
+
+extension_root = File.expand_path(File.dirname(__FILE__))
+
+task :default => :spec
+task :stats => "spec:statsetup"
+
+desc "Run all specs in spec directory"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+task :features => 'spec:integration'
+
+namespace :spec do
+  desc "Run all specs in spec directory with RCov"
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec', '--rails']
+  end
+  
+  desc "Print Specdoc for all specs"
+  Spec::Rake::SpecTask.new(:doc) do |t|
+    t.spec_opts = ["--format", "specdoc", "--dry-run"]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+
+  [:models, :controllers, :views, :helpers].each do |sub|
+    desc "Run the specs under spec/#{sub}"
+    Spec::Rake::SpecTask.new(sub) do |t|
+      t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+      t.spec_files = FileList["spec/#{sub}/**/*_spec.rb"]
+    end
+  end
+  
+  desc "Run the Cucumber features"
+  Cucumber::Rake::Task.new(:integration) do |t|
+    t.fork = true
+    t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'pretty')]
+    # t.feature_pattern = "#{extension_root}/features/**/*.feature"
+    t.profile = "default"
+  end
+
+  # Setup specs for stats
+  task :statsetup do
+    require 'code_statistics'
+    ::STATS_DIRECTORIES << %w(Model\ specs spec/models)
+    ::STATS_DIRECTORIES << %w(View\ specs spec/views)
+    ::STATS_DIRECTORIES << %w(Controller\ specs spec/controllers)
+    ::STATS_DIRECTORIES << %w(Helper\ specs spec/views)
+    ::CodeStatistics::TEST_TYPES << "Model specs"
+    ::CodeStatistics::TEST_TYPES << "View specs"
+    ::CodeStatistics::TEST_TYPES << "Controller specs"
+    ::CodeStatistics::TEST_TYPES << "Helper specs"
+    ::STATS_DIRECTORIES.delete_if {|a| a[0] =~ /test/}
+  end
+
+  namespace :db do
+    namespace :fixtures do
+      desc "Load fixtures (from spec/fixtures) into the current environment's database.  Load specific fixtures using FIXTURES=x,y"
+      task :load => :environment do
+        require 'active_record/fixtures'
+        ActiveRecord::Base.establish_connection(RAILS_ENV.to_sym)
+        (ENV['FIXTURES'] ? ENV['FIXTURES'].split(/,/) : Dir.glob(File.join(RAILS_ROOT, 'spec', 'fixtures', '*.{yml,csv}'))).each do |fixture_file|
+          Fixtures.create_fixtures('spec/fixtures', File.basename(fixture_file, '.*'))
+        end
+      end
+    end
+  end
+end
+
+desc 'Generate documentation for the de extension.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'I18nDeExtension'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# For extensions that are in transition
+desc 'Test the de extension.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+# Load any custom rakefiles for extension
+Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/config/locales/tr.yml

@@ -0,0 +1,237 @@
+---
+tr: 
+  account: 'Hesap'
+  activerecord:
+    errors:
+      messages:
+        blank: 'burası boş olmamalı' # required
+        invalid: 'bu formata uygun değil' #invalid_format
+        not_a_number: 'bu mutlaka sayı olmalı' # must be number
+        not_a_page: "burada bir sayfa olmalı"
+        not_permitted: 'burası mutlaka izin verilen değerlerde olmalı'
+        taken: 'bu isim zaten kullanımda' # name_in_use
+        too_long: 'burası mutlaka %{count} karakterden uzun olmamalı' # character_limit
+        too_short: 'burası mutlaka %{count} karakterden kısa olmamalı' # character_minimum
+      models:
+        page:
+          attributes:
+            slug:
+              taken: 'Slug sayfa kardeş sayfalar tarafından kullanılıyor' # slug_in_use
+        user:
+          attributes:
+            email:
+              invalid: 'bu geçerli bir e-mail adresi değil' # invalid_email
+            login:
+              taken: 'bu oturum zaten açık ve kullanılıyor' # login already in use
+            password:
+              confirmation: 'parola uyumu sağlanmalı' # password_confirmation
+  add_child: 'Alt Sayfa Ekle'
+  add_field: 'Alan Ekle'
+  add_part: 'Bölüm Ekle'
+  add_tab: 'Tab Ekle'
+  admin: 'Yönetici' 
+  available_tags: 'Kullanılabilir Etiketler'
+  available_tags_for: '%{name} için Kullanılabilir Etiketler'
+  body: 'Gövde'
+  breadcrumb: 'Tam hazır olmayan taslak'
+  buttons:
+    create: '%{name} Oluştur'
+    save_and_continue: 'Kaydet ve Düzenlemeye Devam Et'
+    save_changes: 'Değişiklikleri Kaydet'  
+  cancel: 'İptal Et'
+  change: 'Değiştir'
+  close: 'Kapat'
+  config:
+    admin:
+      title: 'Yönetici Başlık İsmi'
+    defaults:
+      locale: 'varsayılan dil'
+      page:
+        fields: "sayfa alanları"
+        filter: "sayfa filtresi"
+        parts: "sayfa bölümleri"
+        status: "sayfa durumu"
+      snippet:
+        filter: "snippet filtresi"
+    dev:
+      host: "geliştirici sitesi domaini"
+    local:
+      timezone: "yerel zamandilimi"
+    site:
+      title: "site başlığı"
+      host: "site domaini"
+    user:
+      allow_password_reset?: "parola sıfırlamaya izin ver"
+  content: 'İçerik'
+  content_type: 'İçerik Tipi'    
+  creating_status: 'Oluşturuluyor %{model}'
+  date:
+    abbr_day_names: [Pzr, Pzt, Sal, Çrş, Prş, Cum, Cmt]
+    abbr_month_names: [~, Ock, Şub, Mar, Nis, May, Haz, Tem, Ağu, Eyl, Eki, Kas, Ara]
+    day_names: [Pazar, Pazartesi, Salı, Çarşamba, Perşembe, Cuma, Cumartesi]
+    formats:
+      default: "%d-%m-%Y"
+      long: "%B %e, %Y"
+      only_day: "%e"
+      short: "%e %b"
+    month_names: [~, Ocak, Şubat, Mart, Nisan, Mayıs, Haziran, Temmuz, Ağustos, Eylül, Ekim, Kasım, Aralık]   
+    order: [ :day, :month, :year ]
+  delete_layout: 'Görünüm Düzenini Sil'
+  delete_pages: '%{pages} sayfalarını sil'
+  delete_snippet: 'Snippet Sil'
+  delete_user: 'Kullanıcı Sil'
+  description: 'Açıklama'
+  design: 'Dizayn'
+  designer: 'Dizayncı'
+  draft: 'Taslak'
+  edit: 'Düzenle'
+  edit_configuration: 'Konfigürasyon Düzenle'
+  edit_layout: 'Görünümü Düzenle'
+  edit_page:  'Sayfa Düzenle'
+  edit_preferences: 'Tercih Düzenle'
+  edit_settings: 'Ayar Düzenle'
+  edit_snippet: 'Snippet Düzenle'
+  edit_user: 'Kullanıcı Düzenle'
+  email_address: 'E-mail Adresi'
+  extension: 'Eklenti'
+  extensions: 'Eklentiler'
+  filter: 'Filtre'
+  hidden: 'Gizlenmiş'
+  hide: 'Gizle' 
+  keywords: 'Anahtar Kelimeler'
+  language: 'Dil'
+  layout: 'Görünüm'
+  layouts: 'Görünümler'
+  log_out: 'Çıkış yap'
+  logged_in_as: 'Giriş yapan: '
+  login: 'Giriş Yap'
+  modify: 'Değiştir'
+  more: 'Fazlası...'
+  more_info: 'Daha Fazla Bilgi...'
+  name: 'İsim'
+  new_homepage: 'Yeni Anasayfa'
+  new_layout: 'Yeni Görünüm'    
+  new_page: 'Yeni Sayfa'
+  new_password: 'Yeni Parola'
+  new_snippet: 'Yeni Snippet'
+  new_user: 'Yeni Kullanıcı'  
+  'no': 'Hayır'
+  no_layouts: 'Görünüm Yok'
+  no_pages: 'Sayfa Yok'
+  no_snippets: 'Snippet Yok'
+  normal_page: 'Normal Sayfa'
+  notes: 'Notlar'    
+  optional: 'Opsiyonel'
+  or: 'ya da'
+  page: 'Sayfa'
+  page_hierarchy: 'Geçerli sistenin sayfa hiyerarşisi'
+  page_page: 'Sayfa Bölümü'
+  page_title: 'Sayfa Başlığı'  
+  page_type: 'Sayfa Tipi'
+  pages: 'Sayfalar'
+  pages_controller:
+    removed_many: "Sayfalar siteden başarıyla silindi."   
+    removed_one: "Sayfa siteden başarıyla silindi."  
+    saved: "Sayfanız kaydedildi."  
+  password: 'Parola' 
+  password_confirmation: 'Parola Doğrula'
+  personal: 'Kişisel'
+  personal_preferences: 'Kişisel Tercihler'
+  please_login: 'Lütfen Giriş Yapın'
+  powered_by: 'Arkasındaki güç'
+  preferences: 'Tercihler' 
+  preferences_controller:
+    error_updating: 'Tercihleriniz güncellerinirken bir hata ile karşılaşıldı.'      
+    updated: 'Tercihleriniz güncellendi.' 
+  preview: 'Önizleme'
+  published: 'Yayınlandı'
+  published_at: 'Yayınlanma yeri' 
+  published_on: 'Yayınlanma zamanı'
+  reference:  'Referans'
+  remember_me: 'Beni hatırla'
+  remember_me_in_this_browser: 'Beni bu tarayıcıda hatırla'
+  remove: 'Sil'
+  remove_field: 'Alan Sil'
+  remove_layout: 'Görünüm Sil'
+  remove_page: 'Sayfa Sil'
+  remove_pages: '%{pages} Sil'
+  remove_snippet: 'Snippet Sil'
+  remove_tab: 'Tab Sil'
+  remove_user: 'Kullanıcı Sil'
+  required: 'Gerekli'  
+  resource_controller:
+    not_found: "%{humanized_model_name} bulunamadı."
+    removed: "%{humanized_model_name} silinmiş."
+    saved: "%{humanized_model_name} kaydedildi."
+    update_conflict: "%{humanized_model_name} son yüklemeden beri modifiye edilmiş. Veri kaybı olmadan silinmesi mümkün değil."
+    validation_errors: "Bu form işlenirken onaylama hataları oluştu. Devam etmeden önce formunuzu gözden geçirip hataları düzeltiniz."
+  reviewed: 'Gözden geçirildi'
+  roles: 'Roller'
+  saving_changes: Değişiklikler kaydediliyor
+  saving_preferences: Tercihler kaydediliyor
+  scheduled: "Zamanlandı"
+  search_tags: 'Etiket Ara:'
+  select:
+    default: '<varsayılan>'
+    inherit: '<dahili>'
+    none: '<hiçbiri>' 
+    normal: '<normal>'
+  settings: 'Ayarlar'
+  show_all: 'Hepsini Göster'
+  slug: 'Slug Sayfa'
+  snippet: 'Snippet'   
+  snippets: 'Snippetler'
+  status: 'Durum'
+    # Warnings and info text:
+  testing: Test yapılıyor
+  text:
+    layouts:
+      remove_warning: '<strong class="warning">permanently remove</strong> görünümüne geçmeye emin misiniz?'   
+    pages: 
+      remove_warning: 'Gerçekten <strong class="warning">permanently remove</strong> %{pages} silmeye kararlı mısınız?'
+    snippets:
+      remove_warning: 'Gerçekten <strong class="warning">permanently remove</strong> bu snippeti silecek misiniz?'
+    users: 
+      remove_warning: 'Gerçekten <strong class="warning">permanently remove</strong> bu kullanıcıyı silecek misiniz?'
+  this_file_language: "Turkish" 
+  time:
+    formats:
+      datetime:
+        formats:
+          default: "%m-%Y-%dT%H:%M:%S%Z"
+      default: "%a %b %d %H:%M:%S %Z %Y"   
+      long: "%B %d, %Y %H:%M"
+      only_second: "%S"
+      short: "%d %b %H:%M"
+      time: "%H:%M"
+      timestamp: "%I:%M %p on %B %d, %Y" 
+  timestamp:
+    at: 'at'
+    by: 'by'
+    last_updated: 'Son Güncelleme'
+  type: 'Tip'
+  units:
+    KB: "KB"
+    MB: "MB"
+    GB: "GB"
+    seconds: "saniye"
+    minutes: "dakika"
+    hours: "saat"
+    days: "gün"
+    weeks: "hafta"
+    months: "ay"
+  user: 'Kullanıcı'
+  username: 'Kullanıcı Adı'
+  username_or_email: 'Kullanıcı Adı veya E-mail Adresi'
+  users: 'Kullanıcılar'
+  users_controller:
+    cannot_delete_self: 'Kendinizi silemezsiniz.'    
+  version: 'Versiyon'
+  view_site: 'Siteyi Gör'
+  warning: 'Uyarı'
+  website: 'Websitesi'
+  welcome_controller:
+    invalid_user: 'Geçersiz kullanıcı adı, e-mail adresi, veya parola.' 
+    logged_out: 'Çıkışınız yapıldı. Çıktınız'  
+  'yes': 'Evet'
+  

data/config/locales/tr_available_tags.yml

@@ -0,0 +1,625 @@
+
+---
+en:
+  desc: 
+    aggregate-children-count: "Renders the total count of children of the aggregated pages.  Accepts the
+      same options as @<r:children:each />@.
+
+      *Usage*:
+      
+      <pre><code><r:aggregate paths=\"/section1; /section2; /section3\">
+        <r:children:count />
+      </r:aggregate></code></pre>"
+    aggregate-children-each: "Renders the contained block for each child of the aggregated pages.  Accepts the
+      same options as the plain @<r:children:each />@.
+
+      *Usage*:
+      
+      <pre><code><r:aggregate paths=\"/section1; /section2; /section3\">
+        <r:children:each>
+            ...
+        </r:children:each>
+      </r:aggregate></code></pre>"
+    aggregate-children-first: "Renders the first child of the aggregated pages.  Accepts the
+      same options as @<r:children:each />@.
+
+      *Usage*:
+      
+      <pre><code><r:aggregate paths=\"/section1; /section2; /section3\">
+        <r:children:first>
+            ...
+        </r:children:first>
+      </r:aggregate></code></pre>"
+    aggregate-children-last: "Renders the last child of the aggregated pages.  Accepts the
+      same options as @<r:children:each />@.
+
+      *Usage*:
+      
+      <pre><code><r:aggregate paths=\"/section1; /section2; /section3\">
+        <r:children:last>
+            ...
+        </r:children:last>
+      </r:aggregate></code></pre>"
+    aggregate-each: "Sets the scope to the individual aggregated page allowing you to
+      iterate through each of the listed paths.
+      
+      *Usage*:
+      
+      <pre><code><r:aggregate:each paths=\"/section1; /section2; /section3\"> ... </r:aggregate:each></code></pre>"
+    aggregate: "Aggregates the children of multiple paths using the @paths@ attribute.
+      Useful for combining many different sections/categories into a single
+      feed or listing.
+      
+      *Usage*:
+      
+      <pre><code><r:aggregate paths=\"/section1; /section2; /section3\"> ... </r:aggregate></code></pre>"
+    author: "Renders the name of the author of the current page."
+    breadcrumb: "Renders the @breadcrumb@ attribute of the current page."
+    breadcrumbs: "Renders a trail of breadcrumbs to the current page. The separator attribute
+      specifies the HTML fragment that is inserted between each of the breadcrumbs. By
+      default it is set to @>@. The boolean @nolinks@ attribute can be specified to render
+      breadcrumbs in plain text, without any links (useful when generating title tag). 
+      Set the boolean @noself@ attribute to omit the present page (useful in page headers).
+
+      *Usage:*
+
+      <pre><code><r:breadcrumbs [separator=\"separator_string\"] [nolinks=\"true\"] [noself=\"true\"]/></code></pre>"
+    children-count: "Renders the total number of children."
+    children-each-child: "Page attribute tags inside of this tag refer to the current child. This is occasionally
+      useful if you are inside of another tag (like &lt;r:find&gt;) and need to refer back to the
+      current child.
+
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:child>...</r:child>
+      </r:children:each>
+      </code></pre>"
+    children-each-header: "Renders the tag contents only if the contents do not match the previous header. This
+      is extremely useful for rendering date headers for a list of child pages.
+
+      If you would like to use several header blocks you may use the @name@ attribute to
+      name the header. When a header is named it will not restart until another header of
+      the same name is different.
+
+      Using the @restart@ attribute you can cause other named headers to restart when the
+      present header changes. Simply specify the names of the other headers in a semicolon
+      separated list.
+
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:header [name=\"header_name\"] [restart=\"name1[;name2;...]\"]>
+            ...
+        </r:header>
+      </r:children:each>
+      </code></pre>"
+    children-each-if_first: "Renders the tag contents only if the current page is the first child in the context of
+      a children:each tag
+      
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:if_first >
+            ...
+        </r:if_first>
+      </r:children:each>
+      </code></pre>"
+    children-each-if_last: "Renders the tag contents only if the current page is the last child in the context of
+      a children:each tag
+      
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:if_last >
+            ...
+        </r:if_last>
+      </r:children:each>
+      </code></pre>"
+    children-each-unless_first: "Renders the tag contents unless the current page is the first child in the context of
+      a children:each tag
+      
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:unless_first >
+            ...
+        </r:unless_first>
+      </r:children:each>
+      </code></pre>"
+    children-each-unless_last: "Renders the tag contents unless the current page is the last child in the context of
+      a children:each tag
+      
+      *Usage:*
+      
+      <pre><code><r:children:each>
+        <r:unless_last >
+            ...
+        </r:unless_last>
+      </r:children:each>
+      </code></pre>"
+    children-each: "Cycles through each of the children. Inside this tag all page attribute tags
+      are mapped to the current child page.
+      
+      Supply @paginated=\"true\"@ to paginate the displayed list. will_paginate view helper
+      options can also be specified, including @per_page@, @previous_label@, @next_label@,
+      @class@, @separator@, @inner_window@ and @outer_window@.
+
+      *Usage:*
+      
+      <pre><code><r:children:each [offset=\"number\"] [limit=\"number\"]
+       [by=\"published_at|updated_at|created_at|slug|title|keywords|description\"]
+       [order=\"asc|desc\"] 
+       [status=\"draft|reviewed|published|hidden|all\"]
+       [paginated=\"true\"]
+       [per_page=\"number\"]
+       >
+       ...
+      </r:children:each>
+      </code></pre>"
+    children-first: "Returns the first child. Inside this tag all page attribute tags are mapped to
+      the first child. Takes the same ordering options as @<r:children:each>@.
+
+      *Usage:*
+      
+      <pre><code><r:children:first>...</r:children:first></code></pre>"
+    children-last: "Returns the last child. Inside this tag all page attribute tags are mapped to
+      the last child. Takes the same ordering options as @<r:children:each>@.
+
+      *Usage:*
+      
+      <pre><code><r:children:last>...</r:children:last></code></pre>"
+    children: "Gives access to a page's children.
+
+      *Usage:*
+      
+      <pre><code><r:children>...</r:children></code></pre>"
+    comment: "This is deprecated and will be removed. Plase use @<r:hide>@
+      Nothing inside a set of comment tags is rendered.
+
+      *Usage:*
+
+      <pre><code><r:comment>...</r:comment></code></pre>"
+    content: "Renders the main content of a page. Use the @part@ attribute to select a specific
+      page part. By default the @part@ attribute is set to body. Use the @inherit@
+      attribute to specify that if a page does not have a content part by that name that
+      the tag should render the parent's content part. By default @inherit@ is set to
+      @false@. Use the @contextual@ attribute to force a part inherited from a parent
+      part to be evaluated in the context of the child page. By default 'contextual'
+      is set to true.
+
+      *Usage:*
+      
+      <pre><code><r:content [part=\"part_name\"] [inherit=\"true|false\"] [contextual=\"true|false\"] /></code></pre>"
+    cycle: "Renders a counter value or one of the values given based on a global cycle counter. 
+      
+      To get a numeric counter just use the tag, or specify a start value with @start@.
+      Use the @reset@ attribute to reset the cycle to the beginning. Using @reset@ on a
+      numbered cycle will begin at 0. Use the @name@  attribute to track multiple cycles; 
+      the default is @cycle@.
+
+      *Usage:*
+      
+      <pre><code><r:cycle [values=\"first, second, third\"] [reset=\"true|false\"] [name=\"cycle\"] [start=\"second\"] /></code></pre>
+      <pre><code><r:cycle start=\"3\" /></code></pre>"
+    date: "Renders the date based on the current page (by default when it was published or created).
+      The format attribute uses the same formating codes used by the Ruby @strftime@ function. By
+      default it's set to @&#37;A, &#37;B &#37;d, &#37;Y@.  The @for@ attribute selects which date to render.  Valid
+      options are @published_at@, @created_at@, @updated_at@, and @now@. @now@ will render the
+      current date/time, regardless of the  page.
+
+      *Usage:*
+
+      <pre><code><r:date [format=\"&#37;A, &#37;B &#37;d, &#37;Y\"] [for=\"published_at\"]/></code></pre>"
+    escape_html: "Escapes angle brackets, etc. for rendering in an HTML document.
+
+      *Usage:*
+
+      <pre><code><r:escape_html>...</r:escape_html></code></pre>"
+    field: "Renders the content of the field given in the @name@ attribute.
+
+      *Usage:*
+
+      <pre><code><r:field name=\"Keywords\" /></code></pre>"
+    find: "Inside this tag all page related tags refer to the page found at the @path@ attribute.
+      @path@s may be relative or absolute paths.
+
+      *Usage:*
+
+      <pre><code><r:find path=\"value_to_find\">...</r:find></code></pre>"
+    gravatar: "Renders the Gravatar of the author of the current page or the named user.
+
+      *Usage:*
+
+      <pre><code><r:gravatar /></code></pre>
+
+      or
+
+      <pre><code><r:gravatar [name=\"User Name\"]
+            [rating=\"G | PG | R | X\"]
+            [size=\"32px\"] /></code></pre>"
+    hide: "Nothing inside a set of hide tags is rendered.
+
+      *Usage:*
+
+      <pre><code><r:hide>...</r:hide></code></pre>"
+    if_ancestor_or_self: "Renders the contained elements if the current contextual page is either the actual page or one of its parents.
+
+      This is typically used inside another tag (like &lt;r:children:each&gt;) to add conditional mark-up if the child element is or descends from the current page.
+
+      *Usage:*
+      
+      <pre><code><r:if_ancestor_or_self>...</r:if_ancestor_or_self></code></pre>"
+    if_children: "Renders the contained elements only if the current contextual page has one or
+      more child pages.  The @status@ attribute limits the status of found child pages
+      to the given status, the default is @\"published\"@. @status=\"all\"@ includes all
+      non-virtual pages regardless of status.
+
+      *Usage:*
+      
+      <pre><code><r:if_children [status=\"published\"]>...</r:if_children></code></pre>"
+    if_content: "Renders the containing elements if all of the listed parts exist on a page.
+      By default the @part@ attribute is set to @body@, but you may list more than one
+      part by separating them with a comma. Setting the optional @inherit@ to true will
+      search ancestors independently for each part. By default @inherit@ is set to @false@.
+
+      When listing more than one part, you may optionally set the @find@ attribute to @any@
+      so that it will render the containing elements if any of the listed parts are found.
+      By default the @find@ attribute is set to @all@.
+
+      *Usage:*
+      
+      <pre><code><r:if_content [part=\"part_name, other_part\"] [inherit=\"true\"] [find=\"any\"]>...</r:if_content></code></pre>"
+    if_dev: "Renders the containing elements only if Radiant in is development mode.
+
+      *Usage:*
+
+      <pre><code><r:if_dev>...</r:if_dev></code></pre>"
+    if_field: "Renders the contained elements if the field given in the @name@ attribute
+      exists. The tag also takes an optional @equals@ or @matches@ attribute;
+      these will expand the tag if the field's content equals or matches the
+      given string or regex.
+
+      *Usage:*
+
+      <pre><code><r:if_field name=\"author\" [equals|matches=\"John\"] [ignore_case=\"true|false\"]>...</r:if_field></code></pre>"
+    if_parent: "Renders the contained elements only if the current contextual page has a parent, i.e.
+      is not the root page.
+
+      *Usage:*
+      
+      <pre><code><r:if_parent>...</r:if_parent></code></pre>"
+    if_path: "Renders the containing elements only if the page's path matches the regular expression
+      given in the @matches@ attribute. If the @ignore_case@ attribute is set to false, the
+      match is case sensitive. By default, @ignore_case@ is set to true.
+
+      *Usage:*
+      
+      <pre><code><r:if_path matches=\"regexp\" [ignore_case=\"true|false\"]>...</r:if_path></code></pre>"
+    if_self: "Renders the contained elements if the current contextual page is also the actual page.
+
+      This is typically used inside another tag (like &lt;r:children:each&gt;) to add conditional mark-up if the child element is the current page.
+
+      *Usage:*
+      
+      <pre><code><r:if_self>...</r:if_self></code></pre>"
+    javascript: "Renders the content from or a reference to the javascript specified in the @slug@ 
+attribute. Additionally, the @as@ attribute can be used to make the tag render 
+as one of the following:
+
+* with no @as@ value the javascript's content is rendered by default.
+* @inline@ - wraps the javascript's content in an (X)HTML @<script>@ element.
+* @url@ - the full path to the javascript.
+* @link@ - embeds the url in an (X)HTML @<script>@ element (creating a link to the external javascript).
+
+*Additional Options:*
+When rendering @as=\"inline\"@ or @as=\"link\"@, the (X)HTML @type@ attribute
+is automatically be set to the default javascript content-type.
+You can overrride this attribute or add additional ones by passing extra
+attributes to the @<r:javascript>@ tag.
+        
+*Usage:*
+        
+<pre><code><r:javascript slug=\"site.css\" as=\"inline\" 
+  type=\"text/custom\" id=\"my_id\" />
+<r:javascript slug=\"other.js\" as=\"link\" /></code></pre>
+
+The above example will produce the following:
+        
+<pre><code>            <script type=\"text/custom\" id=\"my_id\">
+//<![CDATA[
+  var your_script = 'this content';
+//]]>
+</script>
+<script type=\"text/javascript\" src=\"/js/other.js\"></script></code></pre>"
+    link: "Renders a link to the page. When used as a single tag it uses the page's title
+      for the link name. When used as a double tag the part in between both tags will
+      be used as the link text. The link tag passes all attributes over to the HTML
+      @a@ tag. This is very useful for passing attributes like the @class@ attribute
+      or @id@ attribute. If the @anchor@ attribute is passed to the tag it will
+      append a pound sign (<code>#</code>) followed by the value of the attribute to
+      the @href@ attribute of the HTML @a@ tag--effectively making an HTML anchor.
+
+      *Usage:*
+
+      <pre><code><r:link [anchor=\"name\"] [other attributes...] /></code></pre>
+      
+      or
+      
+      <pre><code><r:link [anchor=\"name\"] [other attributes...]>link text here</r:link></code></pre>"
+    markdown: "Filters its contents with the Markdown filter.
+
+      *Usage:*
+
+      <pre><code><r:markdown>** bold text **</r:markdown></code></pre>
+
+      produces
+
+      <pre><code><strong> bold text </strong></code></pre>"
+    meta-description: "Emits the page description field in a meta tag, unless attribute
+      'tag' is set to 'false'.
+
+      *Usage:*
+
+      <pre><code> <r:meta:description [tag=\"false\"] /> </code></pre>"
+    meta-keywords: "Emits the page keywords field in a meta tag, unless attribute
+      'tag' is set to 'false'.
+
+      *Usage:*
+
+      <pre><code> <r:meta:keywords [tag=\"false\"] /> </code></pre>"
+    meta: "The namespace for 'meta' attributes.  If used as a singleton tag, both the description
+      and keywords fields will be output as &lt;meta /&gt; tags unless the attribute 'tag' is set to 'false'.
+
+      *Usage:*
+
+      <pre><code> <r:meta [tag=\"false\"] />
+       <r:meta>
+         <r:description [tag=\"false\"] />
+         <r:keywords [tag=\"false\"] />
+       </r:meta>
+      </code></pre>"
+    navigation-if_first: "Renders the containing elements if the element is the first
+      in the navigation list
+
+      *Usage:*
+
+      <pre><code><r:normal><r:if_first>...</r:if_first></r:normal></code></pre>"
+    navigation-if_last: "Renders the containing elements if the element is the last
+      in the navigation list
+
+      *Usage:*
+
+      <pre><code><r:normal><r:if_last>...</r:if_last></r:normal></code></pre>"
+    navigation-unless_first: "Renders the containing elements unless the element is the first
+      in the navigation list
+
+      *Usage:*
+
+      <pre><code><r:normal><r:unless_first>...</r:unless_first></r:normal></code></pre>"
+    navigation-unless_last: "Renders the containing elements unless the element is the last
+      in the navigation list
+
+      *Usage:*
+
+      <pre><code><r:normal><r:unless_last>...</r:unless_last></r:normal></code></pre>"
+    navigation: "Renders a list of links specified in the @paths@ attribute according to three
+      states:
+
+      * @normal@ specifies the normal state for the link
+      * @here@ specifies the state of the link when the path matches the current
+         page's PATH
+      * @selected@ specifies the state of the link when the current page matches
+         is a child of the specified path
+      # @if_last@ renders its contents within a @normal@, @here@ or
+        @selected@ tag if the item is the last in the navigation elements
+      # @if_first@ renders its contents within a @normal@, @here@ or
+        @selected@ tag if the item is the first in the navigation elements
+
+      The @between@ tag specifies what should be inserted in between each of the links.
+
+      *Usage:*
+
+      <pre><code><r:navigation paths=\"[Title: path | Title: path | ...]\">
+        <r:normal><a href=\"<r:path />\"><r:title /></a></r:normal>
+        <r:here><strong><r:title /></strong></r:here>
+        <r:selected><strong><a href=\"<r:path />\"><r:title /></a></strong></r:selected>
+        <r:between> | </r:between>
+      </r:navigation>
+      </code></pre>"
+    page: "Causes the tags referring to a page's attributes to refer to the current page.
+
+      *Usage:*
+      
+      <pre><code><r:page>...</r:page></code></pre>"
+    pagination: "The pagination tag is not usually called directly. Supply paginated=\"true\" when you display a list and it will
+      be automatically display only the current page of results, with pagination controls at the bottom.
+
+      *Usage:*
+      
+      <pre><code><r:children:each paginated=\"true\" per_page=\"50\" container=\"false\" previous_label=\"foo\" next_label=\"bar\">
+        <r:child>...</r:child>
+      </r:children:each>
+      </code></pre>"
+    parent: "Page attribute tags inside this tag refer to the parent of the current page.
+
+      *Usage:*
+      
+      <pre><code><r:parent>...</r:parent></code></pre>"
+    path: "Renders the @path@ attribute of the current page."
+    random: "Randomly renders one of the options specified by the @option@ tags.
+
+      *Usage:*
+
+      <pre><code><r:random>
+        <r:option>...</r:option>
+        <r:option>...</r:option>
+        ...
+      <r:random>
+      </code></pre>"
+    rfc1123_date: "Outputs the published date using the format mandated by RFC 1123. (Ideal for RSS feeds.)
+
+      *Usage:*
+
+      <pre><code><r:rfc1123_date /></code></pre>"
+    slug: "Renders the @slug@ attribute of the current page."
+    smarty_pants: "Filters its contents with the SmartyPants filter.
+
+      *Usage:*
+
+      <pre><code><r:smarty_pants>\"A revolutionary quotation.\"</r:smarty_pants></code></pre>
+
+      produces
+
+      <pre><code>&#8220;A revolutionary quotation.&#8221;</code></pre>"
+    snippet: "Renders the snippet specified in the @name@ attribute within the context of a page.
+
+      *Usage:*
+
+      <pre><code><r:snippet name=\"snippet_name\" /></code></pre>
+
+      When used as a double tag, the part in between both tags may be used within the
+      snippet itself, being substituted in place of @<r:yield/>@.
+
+      *Usage:*
+
+      <pre><code><r:snippet name=\"snippet_name\">Lorem ipsum dolor...</r:snippet></code></pre>"
+    status: "Prints the page's status as a string.  Optional attribute 'downcase'
+      will cause the status to be all lowercase.
+
+      *Usage:*
+
+      <pre><code><r:status [downcase='true'] /></code></pre>"
+    stylesheet: "Renders the content from or a reference to the stylesheet specified in the @slug@ 
+attribute. Additionally, the @as@ attribute can be used to make the tag render 
+as one of the following:
+
+* with no @as@ value the stylesheet's content is rendered by default.
+* @inline@ - wraps the stylesheet's content in an (X)HTML @<style>@ element.
+* @url@ - the full path to the stylesheet.
+* @link@ - embeds the url in an (X)HTML @<link>@ element (creating a link to the external stylesheet).
+
+*Additional Options:*
+When rendering @as=\"inline\"@ or @as=\"link\"@, the (X)HTML @type@ attribute
+is automatically be set to the default stylesheet content-type.
+You can overrride this attribute or add additional ones by passing extra
+attributes to the @<r:stylesheet>@ tag.
+        
+*Usage:*
+        
+<pre><code><r:stylesheet slug=\"site.css\" as=\"inline\" 
+  type=\"text/custom\" id=\"my_id\" />
+<r:stylesheet slug=\"other.css\" as=\"link\" 
+  rel=\"alternate stylesheet\" /></code></pre>
+
+The above example will produce the following:
+        
+<pre><code>            <style type=\"text/custom\" id=\"my_id\">
+/*<![CDATA[*/
+  .your_stylesheet { content: 'here' }
+/*]]>*/
+</style>
+<link rel=\"alternate stylesheet\" type=\"text/css\" 
+  href=\"/css/other.css\" /></code></pre>"
+    textile: "Filters its contents with the Textile filter.
+
+      *Usage*:
+
+      <pre><code><r:textile>
+      * First
+      * Second
+      </r:textile></code></pre>
+
+      produces:
+
+      <pre><code><ul>
+        <li>First</li>
+        <li>Second</li>
+      </ul></code></pre>"
+    title: "Renders the @title@ attribute of the current page."
+    unless_ancestor_or_self: "Renders the contained elements unless the current contextual page is either the actual page or one of its parents.
+
+      This is typically used inside another tag (like &lt;r:children:each&gt;) to add conditional mark-up unless the child element is or descends from the current page.
+
+      *Usage:*
+      
+      <pre><code><r:unless_ancestor_or_self>...</r:unless_ancestor_or_self></code></pre>"
+    unless_children: "Renders the contained elements only if the current contextual page has no children.
+      The @status@ attribute limits the status of found child pages to the given status,
+      the default is @\"published\"@. @status=\"all\"@ includes all non-virtual pages
+      regardless of status.
+
+      *Usage:*
+      
+      <pre><code><r:unless_children [status=\"published\"]>...</r:unless_children></code></pre>"
+    unless_content: "The opposite of the @if_content@ tag. It renders the contained elements if all of the
+      specified parts do not exist. Setting the optional @inherit@ to true will search
+      ancestors independently for each part. By default @inherit@ is set to @false@.
+
+      When listing more than one part, you may optionally set the @find@ attribute to @any@
+      so that it will not render the containing elements if any of the listed parts are found.
+      By default the @find@ attribute is set to @all@.
+
+      *Usage:*
+      
+      <pre><code><r:unless_content [part=\"part_name, other_part\"] [inherit=\"false\"] [find=\"any\"]>...</r:unless_content></code></pre>"
+    unless_dev: "The opposite of the @if_dev@ tag.
+
+      *Usage:*
+
+      <pre><code><r:unless_dev>...</r:unless_dev></code></pre>"
+    unless_field: "The opposite of @if_field@. Renders the contained elements unless the field
+      given in the @name@ attribute exists. The tag also takes an optional
+      @equals@ or @matches@ attribute; these will expand the tag unless the
+      field's content equals or matches the given string or regex.
+
+      *Usage:*
+
+      <pre><code><r:unless_field name=\"author\" [equals|matches=\"John\"] [ignore_case=\"true|false\"]>...</r:unless_field></code></pre>"
+    unless_parent: "Renders the contained elements only if the current contextual page has no parent, i.e.
+      is the root page.
+
+      *Usage:*
+      
+      <pre><code><r:unless_parent>...</r:unless_parent></code></pre>"
+    unless_path: "The opposite of the @if_path@ tag.
+
+      *Usage:*
+      
+      <pre><code><r:unless_path matches=\"regexp\" [ignore_case=\"true|false\"]>...</r:unless_path></code></pre>"
+    unless_self: "Renders the contained elements unless the current contextual page is also the actual page.
+
+      This is typically used inside another tag (like &lt;r:children:each&gt;) to add conditional mark-up unless the child element is the current page.
+
+      *Usage:*
+
+      <pre><code><r:unless_self>...</r:unless_self></code></pre>"
+    yield: "Used within a snippet as a placeholder for substitution of child content, when
+      the snippet is called as a double tag.
+
+      *Usage (within a snippet):*
+      
+      <pre><code>
+      <div id=\"outer\">
+        <p>before</p>
+        <r:yield/>
+        <p>after</p>
+      </div>
+      </code></pre>
+
+      If the above snippet was named \"yielding\", you could call it from any Page,
+      Layout or Snippet as follows:
+
+      <pre><code><r:snippet name=\"yielding\">Content within</r:snippet></code></pre>
+
+      Which would output the following:
+
+      <pre><code>
+      <div id=\"outer\">
+        <p>before</p>
+        Content within
+        <p>after</p>
+      </div>
+      </code></pre>
+
+      When called in the context of a Page or a Layout, @<r:yield/>@ outputs nothing."