breeze_cms 0.9.5

data/app/views/breeze/view/_section_slider.haml

@@ -0,0 +1,51 @@
+%section{ options(section , :background , :margin), id: section.type_id}
+  -unless( section.header_text(current_lang).blank?)
+    .flex{ options(section , :item_align )}
+      .px-4.py-4.md:py-10.lg:py-16.mx-5.md:mx-12.lg:mx-20{options(section , :text_align , :text_color)}
+        %h1.section_header.text-2xl.font-bold.tracking-tight.sm:text-4xl
+          = section.header_text(current_lang)
+        -if section.has_option?("subheader")
+          %h4.text-xl.mt-10.md:text-2xl
+            = section.option("subheader")
+        .section_text.mt-4.text-lg.pt-10{ prose_classes }
+          = markdown(section,current_lang)
+        =view_button(section , "my-2")
+  .swiper
+    .swiper-wrapper
+      - template = "breeze/view/cards/" + section.card_template
+      - section.cards.each do |card|
+        .swiper-slide{ column_option(section)}
+          = render( template , card: card)
+
+    .swiper-pagination
+    .swiper-button-prev
+    .swiper-button-next
+
+%script{:src => "https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"}
+
+:javascript
+  var breaks = #{slider_columns_option(section).to_json};
+  document.addEventListener("DOMContentLoaded", function(event) {
+    const swiper = new Swiper('.swiper', {
+      loop: true,
+      speed: 1500,
+      breakpoints: breaks ,
+      autoplay: true,
+      pagination: {
+        el: '.swiper-pagination',
+      },
+      navigation: {
+        nextEl: '.swiper-button-next',
+        prevEl: '.swiper-button-prev',
+      },
+    });
+  });
+
+  var head = document.getElementsByTagName("head")[0];
+  cssLink = document.createElement("link");
+  cssLink.href = "https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css";
+  cssLink.rel="stylesheet";
+  cssLink.id="dynamic-css";
+  cssLink.media="screen";
+  cssLink.type="text/css";
+  head.appendChild(cssLink);

data/app/views/breeze/view/_section_small_image.haml

@@ -0,0 +1,11 @@
+.flex.justify-center.flex-col.lg:flex-row{options(section , :margin , :background ), id: section.type_id}
+  .flex.justify-center.h-60.w-full.overflow-hidden{order_option(section, "lg:w-1/3")}
+    = image_for(section ,"object-cover")
+  .columns-1.md:columns-2.max-w-full.items-center.w-full.max-w.px-6.mx-auto.mt-6.lg:mt-0{text_color_option(section, "lg:w-2/3")}
+    %h2.section_header.text-4xl.font-bold.text-left.mb-4.lg:mb-8{text_align_option(section)}= section.header_text(current_lang)
+    -if section.has_option?("subheader")
+      %h4.text-xl.mt-4.lg:mt-8.md:text-2xl{text_align_option(card)}
+        = section.option("subheader")
+    .section_text.mt-3{ prose_classes }
+      = markdown(section,current_lang)
+    =view_button(section , "my-2")

data/app/views/breeze/view/_section_spacer.haml

@@ -0,0 +1 @@
+.h-24

data/app/views/breeze/view/_section_text.haml

@@ -0,0 +1,17 @@
+%section.p-20.my-20{ options(section , :background , :text_color , :margin), id: section.type_id}
+  .flex.justify-center
+    .max-w-prose{ options(section , :text_align)}
+      - if !section.header_text(current_lang).blank?
+        %h1.section_header.mb-10.text-2xl.font-bold.tracking-tight.sm:text-4xl
+          = section.header_text(current_lang)
+      -if section.has_option?("subheader")
+        .section_text.text-xl.pb-6{ prose_classes }
+          = section.option("subheader")
+
+  .max-w-full.mt-4.gap-16{ options(section , :text_columns , :prose ) }
+    = markdown_image(section,current_lang)
+    - if section.has_option?("button_text") and section.has_option?("button_link")
+      %span.block.transition.group-hover:translate-x-1
+        %a.text-gray-800.transition{:class => "hover:text-gray-500", :href => "#{section.option("button_link")}"}
+          = section.option("button_text")
+          →

data/app/views/breeze/view/cards/_card_feature_box.haml

@@ -0,0 +1,13 @@
+.m-3.relative.p-px.overflow-hidden.transition.duration-300.transform.border.rounded.shadow-sm.hover:scale-105.group.hover:shadow-xl{ id: card.type_id}
+  .absolute.bottom-0.left-0.w-full.h-1.duration-300.origin-left.transform.scale-x-0.bg-deep-purple-accent-400.group-hover:scale-x-100
+  .absolute.bottom-0.left-0.w-1.h-full.duration-300.origin-bottom.transform.scale-y-0.bg-deep-purple-accent-400.group-hover:scale-y-100
+  .absolute.top-0.left-0.w-full.h-1.duration-300.origin-right.transform.scale-x-0.bg-deep-purple-accent-400.group-hover:scale-x-100
+  .absolute.bottom-0.right-0.w-1.h-full.duration-300.origin-top.transform.scale-y-0.bg-deep-purple-accent-400.group-hover:scale-y-100
+  .relative.p-5.bg-white.rounded-sm
+    .flex.flex-col.mb-2.lg:items-center.lg:flex-row
+      .flex.items-center.justify-center.w-16.h-16.mb-4.mr-2.rounded-full.lg:mb-0{options(card,:background )}
+        = image_for( card , "h-8 w-8")
+      %h6.card_header.font-semibold.leading-5{options(card, :text_color)}= card.header_text(current_lang)
+    .card_text.mb-2.text-sm.text-gray-900{ prose_classes }
+      = markdown(card,current_lang)
+    .text-center=view_button(card , "mb-2")

data/app/views/breeze/view/cards/_card_feature_normal.haml

@@ -0,0 +1,7 @@
+.max-w-md.sm:mx-auto.sm:text-center{ id: card.type_id}
+  .mt-4.flex.items-center.justify-center.mb-4.rounded-full.mx-auto.w-40.h-40{options(card,:background )}
+    = image_for( card , "h-20 w-20")
+  %h4.card_header.mb-3.text-xl.font-bold.leading-5{options(card, :text_color)}= card.header_text(current_lang)
+  .card_text.mb-3.text-sm.text-gray-900{ prose_classes }
+    = markdown(card,current_lang)
+  =view_button(card , "mb-2")

data/app/views/breeze/view/cards/_card_full_image.haml

@@ -0,0 +1,10 @@
+.group.m-8.overflow-hidden.relative.flex.h-96.items-end{ id: card.type_id}
+  = image_for( card , "absolute inset-0 h-full w-full object-cover hover:scale-110 ease-in duration-700")
+  .relative.w-full.m-2.p-4.tracking-widest{text_align_option(card ,"sm:w-1/2")}
+    -unless card.header_text(current_lang).blank? and card.text.blank?
+      %div.transition-colors.group-hover:bg-black.group-hover:text-white{options(card , :text_align , :text_color , :background)}
+        .relative.w-full.m-2.p-4
+          %h3.card_header.text-lg
+            = card.header_text(current_lang)
+          .card_text.mt-1.text-xs.font-medium{ prose_classes }
+            = markdown(card,current_lang)

data/app/views/breeze/view/cards/_card_gap_square.haml

@@ -0,0 +1,11 @@
+.grid.grid-cols-1.gap-4.md:gap-8.lg:gap-12{ id: card.type_id}
+  %div{ order_option(card)}
+    = image_for( card , "h-full w-full object-cover")
+  .grid.h-70{options(card , :text_align , :text_color , :background )}
+    %h3.card_header.p-4.mt-10.text-3xl.font-bold= card.header_text(current_lang)
+    -if card.has_option?("subheader")
+      %h4.p-4.text-xl= card.option("subheader")
+    .m-6{options(card , :background , :text_color ) }
+      .card_text{ prose_classes }
+        = markdown(card,current_lang)
+      =view_button(card , "my-2")

data/app/views/breeze/view/cards/_card_large_image.haml

@@ -0,0 +1,6 @@
+.flex.justify-center.flex-col{options(card , :background) , id: card.type_id}
+  .flex.justify-center.overflow-hidden
+    = image_for(card)
+  .flex.justify-center.w-full.max-w.px-6.my-4{options(card , :text_align , :text_color)}
+    %h2.card_header.text-4xl.font-bold.text-center= card.header_text(current_lang)
+    .card_text.ml-10.text-center= card.text_text(current_lang)

data/app/views/breeze/view/cards/_card_normal_round.haml

@@ -0,0 +1,8 @@
+.fex.flex-col.overflow-hidden.rounded-lg.border.border-gray-100.shadow-sm{ id: card.type_id}
+  = image_for( card ,  class: "h-full w-full object-cover")
+  %h3.card_header.p-5.text-2xl.bg-gray-100.text-black.font-bold{ text_align_option(card)}= card.header_text(current_lang)
+  %div.h-full{background_option(card)}
+    .p-5{options(card , :text_align , :text_color)}
+      .card_text.m-2.text-sm.leading-relaxed.line-clamp-3{ prose_classes }
+        = markdown(card,current_lang)
+      =view_button(card , "my-2")

data/app/views/breeze/view/cards/_card_normal_square.haml

@@ -0,0 +1,9 @@
+.flex.flex-col.justify-between{background_option(card), id: card.type_id}
+  %div{ order_option(card , "align-bottom")}
+    = image_for( card , "h-full w-full object-cover")
+  .m-6{options(card , :text_align , :text_color )}
+    %h3.card_header.p-4.text-2xl.font-bold= card.header_text(current_lang)
+    -if card.has_option?("subheader")
+      %h4.p-4.text-xl= card.option("subheader")
+    .card_text.mt-2.p-4{prose_classes}= markdown(card,current_lang)
+    =view_button(card)

data/app/views/breeze/view/cards/_card_wide_square.haml

@@ -0,0 +1,8 @@
+.flex.flex-col.lg:flex-row{background_option(card), id: card.type_id}
+  = image_for( card , "object-cover lg:w-3/5")
+  .ml-0.lg:ml-10.mt-6.lg:mt0{options(card , :text_align , :text_color , :order , "lg:w-2/5")}
+    %h3.card_header.text-2xl.font-bold= card.header_text(current_lang)
+    -if card.has_option?("subheader")
+      %h4.py-4.text-xl= card.option("subheader")
+    .card_text.py-4{prose_classes}= markdown(card,current_lang)
+    =view_button(card , "mb-2")

data/app/views/breeze/view/cards/_form_field.haml

@@ -0,0 +1,8 @@
+-if card.option("form_type") == "message"
+  .relative.z-0.col-span-2.mt-3
+    %textarea.peer.block.w-full.appearance-none.border-0.border-b.border-gray-500.bg-transparent.px-0.text-sm.text-gray-900.focus:border-blue-600.focus:outline-none.focus:ring-0{:class => "py-2.5", :name => card.header_text(current_lang) , :placeholder => " ", :rows => "5"}=params[card.header_text(current_lang)]
+    %label.absolute.top-3.-z-10.-translate-y-6.scale-75.transform.text-sm.text-gray-500.duration-300.peer-placeholder-shown:translate-y-0.peer-placeholder-shown:scale-100.peer-focus:left-0.peer-focus:-translate-y-6.peer-focus:scale-75.peer-focus:text-blue-600.peer-focus:dark:text-blue-500{:class => "origin-[0]"}= card.header_text(current_lang)
+-else
+  .relative.z-0.mt-3
+    %input.peer.block.w-full.appearance-none.border-0.border-b.border-gray-500.bg-transparent.px-0.text-sm.text-gray-900.focus:border-blue-600.focus:outline-none.focus:ring-0{:class => "py-2.5", :name => card.header_text(current_lang), :placeholder => " " , "value" => params[card.header_text(current_lang)], :type => "text"}
+    %label.absolute.top-3.-z-10.-translate-y-6.scale-75.transform.text-sm.text-gray-500.duration-300.peer-placeholder-shown:translate-y-0.peer-placeholder-shown:scale-100.peer-focus:left-0.peer-focus:-translate-y-6.peer-focus:scale-75.peer-focus:text-blue-600.peer-focus:dark:text-blue-500{:class => "origin-[0]"}= card_field_name(card)

data/app/views/breeze/view/elements/_button.haml

@@ -0,0 +1,4 @@
+- if section.has_option?("button_text") and section.has_option?("button_link")
+  = link_to section.option("button_link") do
+    .mr-3.inline-block.rounded-lg.px-4.py-3.text-md.font-medium.border.border-gray-400.bg-green-700.hover:bg-blue-800
+      = section.option("button_text")

data/app/views/breeze/view/page.haml

@@ -0,0 +1,2 @@
+- @page.sections.each do |section|
+  = render_section( section )

data/app/views/layouts/breeze/_header.haml

@@ -0,0 +1,37 @@
+.flex.mx-6.md:mx-12.mx-20.my-6.h-16.justify-between
+  .flex.items-center.gap-16
+    %a{:href => "/"}
+      %span.sr-only Home
+      =image_tag("breeze/home" , class: "h-10")
+    %a{:href => "/breeze/pages"}
+      %span.sr-only Breeze Home
+      =image_tag("breeze/breeze_logo" , class: "h-10")
+
+    %ul.flex.items-center.gap-6.text-lg
+      %li
+        %a.text-gray-500.transition{:class => "hover:text-gray-500/75", :href => breeze.pages_path}
+          Pages
+      %li
+        %a.text-gray-500.transition{:class => "hover:text-gray-500/75", :href => breeze.images_path}
+          Images
+      %li
+        %a.text-gray-500.transition{:class => "hover:text-gray-500/75", :href => breeze.styles_index_path}
+          Styles
+      %li
+        %a.text-gray-500.transition{:class => "hover:text-gray-500/75", :href => breeze.changes_index_path}
+          Changes
+      -if ENV['WARNING']
+        %li.ml-20
+          %a.bg-red-200.rounded.p-2{ href: "/"}
+            This is a read only version of breeze. Click to go back to the documentation
+
+  .flex.items-center.gap-16
+    = link_to breeze.changes_index_path do
+      %button.my-3.button{class: last_change_class}= last_change_text
+
+    - if main_app.respond_to? :destroy_member_session_path
+      = form_tag( main_app.destroy_member_session_path , {method: :delete  } ) do
+        %button.flex.w-full.items-center.gap-2.rounded-lg.px-4.py-2.text-sm.text-blue-700.hover:bg-red-50{:role => "menuitem", :type => "submit"}
+          %svg.h-4.w-4{:fill => "none", :stroke => "currentColor", "stroke-width" => "2", :viewbox => "0 0 24 24", :xmlns => "http://www.w3.org/2000/svg"}
+            %path{:d => "M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16", "stroke-linecap" => "round", "stroke-linejoin" => "round"}
+          Sign out

data/app/views/layouts/breeze/_messages.haml

@@ -0,0 +1,28 @@
+-if flash.alert
+  #flash
+    .m-20.rounded.border-l-4.border-red-500.bg-red-50.p-4{:role => "alert"}
+      %strong.block.font-medium.text-red-700 Oops
+      %p.mt-2.text-sm.text-red-700
+        =flash.alert
+
+-if flash.notice
+  #flash
+    .m-20.rounded-xl.border.border-gray-100.p-4.shadow-xl{:role => "alert"}
+      .flex.items-start.gap-4
+        %span.text-green-600
+          %svg.h-6.w-6{:fill => "none", :stroke => "currentColor", "stroke-width" => "1.5", :viewbox => "0 0 24 24", :xmlns => "http://www.w3.org/2000/svg"}
+            %path{:d => "M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z", "stroke-linecap" => "round", "stroke-linejoin" => "round"}
+        .flex-1
+          %strong.block.font-medium.text-gray-900 Ok
+          %p.mt-1.text-sm.text-gray-700
+            = flash.notice
+:javascript
+  function hideNotice() {
+    const notification = document.querySelector('#flash')
+    if (notification) {
+      setInterval(function() {
+        notification.classList.add('hidden');
+      }, 5000);
+    }
+  }
+  hideNotice();

data/app/views/layouts/breeze/application.haml

@@ -0,0 +1,20 @@
+!!!
+%html
+  %head
+    %meta{:content => "text/html; charset=UTF-8", "http-equiv" => "Content-Type"}/
+    %title Breeze CMS
+    %meta{:content => "width=device-width,initial-scale=1", :name => "viewport"}/
+    = csrf_meta_tags
+    = csp_meta_tag
+    = stylesheet_link_tag "tailwind"
+    = stylesheet_link_tag "breeze/breeze"
+
+    = javascript_include_tag "breeze_application"
+
+    - if false
+      %script{:src => "https://cdn.tailwindcss.com"}
+
+  %body
+    = render "layouts/breeze/header"
+    = render "layouts/breeze/messages"
+    = yield

data/app/views/layouts/mailer.html.haml

@@ -0,0 +1,8 @@
+!!!
+%html
+  %head
+    %meta{:content => "text/html; charset=utf-8", "http-equiv" => "Content-Type"}/
+    %style
+      = Rails.application.assets_manifest.find_sources('breeze/breeze.email.css').first.to_s.html_safe
+  %body
+    = yield

data/app/views/layouts/mailer.text.erb

@@ -0,0 +1 @@
+<%= yield %>

data/config/breeze/card_styles.yml

@@ -0,0 +1,129 @@
+---
+- :template: card_full_image
+  :header: Full background
+  :text: Text in box on top of the imag. Adjustable background
+          and text color to mix/match with images. Box is fixed height.
+          Images can be wide or square, for 2 column 800 wide,
+          3 column 600 , 4 column 400
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+- :template: card_large_image
+  :header: Image as is
+  :text: Image as is, ie no sizing
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+- :template: card_gap_square
+  :header: Narrow card with up down section
+  :text: Smaller image, large margins, possible subheader
+      Order turns it upside down, image bottom
+      Images can be wide or square, for 2 column 800 wide,
+      3 column 600 , 4 column 400
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - order
+    - text_align
+    - subheader
+- :template: card_normal_square
+  :header: Standard card with square image
+  :text: Image, header, text, normal stuff. No margin between image and text.
+        Possible subheader. Text alignment option. Also option to turn upside
+        down with order.
+        Images can be wide or square, for 2 column 800 wide,
+        3 column 600 , 4 column 400
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+    - subheader
+    - order
+    - button_link
+    - button_text
+- :template: card_wide_square
+  :header: Sideway card with square image
+  :text: Much like standard square card, just turned sideways.
+    Works best for 2 or three columns. Wide pictures, unless there is a lot of text.
+    Images can be wide or square, for 2 column 600 wide,
+    3 columns 400
+
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+    - subheader
+    - order
+    - button_link
+    - button_text
+- :template: card_feature_normal
+  :header: Card looking feature
+  :text: For things where no image is available or apropriate.
+        Making lists a little more interesting to look at.
+        May use svg as image, or normal with transparent bg.
+        Small images or icons.
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+    - button_link
+    - button_text
+- :template: card_feature_box
+  :header: Feature card with box
+  :text: For things where no image is available or apropriate.
+        Making lists a little more interesting to look at.
+        May use svg as image.
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+    - button_link
+    - button_text
+- :template: card_normal_round
+  :header: Standard card with rounded look
+  :text: Otherwise quite similar to standard. But there is gap under the image.
+        Images can be wide or square, for 2 column 800 wide,
+        3 column 600 , 4 column 400
+
+  :fields:
+    - header
+    - text
+  :options:
+    - background
+    - text_color
+    - text_align
+    - button_link
+    - button_text
+- :template: form_field
+  :header: A single field in a form
+  :text: The header is the Name of the field, the description
+        serves as a placeholder. (No image)
+  :fields:
+    - header
+    - text
+  :options:
+    - compulsory
+    - form_type

data/config/breeze/option_definitions.yml

@@ -0,0 +1,129 @@
+---
+- :name: fixed
+  :description: Paralax effect where background stays fixed during scrolling
+  :values: on off
+  :default: false
+  :id: 1
+- :name: columns
+  :description: Number of columns in a layout that supports cards
+  :values: 1 2 3 4 5 6
+  :default: 3
+  :id: 2
+- :name: background
+  :description: Background colors. Light colors stay with black text. Solid colors
+    invert to white text.
+  :values: white none light_blue light_gray light_orange solid_blue solid_red solid_indigo
+  :default: none
+  :id: 3
+- :name: text_color
+  :description: Text colors. Don't use with solid background colors. Same colors as
+    background available. Default none, meas as parent.
+  :values: none white black light_blue light_gray solid_black solid_blue solid_red
+    solid_indigo
+  :default: none
+  :id: 4
+- :name: shade_color
+  :description: Color of transparent shaded area. The number means transparency.
+  :values: none black_25 white_25 light_red_25 light_blue_25 solid_blue_25 solid_red_25
+  :default: none
+  :id: 5
+- :name: text_align
+  :description: Align text of children. Normal Word meaning
+  :values: left center right
+  :default: center
+  :id: 6
+- :name: order
+  :description: For two column layout determine order of sub-cards Values of left
+    and right usually refer to where the image is For cards it can also mean up and
+    down
+  :values: left right
+  :default: left
+  :id: 7
+- :name: margin
+  :description: Most sections have standard margin of 20. This option makes it possible
+    to remove that
+  :values: none small medium large
+  :default: large
+  :id: 8
+- :name: button_text
+  :description: Text for an optional button. Must also set button_link
+  :values:
+  :default:
+  :id: 9
+- :name: subheader
+  :description: Smaller header between Header and text
+  :values:
+  :default:
+  :id: 10
+- :name: text
+  :description: Second text. Just a second paragraph
+  :values:
+  :default:
+  :id: 11
+- :name: button_link
+  :description: Link for an option button. Must also set button_text. Link must be
+    a page name, ie only internal links allowed.
+  :values:
+  :default:
+  :id: 12
+- :name: compulsory
+  :description: Form fields may be compulsory or not. By default they are.
+  :values: yes no
+  :default: false
+  :id: 13
+- :name: form_type
+  :description: Form fields may have a type for special handling. The default is text
+    but message would be a longer text, and email checked to be a name.
+  :values: text message email phone date
+  :default: text
+  :id: 14
+- :name: ok_message
+  :description: Message shown to the user when a form was submitted
+  :values:
+  :default:
+  :id: 15
+- :name: handler
+  :description: Form handler
+  :values: FormHandler
+  :default: FormHandler
+  :id: 16
+- :name: item_align
+  :description: Alignment of actual children. Usually some kind of boxes.
+          Does not affect text, see text_align
+  :values: left center right
+  :default: center
+  :id: 17
+- :name: meta
+  :description: Meta tag for page
+  :values:
+  :default:
+  :id: 18
+- :name: published_date
+  :description: Date when the blog is published
+  :type: date
+  :values:
+  :default:
+  :id: 19
+- :name: date_precision
+  :description: Either the axact day, or something like in the middle
+                of October, or the end of December
+  :values: precise rough
+  :default: precise
+  :id: 20
+- :name: image_align
+  :description: Alignment of images. This affect what stays visible
+      on different size screens. Default is center, but if the focus
+      of the image is left or right, that may be choosen.
+  :values: left-top left left-bottom top center bottom right-top right right-bottom
+  :default: center
+  :id: 21
+- :name: text_columns
+  :description: Number of text columns in a newspaper style layout
+  :values: 2 3 4 5
+  :default: 3
+  :id: 22
+- :name: slider_columns
+  :description: Number of slide columns in a slider
+  :values: 1 2 3 4
+  :default: 1
+  :id: 23

data/config/breeze/page_styles.yml

@@ -0,0 +1,12 @@
+---
+- :type: page
+  :description: A general page, may contain anykind of section.
+        No restrictions of any kind. No options either.
+  :options:
+    - meta
+- :type: blog
+  :description: An news or similar article.
+  :section_template: blog_header
+  :options:
+    - published_date
+    - date_precision