pageflow 15.7.1 → 16.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (201) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +33 -243
  3. data/README.md +1 -9
  4. data/Rakefile +4 -1
  5. data/admins/pageflow/accounts.rb +12 -16
  6. data/admins/pageflow/entry.rb +57 -28
  7. data/admins/pageflow/entry_templates.rb +5 -7
  8. data/admins/pageflow/sites.rb +50 -0
  9. data/admins/pageflow/user.rb +7 -0
  10. data/app/assets/javascripts/pageflow/admin/entries.js +53 -4
  11. data/app/assets/stylesheets/pageflow/admin/permalink_input.scss +65 -0
  12. data/app/assets/stylesheets/pageflow/admin.scss +1 -0
  13. data/app/assets/stylesheets/pageflow/editor/base.scss +2 -6
  14. data/app/assets/stylesheets/pageflow/editor/dialogs.scss +2 -0
  15. data/app/assets/stylesheets/pageflow/editor/drop_down_button.scss +9 -0
  16. data/app/assets/stylesheets/pageflow/editor/info_box.scss +13 -3
  17. data/app/assets/stylesheets/pageflow/mixins/buttons.scss +1 -0
  18. data/app/assets/stylesheets/pageflow/page.scss +0 -2
  19. data/app/assets/stylesheets/pageflow/themes/default/page.scss +1 -1
  20. data/app/assets/stylesheets/pageflow/ui/forms.scss +4 -1
  21. data/app/controllers/pageflow/editor/file_import_controller.rb +32 -42
  22. data/app/controllers/pageflow/entries_controller.rb +27 -3
  23. data/app/helpers/pageflow/admin/permalinks_helper.rb +15 -0
  24. data/app/helpers/pageflow/common_entry_seed_helper.rb +1 -1
  25. data/app/helpers/pageflow/embed_code_helper.rb +1 -1
  26. data/app/helpers/pageflow/entries_helper.rb +25 -17
  27. data/app/helpers/pageflow/sites_helper.rb +11 -0
  28. data/app/helpers/pageflow/social_share_helper.rb +2 -2
  29. data/app/inputs/pageflow_permalink_input.rb +47 -0
  30. data/app/models/concerns/pageflow/permalinkable.rb +12 -0
  31. data/app/models/concerns/pageflow/reusable_file.rb +5 -0
  32. data/app/models/concerns/pageflow/uploadable_file.rb +4 -0
  33. data/app/models/pageflow/account.rb +7 -33
  34. data/app/models/pageflow/{cname_theming_request_scope.rb → cname_site_request_scope.rb} +3 -3
  35. data/app/models/pageflow/customized_theme.rb +5 -3
  36. data/app/models/pageflow/entry.rb +8 -4
  37. data/app/models/pageflow/entry_at_revision.rb +4 -3
  38. data/app/models/pageflow/entry_duplicate.rb +8 -1
  39. data/app/models/pageflow/entry_template.rb +4 -4
  40. data/app/models/pageflow/home_button.rb +7 -7
  41. data/app/models/pageflow/image_file_url_templates.rb +2 -2
  42. data/app/models/pageflow/permalink.rb +39 -0
  43. data/app/models/pageflow/permalink_directory.rb +10 -0
  44. data/app/models/pageflow/published_entry.rb +19 -2
  45. data/app/models/pageflow/revision.rb +1 -1
  46. data/app/models/pageflow/site.rb +59 -0
  47. data/app/models/pageflow/theme_customization.rb +1 -1
  48. data/app/models/pageflow/theme_customization_file.rb +6 -1
  49. data/app/policies/pageflow/account_policy.rb +2 -2
  50. data/app/policies/pageflow/entry_policy.rb +2 -2
  51. data/app/policies/pageflow/entry_template_policy.rb +1 -1
  52. data/app/policies/pageflow/{theming_policy.rb → site_policy.rb} +13 -11
  53. data/app/views/admin/accounts/_entry_template_details.html.arb +1 -1
  54. data/app/views/admin/accounts/_form.html.erb +4 -22
  55. data/app/views/admin/accounts/_site_defaults_inline_help.html.erb +5 -0
  56. data/app/views/admin/entries/_form.html.erb +11 -12
  57. data/app/views/admin/entries/_permalink_inputs.html.erb +6 -0
  58. data/app/views/admin/entries/_site_input.html.erb +15 -0
  59. data/app/views/admin/entries/{entry_type_name_input.html.erb → entry_site_and_type_name_input.html.erb} +3 -0
  60. data/app/views/admin/entries/permalink_inputs.html.erb +7 -0
  61. data/app/views/admin/entry_templates/_form.html.erb +5 -5
  62. data/app/views/admin/sites/_attributes_table.html.arb +9 -0
  63. data/app/views/admin/sites/_fields.html.erb +17 -0
  64. data/app/views/admin/sites/_form.html.erb +5 -0
  65. data/app/views/components/pageflow/admin/entries_tab.rb +1 -2
  66. data/app/views/components/pageflow/admin/entry_templates_tab.rb +10 -11
  67. data/app/views/components/pageflow/admin/features_tab.rb +1 -1
  68. data/app/views/components/pageflow/admin/sites_tab.rb +32 -0
  69. data/app/views/components/pageflow/admin/users_tab.rb +1 -2
  70. data/app/views/pageflow/editor/entries/seed.json.erb +1 -1
  71. data/app/views/pageflow/editor/file_import/start_import_job.json.jbuilder +10 -0
  72. data/app/views/pageflow/editor/sites/_site.json.jbuilder +1 -0
  73. data/app/views/pageflow/entries/{_theming.css.erb → _site.css.erb} +0 -0
  74. data/app/views/pageflow/entries/stylesheet.css.erb +1 -1
  75. data/app/views/pageflow/files/_file.json.jbuilder +1 -0
  76. data/app/views/pageflow/social_share/_entry_meta_tags.html.erb +1 -1
  77. data/app/views/pageflow/social_share/_page_meta_tags.html.erb +1 -1
  78. data/config/initializers/admin_resource_tabs.rb +29 -12
  79. data/config/initializers/mime_types.rb +1 -0
  80. data/config/locales/de.yml +19 -17
  81. data/config/locales/en.yml +19 -17
  82. data/config/routes.rb +8 -5
  83. data/db/migrate/20221024100724_create_pageflow_permalink_directories.rb +10 -0
  84. data/db/migrate/20221025074049_add_permalink_attributes_to_entries.rb +5 -0
  85. data/db/migrate/20221027065022_create_pageflow_permalinks.rb +12 -0
  86. data/db/migrate/20221215101134_rename_theming_to_site.rb +9 -0
  87. data/db/migrate/20221215120856_associate_entry_templates_with_sites.rb +34 -0
  88. data/db/migrate/20221219203023_add_name_to_sites.rb +5 -0
  89. data/db/migrate/20230103155934_associate_theme_customizations_with_sites.rb +27 -0
  90. data/entry_types/paged/app/assets/javascripts/pageflow_paged/dist/editor.js +176 -179
  91. data/entry_types/paged/app/assets/javascripts/pageflow_paged/dist/frontend.js +49 -7
  92. data/entry_types/paged/app/assets/javascripts/pageflow_paged/dist/react-client.js +5 -5
  93. data/entry_types/paged/app/assets/javascripts/pageflow_paged/dist/react-server.js +1 -1
  94. data/entry_types/paged/config/initializers/features.rb +2 -0
  95. data/entry_types/paged/config/locales/{new/help.de.yml → de.yml} +74 -65
  96. data/entry_types/paged/config/locales/{new/help.en.yml → en.yml} +66 -56
  97. data/entry_types/scrolled/app/helpers/pageflow_scrolled/favicon_helper.rb +39 -13
  98. data/entry_types/scrolled/app/helpers/pageflow_scrolled/generated_media_queries_helper.rb +55 -0
  99. data/entry_types/scrolled/app/helpers/pageflow_scrolled/themes_helper.rb +6 -2
  100. data/entry_types/scrolled/app/views/pageflow_scrolled/editor/entries/_head.html.erb +2 -0
  101. data/entry_types/scrolled/app/views/pageflow_scrolled/entries/_manifest.json.jbuilder +16 -0
  102. data/entry_types/scrolled/app/views/pageflow_scrolled/entries/show.html.erb +9 -3
  103. data/entry_types/scrolled/app/views/pageflow_scrolled/entry_json_seed/_entry.json.jbuilder +5 -5
  104. data/entry_types/scrolled/app/views/pageflow_scrolled/favicons/_entry.html.erb +16 -10
  105. data/entry_types/scrolled/config/locales/de.yml +265 -76
  106. data/entry_types/scrolled/config/locales/en.yml +266 -77
  107. data/entry_types/scrolled/lib/pageflow_scrolled/configuration.rb +3 -3
  108. data/entry_types/scrolled/lib/pageflow_scrolled/plugin.rb +14 -0
  109. data/entry_types/scrolled/lib/pageflow_scrolled/react_widget_type.rb +1 -1
  110. data/entry_types/scrolled/lib/pageflow_scrolled/seeds.rb +1 -1
  111. data/entry_types/scrolled/lib/pageflow_scrolled/web_app_manifest.rb +11 -0
  112. data/entry_types/scrolled/lib/pageflow_scrolled.rb +39 -1
  113. data/entry_types/scrolled/lib/tasks/pageflow_scrolled/storybook.rake +3 -2
  114. data/entry_types/scrolled/package/contentElements-editor.js +124 -38
  115. data/entry_types/scrolled/package/contentElements-frontend.css +1 -1
  116. data/entry_types/scrolled/package/contentElements-frontend.js +321 -27
  117. data/entry_types/scrolled/package/editor.js +1345 -739
  118. data/entry_types/scrolled/package/frontend/EditableInlineText.module-14c7b097.js +5314 -0
  119. data/entry_types/scrolled/package/frontend/{PhonePlatformContext-9fb97827.js → PhonePlatformContext-f6093cc6.js} +87 -223
  120. data/entry_types/scrolled/package/frontend/{Viewer-e2290ea0.js → Viewer-b6becc57.js} +6 -40
  121. data/entry_types/scrolled/package/frontend/arrowRight-78a7cee4.js +42 -0
  122. data/entry_types/scrolled/package/frontend/{components-6ab26015.js → components-b3160dd7.js} +546 -361
  123. data/entry_types/scrolled/package/frontend/index.css +1 -1
  124. data/entry_types/scrolled/package/frontend/index.js +398 -3692
  125. data/entry_types/scrolled/package/package.json +3 -2
  126. data/entry_types/scrolled/package/testHelpers.js +12 -2
  127. data/entry_types/scrolled/package/widgets/defaultNavigation.css +2 -2
  128. data/entry_types/scrolled/package/widgets/defaultNavigation.js +50 -40
  129. data/entry_types/scrolled/spec/fixtures/image.ico +0 -0
  130. data/lib/pageflow/ability_mixin.rb +16 -8
  131. data/lib/pageflow/admin/attributes_table_rows.rb +1 -1
  132. data/lib/pageflow/admin/form_inputs.rb +1 -1
  133. data/lib/pageflow/admin/tabs.rb +1 -1
  134. data/lib/pageflow/configuration/permissions.rb +3 -3
  135. data/lib/pageflow/configuration.rb +17 -17
  136. data/lib/pageflow/entry_export_import/entry_serialization.rb +1 -1
  137. data/lib/pageflow/entry_type.rb +6 -2
  138. data/lib/pageflow/primary_domain_entry_redirect.rb +7 -7
  139. data/lib/pageflow/seeds.rb +10 -10
  140. data/lib/pageflow/theme_customizations.rb +10 -10
  141. data/lib/pageflow/version.rb +1 -1
  142. data/package/editor.js +129 -156
  143. data/package/frontend.js +19 -2
  144. data/package/testHelpers.js +39 -6
  145. data/spec/factories/accounts.rb +5 -2
  146. data/spec/factories/draft_entries.rb +2 -2
  147. data/spec/factories/entries.rb +18 -1
  148. data/spec/factories/entry_templates.rb +1 -1
  149. data/spec/factories/permalink_directory.rb +6 -0
  150. data/spec/factories/permalinks.rb +4 -0
  151. data/spec/factories/published_entries.rb +4 -2
  152. data/spec/factories/sites.rb +9 -0
  153. metadata +50 -62
  154. data/app/assets/javascripts/pageflow/dist/editor.js +0 -11890
  155. data/app/assets/javascripts/pageflow/dist/frontend.js +0 -5800
  156. data/app/assets/javascripts/pageflow/dist/react-client.js +0 -22
  157. data/app/assets/javascripts/pageflow/dist/react-server.js +0 -19
  158. data/app/helpers/pageflow/themings_helper.rb +0 -11
  159. data/app/models/pageflow/theming.rb +0 -29
  160. data/app/views/admin/accounts/_theming_defaults_inline_help.html.erb +0 -5
  161. data/app/views/admin/accounts/_theming_details.html.arb +0 -5
  162. data/app/views/pageflow/editor/themings/_theming.json.jbuilder +0 -1
  163. data/entry_types/paged/config/locales/new/video_contain.de.yml +0 -7
  164. data/entry_types/paged/config/locales/new/video_contain.en.yml +0 -7
  165. data/entry_types/scrolled/config/locales/new/before_after_slider.de.yml +0 -8
  166. data/entry_types/scrolled/config/locales/new/before_after_slider.en.yml +0 -8
  167. data/entry_types/scrolled/config/locales/new/center_ragged.de.yml +0 -8
  168. data/entry_types/scrolled/config/locales/new/center_ragged.en.yml +0 -9
  169. data/entry_types/scrolled/config/locales/new/consent.de.yml +0 -25
  170. data/entry_types/scrolled/config/locales/new/consent.en.yml +0 -24
  171. data/entry_types/scrolled/config/locales/new/content_element_categories.de.yml +0 -39
  172. data/entry_types/scrolled/config/locales/new/content_element_categories.en.yml +0 -39
  173. data/entry_types/scrolled/config/locales/new/default_transition.de.yml +0 -14
  174. data/entry_types/scrolled/config/locales/new/default_transition.en.yml +0 -14
  175. data/entry_types/scrolled/config/locales/new/header_line_breaks.de.yml +0 -28
  176. data/entry_types/scrolled/config/locales/new/header_line_breaks.en.yml +0 -27
  177. data/entry_types/scrolled/config/locales/new/header_size.de.yml +0 -17
  178. data/entry_types/scrolled/config/locales/new/header_size.en.yml +0 -17
  179. data/entry_types/scrolled/config/locales/new/iframe_embed.de.yml +0 -39
  180. data/entry_types/scrolled/config/locales/new/iframe_embed.en.yml +0 -39
  181. data/entry_types/scrolled/config/locales/new/inline_loops.de.yml +0 -26
  182. data/entry_types/scrolled/config/locales/new/inline_loops.en.yml +0 -26
  183. data/entry_types/scrolled/config/locales/new/portrait_inline_image.de.yml +0 -9
  184. data/entry_types/scrolled/config/locales/new/portrait_inline_image.en.yml +0 -9
  185. data/entry_types/scrolled/config/locales/new/section_width.de.yml +0 -10
  186. data/entry_types/scrolled/config/locales/new/section_width.en.yml +0 -10
  187. data/entry_types/scrolled/config/locales/new/typography_variants.de.yml +0 -7
  188. data/entry_types/scrolled/config/locales/new/typography_variants.en.yml +0 -7
  189. data/entry_types/scrolled/config/locales/new/video_embed_poster.de.yml +0 -8
  190. data/entry_types/scrolled/config/locales/new/video_embed_poster.en.yml +0 -8
  191. data/entry_types/scrolled/config/locales/new/waveform_styles.de.yml +0 -11
  192. data/entry_types/scrolled/config/locales/new/waveform_styles.en.yml +0 -12
  193. data/entry_types/scrolled/config/locales/new/widgets.de.yml +0 -6
  194. data/entry_types/scrolled/config/locales/new/widgets.en.yml +0 -6
  195. data/entry_types/scrolled/lib/generators/pageflow_scrolled/install/templates/theme/favicons/browserconfig.xml +0 -9
  196. data/entry_types/scrolled/lib/generators/pageflow_scrolled/install/templates/theme/favicons/mstile-150x150.png +0 -0
  197. data/entry_types/scrolled/lib/generators/pageflow_scrolled/install/templates/theme/favicons/safari-pinned-tab.svg +0 -46
  198. data/entry_types/scrolled/lib/generators/pageflow_scrolled/install/templates/theme/favicons/site.webmanifest +0 -19
  199. data/entry_types/scrolled/package/frontend/EditableInlineText.module-b9923660.js +0 -993
  200. data/entry_types/scrolled/package/frontend/usePhonePlatform-2857c22b.js +0 -34
  201. data/spec/factories/themings.rb +0 -7
@@ -1,6 +1,8 @@
1
1
  Pageflow.configure do |config|
2
2
  config.for_entry_type(PageflowPaged.entry_type) do |entry_type_config|
3
3
  entry_type_config.features.register('highdef_background_images')
4
+ entry_type_config.features.register('force_best_video_quality')
5
+ entry_type_config.features.register('force_fullhd_video_quality')
4
6
 
5
7
  entry_type_config.features.register('auto_change_page')
6
8
  entry_type_config.features.register('delayed_text_fade_in')
@@ -1,62 +1,33 @@
1
1
  de:
2
+ pageflow:
3
+ force_best_video_quality:
4
+ feature_name: Höchste Video Qualität erzwingen
5
+ force_fullhd_video_quality:
6
+ feature_name: FullHD Video Qualität erzwingen
7
+ video:
8
+ page_attributes:
9
+ smart_contain:
10
+ inline_help: Video skalieren, um die Darstellung von schwarzen Balken oben und unten (Letterboxing) bzw. rechts und links (Pillarboxing) zu vermeiden, wenn das Seitenverhältnis des Videos nur leicht vom Seitenverhältnis des Browser-Viewports abweicht.
11
+ label: Letterboxing/Pillarboxing vermeiden
2
12
  pageflow_paged:
3
13
  help_entries:
4
- overview:
5
- menu_item: Übersicht
6
- text: |
7
- # Übersicht
8
-
9
- Dies ist der Editor zum Bearbeiten eines Pageflows. Mit
10
- seiner Zweiteilung ermöglicht er die direkte Vorschau
11
- während der Bearbeitung, zeigt Änderungen am Text oder neu
12
- ausgewählte Dateien unmittelbar an und speichert diese
13
- automatisch.
14
-
15
- Die Seitenleiste kann durch einen Klick auf den Anfasser zur
16
- Größenänderung ein- und ausgeblendet werden. Mit einem
17
- Verschieben der Seitenleiste nach links und rechts kannst Du
18
- die Größe des Vorschaufensters verändern. Wird das
19
- Vorschaufenster schmal, und somit eher zu einem hochkantigen
20
- Mobiltelefon-Format gestaucht, wird aus Platzgründen statt
21
- der Navigationsleiste nur das Icon „Übersicht“ angezeigt.
22
-
23
- Die Navigation des Editors ist unterteilt in die vier
24
- Bereiche:
25
-
26
- ## Titel und Optionen
27
-
28
- Unter „Titel und Optionen“ kannst Du grundsätzliche
29
- Parameter des Erscheinungsbildes, sowie Titel, Sprache,
30
- Impressum etc. einstellen. Dazu können Texte festgelegt
31
- werden, die beim Teilen des Beitrags über Social Media
32
- Dienste angezeigt werden sollen.
33
-
34
- Details findest Du unter: [Titel und Optionen](#pageflow_paged.help_entries.meta_data)
14
+ atmo:
15
+ menu_item: Atmo Audio
16
+ text: |-
17
+ # Atmo Audio
35
18
 
36
- ## Dateien verwalten
19
+ Mit der „Atmo“ kann jede Seite, unabhängig vom Seitentyp, im Hintergrund Sound abspielen. Dabei kannst Du bestimmen, ob ein Sound nur auf einer Seite zu hören ist oder über mehrere Seiten ohne Unterbrechung läuft. Wähle dazu einfach für die benachbarten Seiten die selbe Audiodatei als Atmo aus.
37
20
 
38
- Unter „Dateien verwalten“ lädst Du die Mediendateien hoch,
39
- die im Pageflow verwendet werden sollen. Du kannst hier auch
40
- bereits hochgeladene Videos, Fotos und Audios
41
- wiederverwenden.
21
+ Auf diese Weise lassen sich Kapitel akustisch voneinander absetzen und zusammenhängende Seiten stärker verweben.
42
22
 
43
- Details findest Du unter: [Dateien verwalten](#pageflow.help_entries.files)
23
+ Beim Seitentyp Video kann zusätzlich ausgwählt werden, ob der Hintergrundsound während der Video-Wiedergabe normal oder leiser weitergespielt oder ganz ausgeblendet werden soll.
44
24
 
45
- ## Gliederung
25
+ Die Einstellung der Atmo-Sounds erreichst du bei jeder Seite über den Reiter „Optionen“.
46
26
 
47
- Über die „Gliederung“ kannst Du Kapitel und Seiten
48
- hinzufügen, also die eigentlichen Inhalte bearbeiten. Per
49
- Drag&Drop lassen sich Seiten und Kapitel auch jederzeit
50
- umsortieren.
27
+ Sollte Dich die Atmo während der Bearbeitung Deines Beitrags im Editor einmal stören, kannst Du sie mit der Tastenkombination „Alt + a“ vorübergehend stumm schalten. Um die Atmo wieder zu aktivieren, drücke einfach erneut „Alt + a“.
51
28
 
52
- Details findest Du unter: [Kapitel und Seiten](#pageflow_paged.help_entries.outline)
29
+ **ACHTUNG:** Atmo-Audios können aufgrund technischer Einschränkungen der Browserhersteller auf mobilen Geräten und mit Safari auf Desktop nicht wiedergegeben werden.
53
30
  meta_data:
54
- menu_item: Titel und Optionen
55
- text: |
56
- # Titel und Optionen
57
-
58
- Allgemeine Einstellungen für den Beitrag. Bitte einen
59
- Unterpunkt auf der linken Seite auswählen.
60
31
  appearance:
61
32
  menu_item: Erscheinungsbild
62
33
  text: |
@@ -111,6 +82,12 @@ de:
111
82
 
112
83
  ## Theme
113
84
  Lege ein Font-Template für den Beitrag fest.
85
+ menu_item: Titel und Optionen
86
+ text: |
87
+ # Titel und Optionen
88
+
89
+ Allgemeine Einstellungen für den Beitrag. Bitte einen
90
+ Unterpunkt auf der linken Seite auswählen.
114
91
  outline:
115
92
  menu_item: Kapitel und Seiten
116
93
  text: |
@@ -137,26 +114,58 @@ de:
137
114
  sich Pageflow, als ob keine Kapitelstruktur vorhanden
138
115
  ist. (Kapitel und Kapiteltitel werden in diesem Falle nicht
139
116
  in der Übersicht bzw. Navigation dargestellt).
117
+ overview:
118
+ menu_item: Übersicht
119
+ text: |
120
+ # Übersicht
140
121
 
141
- storylines:
142
- menu_item: Erzählstränge
143
- text: "# Erzählstränge\n\nErgänzend zur linearen Erzählung von „oben nach unten“, können auch weitere (non-lineare) Erzählstränge als Exkurse zu vertiefenden Inhalten genutzt werden. \n\nIn diesem [Blogartikel](https://www.pageflow.io/neues-pageflow-update) findest Du ein Beispiel.\n\nMit „Erzählstrang“ ist hier die zusammenhängende Kapitel- und Seitenabfolge gemeint, durch die ein User hindurch scrollt. Zu unterscheiden ist zwischen dem sogenannten Haupterzählstrang, in dem ein User zu Beginn eines Pageflows einsteigt, und weiteren untergeordneten Erzählsträngen. \n\nUm vom Haupterzählstrang einen Abzweig zu erstellen, benutze eine „Verweise“-Seite (Mosaik, Collage oder Hotspot) und lege auf der jeweiligen Seite unter „Verweise“ die entsprechenden Verknüpfungen an. \n\nDabei kann durch das Festlegen einer „übergeordneten Seite“ bestimmt werden, zu welcher Seite der User am Ende des Erzählstrangs gelangt.\n\nOptisch unterstützt werden diese Exkurse in untergeordnete Erzählstränge durch einen horizontalen Seitenübergangseffekt, der beim Eintreten und Verlassen dieser Stränge automatisch eingestellt ist. \n\nErstellt werden diese Erzählstränge in der Gliederung über ein Klick auf die Plus-Schaltfläche neben der Erzählstrang-Auswahl. Dabei öffnet sich automatisch ein neues Kapitel, in dem dann weitere Seiten angelegt werden können.\n\n\n### Übergeordnete Seiten\n\nIn jedem Untererzählstrang muss eine „Übergeordnete Seite“ festgelegt werden, die bestimmt, wohin ein User beim zurück-scrollen gelangt. Mit einem Klick auf das Stift-Symbol neben der Erzählstrang-Auswahl kann diese Zielseite ausgewählt werden. Durch die Auswahl einer übergeordneten Seite erscheint auf allen Seiten eines untergeordneten Erzählstrangs zudem automatisch ein „Zurück“-Button, der zu der übergeordneten Seite führt. \n\n\n### Kapitel-Hierarchie\n\nDurch die Verwendung mehrerer „untergeordneter“ Erzählstränge und der Festlegung von übergeordneten Seiten ergibt sich eine Kapitelhierarchie, wie man sie auch von Buch-Gliederungen kennt:\n\n1. (Hauptstrang), 1.1 (Übergeordneter Unterstrang), 1.1.1 (vertiefende Seite im übergeordneten Unterstrang) und so weiter.\n\nDiese Hierarchie kann nachträglich in der Erzählstrang-Auswahl über ein Klick auf Stift-Symbol geändert werden. Ein untergeordneter Erzählstrang kann an dieser Stelle zudem auch nachträglich zum Haupt-Erzählstrang umsortiert werden.\n\n\n### Scroll-Nachfolger\n\nFalls der User von der letzten Seite eines Unterkapitels (1.1.1) auf eine andere Stelle im Beitrag geleitet werden soll (z.B. 2.1), kann hierzu ebenfalls über das Stiftsymbol in den Erzählstrang-Einstellungen der sogenannte „Scroll-Nachfolger“ festgelegt werden. Um in dem Beispiel zu bleiben wäre der folgende Ablauf denkbar: 1 -> 1.1 -> 1.1.1 -> 2.1\n\nAchtung: Während des Editierens wird immer nur das aktuell ausgewählte Kapitel angezeigt. Um zu den anderen Erzählsträngen zu gelangen klicke auf das Auswahlmenü „Erzählstrang“."
144
- page_options:
145
- menu_item: Allgemeine Seitenoptionen
146
- text: "# Allgemeine Seitenoptionen\n\n### Titel\n\nHier gibst Du den Titel der jeweiligen Seite ein. Dieser\nwird nicht nur als Überschrift des Fliesstextes der Seite\nausgespielt, sondern dient zudem als Titel innerhalb der\nNavigation und der Übersicht. Wird eine einzelne Seite in\nsozialen Netzwerken geteilt, ist dieser Titel zugleich auch\nder Titel des Social Media-Beitrages.\n\n### Titel ausblenden\n\nOptional lässt sich der Titel auch ausblenden. Das heisst:\nEr wird nicht mehr als Überschrift im Fliesstext\nangezeigt. Er bleibt zur Identifikation einer Seite\nallerdings in Navigation, Übersicht und geteilten Beträgen\nerhalten.\n\n### Tagline und Untertitel\n\nHier kann wahlweise eine Tagline und/oder ein Untertitel\neingegeben werden. Falls Du ein Häkchen bei „Titel\nausblenden“ gesetzt hast, sind Tagline und Untertitel über\ndem Fliesstext ebenfalls nicht zu sehen.\n\n### Text\n\nDer Textblock kann mit den Buttons unterhalb des\nEingabefeldes formatiert werden. [ B=Fett / I=kursiv /\nU=unterstrichen „gekippte acht“=Link/URL auf fremde Seite\neinfügen].\n\nAlle Änderungen sind in der linken Frontend-Ansicht\nsichtbar, sobald das entsprechende Texteingabefeld im\nEditierbereich verlassen wurde.\n\n### Textposition\n\nWähle hier, ob der Text auf der linken oder rechten Seite\nangezeigt wird.\n\n### Intensität der Abblendung\n\nDie Intensität des Farbverlaufs dient der Lesbarkeit von\nTexten auf Videos oder Bildern.\n\nDurch den Schieberegler kann der Bildhintergrund so stark\nabgedunkelt bzw. aufgehellt werden, bis der Kontrast\nzwischen Bild und Text ausreichend ist.\n\n### Farben invertieren\n\nBeim Invertieren werden „hell“ und „dunkel“ vertauscht, die\nsonst weiße Schrift ändert sich dabei automatisch in\nschwarz.\n\nGrundsätzlich gilt: Helle Schrift für dunkle Bilder, dunkle\nSchrift für helle Bilder.\n\n### Thumbnail\n\nDas Thumbnail ersetzt das ansonsten automatisch generierte\nVorschaubild in der Navigation und in der Übersicht.\n\n### In Navigationsleiste anzeigen\n\nIst diese Option nicht gesetzt, wird die jeweilige Seite\nnicht in der Navigation repräsentiert, kann also nicht\ndirekt über die Navigation erreicht werden.\n\nDies bietet sich vor allem für Seiten an, die inhaltlich als\n„Unterseiten“ einer anderen Seite anzusehen sind.\n\n### Übergangseffekt\n\nEs gibt verschiedene Effekte, die sichtbar sind, wenn von einer Kapitelseite zur nächsten gescrollt oder geklickt wird. Zur Auswahl stehen Seitenübergänge, wie „Überblendung“, „Schwarzblende“ oder „Harter Schnitt“ die sich vertikal auswirken, zudem kann auch „Horizontal Scrollen“ von rechts oder links ausgewählt werden. \n\nWelcher Effekt verwendet wird, kann unter „Optionen“ individuell für jede Seite festgelegt werden.\n\n### Text verzögert einblenden\n\nBestimme mit dieser Option, ob Text und Abblendung mit zeitlicher Verzögerung angezeigt werden.\nHierbei sehen User zunächst nur den Hintergrund, dann erscheinen Titel, Tagline und Untertitel und mit minimaler Verzögerung schließlich der Fließtext.\n\nInsgesamt stehen drei Verzögerungslängen zur Verfügung: kurz = 1 Sekunde, mittel = 3 Sekunde, lang = 5 Sekunde.\n\nDieses Feature eignet sich zum Beispiel für Intros oder Kapitelanfänge.\n\n### Beschreibung für Übersicht\n\nHier kann der Text eingegeben werden, der angezeigt wird,\nwenn der User in der Übersicht mit der Mouse über die\njeweilige Seite fährt. Außerdem entspricht der hier\neingegebene Text"
147
- atmo:
148
- menu_item: Atmo Audio
149
- text: |-
150
- # Atmo Audio
122
+ Dies ist der Editor zum Bearbeiten eines Pageflows. Mit
123
+ seiner Zweiteilung ermöglicht er die direkte Vorschau
124
+ während der Bearbeitung, zeigt Änderungen am Text oder neu
125
+ ausgewählte Dateien unmittelbar an und speichert diese
126
+ automatisch.
151
127
 
152
- Mit der „Atmo“ kann jede Seite, unabhängig vom Seitentyp, im Hintergrund Sound abspielen. Dabei kannst Du bestimmen, ob ein Sound nur auf einer Seite zu hören ist oder über mehrere Seiten ohne Unterbrechung läuft. Wähle dazu einfach für die benachbarten Seiten die selbe Audiodatei als Atmo aus.
128
+ Die Seitenleiste kann durch einen Klick auf den Anfasser zur
129
+ Größenänderung ein- und ausgeblendet werden. Mit einem
130
+ Verschieben der Seitenleiste nach links und rechts kannst Du
131
+ die Größe des Vorschaufensters verändern. Wird das
132
+ Vorschaufenster schmal, und somit eher zu einem hochkantigen
133
+ Mobiltelefon-Format gestaucht, wird aus Platzgründen statt
134
+ der Navigationsleiste nur das Icon „Übersicht“ angezeigt.
153
135
 
154
- Auf diese Weise lassen sich Kapitel akustisch voneinander absetzen und zusammenhängende Seiten stärker verweben.
136
+ Die Navigation des Editors ist unterteilt in die vier
137
+ Bereiche:
155
138
 
156
- Beim Seitentyp Video kann zusätzlich ausgwählt werden, ob der Hintergrundsound während der Video-Wiedergabe normal oder leiser weitergespielt oder ganz ausgeblendet werden soll.
139
+ ## Titel und Optionen
157
140
 
158
- Die Einstellung der Atmo-Sounds erreichst du bei jeder Seite über den Reiter „Optionen“.
141
+ Unter „Titel und Optionen“ kannst Du grundsätzliche
142
+ Parameter des Erscheinungsbildes, sowie Titel, Sprache,
143
+ Impressum etc. einstellen. Dazu können Texte festgelegt
144
+ werden, die beim Teilen des Beitrags über Social Media
145
+ Dienste angezeigt werden sollen.
159
146
 
160
- Sollte Dich die Atmo während der Bearbeitung Deines Beitrags im Editor einmal stören, kannst Du sie mit der Tastenkombination „Alt + a“ vorübergehend stumm schalten. Um die Atmo wieder zu aktivieren, drücke einfach erneut „Alt + a“.
147
+ Details findest Du unter: [Titel und Optionen](#pageflow_paged.help_entries.meta_data)
161
148
 
162
- **ACHTUNG:** Atmo-Audios können aufgrund technischer Einschränkungen der Browserhersteller auf mobilen Geräten und mit Safari auf Desktop nicht wiedergegeben werden.
149
+ ## Dateien verwalten
150
+
151
+ Unter „Dateien verwalten“ lädst Du die Mediendateien hoch,
152
+ die im Pageflow verwendet werden sollen. Du kannst hier auch
153
+ bereits hochgeladene Videos, Fotos und Audios
154
+ wiederverwenden.
155
+
156
+ Details findest Du unter: [Dateien verwalten](#pageflow.help_entries.files)
157
+
158
+ ## Gliederung
159
+
160
+ Über die „Gliederung“ kannst Du Kapitel und Seiten
161
+ hinzufügen, also die eigentlichen Inhalte bearbeiten. Per
162
+ Drag&Drop lassen sich Seiten und Kapitel auch jederzeit
163
+ umsortieren.
164
+
165
+ Details findest Du unter: [Kapitel und Seiten](#pageflow_paged.help_entries.outline)
166
+ page_options:
167
+ menu_item: Allgemeine Seitenoptionen
168
+ text: "# Allgemeine Seitenoptionen\n\n### Titel\n\nHier gibst Du den Titel der jeweiligen Seite ein. Dieser\nwird nicht nur als Überschrift des Fliesstextes der Seite\nausgespielt, sondern dient zudem als Titel innerhalb der\nNavigation und der Übersicht. Wird eine einzelne Seite in\nsozialen Netzwerken geteilt, ist dieser Titel zugleich auch\nder Titel des Social Media-Beitrages.\n\n### Titel ausblenden\n\nOptional lässt sich der Titel auch ausblenden. Das heisst:\nEr wird nicht mehr als Überschrift im Fliesstext\nangezeigt. Er bleibt zur Identifikation einer Seite\nallerdings in Navigation, Übersicht und geteilten Beträgen\nerhalten.\n\n### Tagline und Untertitel\n\nHier kann wahlweise eine Tagline und/oder ein Untertitel\neingegeben werden. Falls Du ein Häkchen bei „Titel\nausblenden“ gesetzt hast, sind Tagline und Untertitel über\ndem Fliesstext ebenfalls nicht zu sehen.\n\n### Text\n\nDer Textblock kann mit den Buttons unterhalb des\nEingabefeldes formatiert werden. [ B=Fett / I=kursiv /\nU=unterstrichen „gekippte acht“=Link/URL auf fremde Seite\neinfügen].\n\nAlle Änderungen sind in der linken Frontend-Ansicht\nsichtbar, sobald das entsprechende Texteingabefeld im\nEditierbereich verlassen wurde.\n\n### Textposition\n\nWähle hier, ob der Text auf der linken oder rechten Seite\nangezeigt wird.\n\n### Intensität der Abblendung\n\nDie Intensität des Farbverlaufs dient der Lesbarkeit von\nTexten auf Videos oder Bildern.\n\nDurch den Schieberegler kann der Bildhintergrund so stark\nabgedunkelt bzw. aufgehellt werden, bis der Kontrast\nzwischen Bild und Text ausreichend ist.\n\n### Farben invertieren\n\nBeim Invertieren werden „hell“ und „dunkel“ vertauscht, die\nsonst weiße Schrift ändert sich dabei automatisch in\nschwarz.\n\nGrundsätzlich gilt: Helle Schrift für dunkle Bilder, dunkle\nSchrift für helle Bilder.\n\n### Thumbnail\n\nDas Thumbnail ersetzt das ansonsten automatisch generierte\nVorschaubild in der Navigation und in der Übersicht.\n\n### In Navigationsleiste anzeigen\n\nIst diese Option nicht gesetzt, wird die jeweilige Seite\nnicht in der Navigation repräsentiert, kann also nicht\ndirekt über die Navigation erreicht werden.\n\nDies bietet sich vor allem für Seiten an, die inhaltlich als\n„Unterseiten“ einer anderen Seite anzusehen sind.\n\n### Übergangseffekt\n\nEs gibt verschiedene Effekte, die sichtbar sind, wenn von einer Kapitelseite zur nächsten gescrollt oder geklickt wird. Zur Auswahl stehen Seitenübergänge, wie „Überblendung“, „Schwarzblende“ oder „Harter Schnitt“ die sich vertikal auswirken, zudem kann auch „Horizontal Scrollen“ von rechts oder links ausgewählt werden. \n\nWelcher Effekt verwendet wird, kann unter „Optionen“ individuell für jede Seite festgelegt werden.\n\n### Text verzögert einblenden\n\nBestimme mit dieser Option, ob Text und Abblendung mit zeitlicher Verzögerung angezeigt werden.\nHierbei sehen User zunächst nur den Hintergrund, dann erscheinen Titel, Tagline und Untertitel und mit minimaler Verzögerung schließlich der Fließtext.\n\nInsgesamt stehen drei Verzögerungslängen zur Verfügung: kurz = 1 Sekunde, mittel = 3 Sekunde, lang = 5 Sekunde.\n\nDieses Feature eignet sich zum Beispiel für Intros oder Kapitelanfänge.\n\n### Beschreibung für Übersicht\n\nHier kann der Text eingegeben werden, der angezeigt wird,\nwenn der User in der Übersicht mit der Mouse über die\njeweilige Seite fährt. Außerdem entspricht der hier\neingegebene Text"
169
+ storylines:
170
+ menu_item: Erzählstränge
171
+ text: "# Erzählstränge\n\nErgänzend zur linearen Erzählung von „oben nach unten“, können auch weitere (non-lineare) Erzählstränge als Exkurse zu vertiefenden Inhalten genutzt werden. \n\nIn diesem [Blogartikel](https://www.pageflow.io/neues-pageflow-update) findest Du ein Beispiel.\n\nMit „Erzählstrang“ ist hier die zusammenhängende Kapitel- und Seitenabfolge gemeint, durch die ein User hindurch scrollt. Zu unterscheiden ist zwischen dem sogenannten Haupterzählstrang, in dem ein User zu Beginn eines Pageflows einsteigt, und weiteren untergeordneten Erzählsträngen. \n\nUm vom Haupterzählstrang einen Abzweig zu erstellen, benutze eine „Verweise“-Seite (Mosaik, Collage oder Hotspot) und lege auf der jeweiligen Seite unter „Verweise“ die entsprechenden Verknüpfungen an. \n\nDabei kann durch das Festlegen einer „übergeordneten Seite“ bestimmt werden, zu welcher Seite der User am Ende des Erzählstrangs gelangt.\n\nOptisch unterstützt werden diese Exkurse in untergeordnete Erzählstränge durch einen horizontalen Seitenübergangseffekt, der beim Eintreten und Verlassen dieser Stränge automatisch eingestellt ist. \n\nErstellt werden diese Erzählstränge in der Gliederung über ein Klick auf die Plus-Schaltfläche neben der Erzählstrang-Auswahl. Dabei öffnet sich automatisch ein neues Kapitel, in dem dann weitere Seiten angelegt werden können.\n\n\n### Übergeordnete Seiten\n\nIn jedem Untererzählstrang muss eine „Übergeordnete Seite“ festgelegt werden, die bestimmt, wohin ein User beim zurück-scrollen gelangt. Mit einem Klick auf das Stift-Symbol neben der Erzählstrang-Auswahl kann diese Zielseite ausgewählt werden. Durch die Auswahl einer übergeordneten Seite erscheint auf allen Seiten eines untergeordneten Erzählstrangs zudem automatisch ein „Zurück“-Button, der zu der übergeordneten Seite führt. \n\n\n### Kapitel-Hierarchie\n\nDurch die Verwendung mehrerer „untergeordneter“ Erzählstränge und der Festlegung von übergeordneten Seiten ergibt sich eine Kapitelhierarchie, wie man sie auch von Buch-Gliederungen kennt:\n\n1. (Hauptstrang), 1.1 (Übergeordneter Unterstrang), 1.1.1 (vertiefende Seite im übergeordneten Unterstrang) und so weiter.\n\nDiese Hierarchie kann nachträglich in der Erzählstrang-Auswahl über ein Klick auf Stift-Symbol geändert werden. Ein untergeordneter Erzählstrang kann an dieser Stelle zudem auch nachträglich zum Haupt-Erzählstrang umsortiert werden.\n\n\n### Scroll-Nachfolger\n\nFalls der User von der letzten Seite eines Unterkapitels (1.1.1) auf eine andere Stelle im Beitrag geleitet werden soll (z.B. 2.1), kann hierzu ebenfalls über das Stiftsymbol in den Erzählstrang-Einstellungen der sogenannte „Scroll-Nachfolger“ festgelegt werden. Um in dem Beispiel zu bleiben wäre der folgende Ablauf denkbar: 1 -> 1.1 -> 1.1.1 -> 2.1\n\nAchtung: Während des Editierens wird immer nur das aktuell ausgewählte Kapitel angezeigt. Um zu den anderen Erzählsträngen zu gelangen klicke auf das Auswahlmenü „Erzählstrang“."
@@ -1,55 +1,33 @@
1
1
  en:
2
+ pageflow:
3
+ force_best_video_quality:
4
+ feature_name: Force best video quality
5
+ force_fullhd_video_quality:
6
+ feature_name: Force FullHD video quality
7
+ video:
8
+ page_attributes:
9
+ smart_contain:
10
+ inline_help: Scale video to prevent displaying black bars above and below it (letterboxing) or on the left and right (pillarboxing) when the aspect ratio of the video only deviates slightly from the aspect ratio of the browser viewport.
11
+ label: Avoid letterboxing/pillarboxing
2
12
  pageflow_paged:
3
13
  help_entries:
4
- overview:
5
- menu_item: Overview
14
+ atmo:
15
+ menu_item: Atmo Audio
6
16
  text: |-
7
- # Overview
8
-
9
- This is Pageflow’s editing platform. The division of the
10
- screen into two allows you to edit your Pageflow and see a
11
- preview at the same time. The editor shows modifications and
12
- newly selected files directly and saves them automatically.
13
-
14
- The sidebar can be hidden or shown. You can change the size
15
- of the preview-window by pulling the sidebar to the right or
16
- the left. If the preview-window is long and narrow like ´ a
17
- smartphone, you will only be able to see the „overview“ icon
18
- and not the entire navigation. This is due to lack of space.
19
-
20
- The navigation is divided into four parts:
21
-
22
- ## Title and Options
23
-
24
- Under „Title and Options“ you can set up basic appearance
25
- parameters as well as the title, language and legal
26
- notice. You can also decide which content should be
27
- displayed when sharing the report on social media platforms.
28
-
29
- For more details see: [Title and Options](#pageflow_paged.help_entries.meta_data)
17
+ # Atmo Audio
30
18
 
31
- ## Manage Files
19
+ This feature lets you add background audio to every page regardless of its page type. You can define if a sound should play only for one page or continue playing for more pages without interruption. Simply select the same atmo audio file for some adjacent pages.
32
20
 
33
- Under „Manage Files“ you can upload your media files, which
34
- you want to use in Pageflow. Furthermore you can reuse
35
- videos, photos and audio-files that have already been
36
- uploaded.
21
+ That way chapters can be seperated acoustically and pages that belong together can be weaved to a stronger unit.
37
22
 
38
- For more details see: [Manage Files](#pageflow.help_entries.files)
23
+ For the page type „Video“ there is a special option to pause background audio or continue at lower volume while the video is playing.
39
24
 
40
- ## Outline
25
+ You find the atmo settings on the „Options“ tab of each page.
41
26
 
42
- Via the „Outline“ you can add chapters and pages - the
43
- actual content. Per Drag and Drop you can resort the pages
44
- and chapters any time.
27
+ Should you ever feel distracted by the atmo audio while working on your story, you can use the hot key „Alt + a“ to temporarily mute it. Simply press „Alt + a“ again to reactivate atmo audio.
45
28
 
46
- For more details see: [Chapter and Pages](#pageflow_paged.help_entries.outline)
29
+ **CAUTION:** Due to technical restrictions imposed by the browser manufacturers, ambient audio cannot be played on mobile devices and with Safari on the desktop.
47
30
  meta_data:
48
- menu_item: Title and Options
49
- text: |
50
- # Title and Options
51
-
52
- General settings for the entry. Please select a sub item on the left.
53
31
  appearance:
54
32
  menu_item: Appearance
55
33
  text: |
@@ -104,6 +82,11 @@ en:
104
82
  ## Theme
105
83
 
106
84
  Specify a font template for the entry.
85
+ menu_item: Title and Options
86
+ text: |
87
+ # Title and Options
88
+
89
+ General settings for the entry. Please select a sub item on the left.
107
90
  outline:
108
91
  menu_item: Chapters and Pages
109
92
  text: |-
@@ -129,25 +112,52 @@ en:
129
112
  is no structure of chapters. The chapter and the title of
130
113
  this chapter are consequently not shown in the
131
114
  overview/navigation.
132
- storylines:
133
- menu_item: Storylines
134
- text: "# Storylines\n\nIn addition to linear narrations from top to bottom, further storylines can be used as non linear excursions to enlarge upon parts of an entry.\n\nPlease find a blog article and example [here](https://www.pageflow.io/en/update-storylines)\n\nA „Storyline“ consists of chapters and pages, which users scroll through. Distinguishable is the so called main storyline from further subordinate ones. The user starts off in the main storyline and can then navigate to different excursions.\n\nTo create such an excursion from the main storyline use one of the „Link“ pages (Mosaic, Collage, Hotspot) and create the desired connections via „Links“.\n\nBy choosing a „Parent page“ you can determine to which page users return after scrolling the storyline´s last page.\n\nTransitions to subordinate storylines are visually supported by a horizontal animation as the default setting for entering and leaving. \n\nStorylines are created by clicking onto the plus button next to the storyline menu. Thereby a new chapter opens automatically in which further pages can be added. \n\n\n### Parent pages\n\nIn every subordinate storyline a „Parent page“ must be determined to define where users land when scrolling back.\n\nThis target page can be chosen by clicking on the pen symbol next to the storyline menu. When a „Parent page“ is defined, a back button will be shown automatically in the subordinate storyline that will always lead users back to the „Parent page“.\n\n\n### Chapter hierarchy\n\nThe use of more than one „subordinary“ storylines and the definition of „Parent pages“ leads to a chapter hierarchy as known from books:\n\n1. (Main storyline), 1.1. (Superior sub storyline), 1.1.1. (Subordinate sub storyline) and so on.\n\nThis hierarchy can be edited afterwards by clicking on the pen symbol next to the storyline menu. A subordinate storyline can be turned into the main storyline as well.\n\n\n### Scroll successors\n\nIf you want to lead users from a last page of a subordinate chapter (1.1.1) to another position than\nthe „Parent page“ (e.g. to 2.1) you can define a „Scroll successor“. Therefore click on the blue pen symbol within the storyline settings. As an example the following sequence might be imaginable: 1 -> 1.1 -> 1.1.1 -> 2.1\n\nAttention: While editing only the selected chapter will be shown in the sidebar. To switch to the other chapters click onto the storyline menu."
135
- page_options:
136
- menu_item: General Page Options
137
- text: "# General Page Options\n\n### Title\n\nHere you can add the title of a particular page. This\ntitle is not only the headline of the text on the page, it\nalso functions as the title in the navigation and\noverview. If a single page is shared in social networks,\nthis title is also the title of the social media post.\n\n### Hide the title\n\nOptionally you can hide the title. Thus the title is not shown as the\nheading of the text body. For the identification of the page it\nremains visible in the navigation, overview and on social media posts.\n\n### Tagline and Subtitle\n\nHere you can optionally enter a tagline and/or a\nsubtitle. If you click on „Hide title“ the tagline and\nsubtitle are not shown either.\n\n### Text\n\nThe text-block can be formatted with the buttons underneath\nthe input field. [B= bold / I=italic / U=underlined /\ninfinity symbol= Link/URL to an external website]\n\nAll changes are visible in the left front-end-view as soon\nas you leave the appropriate input field in the editor.\n\n### Textposition\n\nDecide if the text should be shown on the left or right side.\n\n### Opacity of the gradient\n\nThe opacity of the gradient improves the legibility of\nthe text on background-videos or pictures.\n\nYou can use the slider to darken or lighten up the\nbackground until the contrast between text and background is\noptimal.\n\n### Invert colors\n\nIf you invert the colors, „bright“ and „dark“ are\ninterchanged. Thus the normally white font changes into\nblack.\n\nA general rule: Bright font for dark pictures, dark font for\nbright pictures.\n\n### Thumbnail\n\nThe thumbnail replaces the automatically generated\npreview-picture in the navigation and overview.\n\n### Display in navigation\n\nIf this option is not taken, the particular page is not\nrepresented in the navigation and therefore cannot be\nreached through it. You can use this option if a page is\nsupposed to read more like a subpage of another page.\n\n### Transition effect\n\nThere are different scroll effects, which are visible when users enter or leave pages. You can use vertical transitions like „crossfade“ or „cut“ or „Fade to black“. Besides this you also can choose horizontal scrolling from right or left. You can determine which effect should be used for each individual page.\n\n### Fade in text after delay\n\nDefine whether text and gradient of a page should appear with a delay. \nUsers will first see the background image, then title, tagline and subtitle until finally the content text will be displayed.\n\nThere are three different durations of delay: short = 1 second, medium = 3 seconds, long = 5 seconds.\n\nThis feature fits best for intros or beginnings of chapters.\n\n### Description for the overview\n\nYou can enter a text, which appears when the user navigates\nwith the mouse over the particular page. This text matches\nwith the mouse-over-text for the page-type „Page References“\nas well as with the text, which appears when you share the\nPageflow in social networks."
138
- atmo:
139
- menu_item: Atmo Audio
115
+ overview:
116
+ menu_item: Overview
140
117
  text: |-
141
- # Atmo Audio
118
+ # Overview
142
119
 
143
- This feature lets you add background audio to every page regardless of its page type. You can define if a sound should play only for one page or continue playing for more pages without interruption. Simply select the same atmo audio file for some adjacent pages.
120
+ This is Pageflow’s editing platform. The division of the
121
+ screen into two allows you to edit your Pageflow and see a
122
+ preview at the same time. The editor shows modifications and
123
+ newly selected files directly and saves them automatically.
144
124
 
145
- That way chapters can be seperated acoustically and pages that belong together can be weaved to a stronger unit.
125
+ The sidebar can be hidden or shown. You can change the size
126
+ of the preview-window by pulling the sidebar to the right or
127
+ the left. If the preview-window is long and narrow like ´ a
128
+ smartphone, you will only be able to see the „overview“ icon
129
+ and not the entire navigation. This is due to lack of space.
146
130
 
147
- For the page type „Video“ there is a special option to pause background audio or continue at lower volume while the video is playing.
131
+ The navigation is divided into four parts:
148
132
 
149
- You find the atmo settings on the „Options“ tab of each page.
133
+ ## Title and Options
150
134
 
151
- Should you ever feel distracted by the atmo audio while working on your story, you can use the hot key „Alt + a“ to temporarily mute it. Simply press „Alt + a“ again to reactivate atmo audio.
135
+ Under „Title and Options“ you can set up basic appearance
136
+ parameters as well as the title, language and legal
137
+ notice. You can also decide which content should be
138
+ displayed when sharing the report on social media platforms.
139
+
140
+ For more details see: [Title and Options](#pageflow_paged.help_entries.meta_data)
141
+
142
+ ## Manage Files
143
+
144
+ Under „Manage Files“ you can upload your media files, which
145
+ you want to use in Pageflow. Furthermore you can reuse
146
+ videos, photos and audio-files that have already been
147
+ uploaded.
148
+
149
+ For more details see: [Manage Files](#pageflow.help_entries.files)
152
150
 
153
- **CAUTION:** Due to technical restrictions imposed by the browser manufacturers, ambient audio cannot be played on mobile devices and with Safari on the desktop.
151
+ ## Outline
152
+
153
+ Via the „Outline“ you can add chapters and pages - the
154
+ actual content. Per Drag and Drop you can resort the pages
155
+ and chapters any time.
156
+
157
+ For more details see: [Chapter and Pages](#pageflow_paged.help_entries.outline)
158
+ page_options:
159
+ menu_item: General Page Options
160
+ text: "# General Page Options\n\n### Title\n\nHere you can add the title of a particular page. This\ntitle is not only the headline of the text on the page, it\nalso functions as the title in the navigation and\noverview. If a single page is shared in social networks,\nthis title is also the title of the social media post.\n\n### Hide the title\n\nOptionally you can hide the title. Thus the title is not shown as the\nheading of the text body. For the identification of the page it\nremains visible in the navigation, overview and on social media posts.\n\n### Tagline and Subtitle\n\nHere you can optionally enter a tagline and/or a\nsubtitle. If you click on „Hide title“ the tagline and\nsubtitle are not shown either.\n\n### Text\n\nThe text-block can be formatted with the buttons underneath\nthe input field. [B= bold / I=italic / U=underlined /\ninfinity symbol= Link/URL to an external website]\n\nAll changes are visible in the left front-end-view as soon\nas you leave the appropriate input field in the editor.\n\n### Textposition\n\nDecide if the text should be shown on the left or right side.\n\n### Opacity of the gradient\n\nThe opacity of the gradient improves the legibility of\nthe text on background-videos or pictures.\n\nYou can use the slider to darken or lighten up the\nbackground until the contrast between text and background is\noptimal.\n\n### Invert colors\n\nIf you invert the colors, „bright“ and „dark“ are\ninterchanged. Thus the normally white font changes into\nblack.\n\nA general rule: Bright font for dark pictures, dark font for\nbright pictures.\n\n### Thumbnail\n\nThe thumbnail replaces the automatically generated\npreview-picture in the navigation and overview.\n\n### Display in navigation\n\nIf this option is not taken, the particular page is not\nrepresented in the navigation and therefore cannot be\nreached through it. You can use this option if a page is\nsupposed to read more like a subpage of another page.\n\n### Transition effect\n\nThere are different scroll effects, which are visible when users enter or leave pages. You can use vertical transitions like „crossfade“ or „cut“ or „Fade to black“. Besides this you also can choose horizontal scrolling from right or left. You can determine which effect should be used for each individual page.\n\n### Fade in text after delay\n\nDefine whether text and gradient of a page should appear with a delay. \nUsers will first see the background image, then title, tagline and subtitle until finally the content text will be displayed.\n\nThere are three different durations of delay: short = 1 second, medium = 3 seconds, long = 5 seconds.\n\nThis feature fits best for intros or beginnings of chapters.\n\n### Description for the overview\n\nYou can enter a text, which appears when the user navigates\nwith the mouse over the particular page. This text matches\nwith the mouse-over-text for the page-type „Page References“\nas well as with the text, which appears when you share the\nPageflow in social networks."
161
+ storylines:
162
+ menu_item: Storylines
163
+ text: "# Storylines\n\nIn addition to linear narrations from top to bottom, further storylines can be used as non linear excursions to enlarge upon parts of an entry.\n\nPlease find a blog article and example [here](https://www.pageflow.io/en/update-storylines)\n\nA „Storyline“ consists of chapters and pages, which users scroll through. Distinguishable is the so called main storyline from further subordinate ones. The user starts off in the main storyline and can then navigate to different excursions.\n\nTo create such an excursion from the main storyline use one of the „Link“ pages (Mosaic, Collage, Hotspot) and create the desired connections via „Links“.\n\nBy choosing a „Parent page“ you can determine to which page users return after scrolling the storyline´s last page.\n\nTransitions to subordinate storylines are visually supported by a horizontal animation as the default setting for entering and leaving. \n\nStorylines are created by clicking onto the plus button next to the storyline menu. Thereby a new chapter opens automatically in which further pages can be added. \n\n\n### Parent pages\n\nIn every subordinate storyline a „Parent page“ must be determined to define where users land when scrolling back.\n\nThis target page can be chosen by clicking on the pen symbol next to the storyline menu. When a „Parent page“ is defined, a back button will be shown automatically in the subordinate storyline that will always lead users back to the „Parent page“.\n\n\n### Chapter hierarchy\n\nThe use of more than one „subordinary“ storylines and the definition of „Parent pages“ leads to a chapter hierarchy as known from books:\n\n1. (Main storyline), 1.1. (Superior sub storyline), 1.1.1. (Subordinate sub storyline) and so on.\n\nThis hierarchy can be edited afterwards by clicking on the pen symbol next to the storyline menu. A subordinate storyline can be turned into the main storyline as well.\n\n\n### Scroll successors\n\nIf you want to lead users from a last page of a subordinate chapter (1.1.1) to another position than\nthe „Parent page“ (e.g. to 2.1) you can define a „Scroll successor“. Therefore click on the blue pen symbol within the storyline settings. As an example the following sequence might be imaginable: 1 -> 1.1 -> 1.1.1 -> 2.1\n\nAttention: While editing only the selected chapter will be shown in the sidebar. To switch to the other chapters click onto the storyline menu."
@@ -3,19 +3,45 @@ module PageflowScrolled
3
3
  module FaviconHelper
4
4
  include ThemesHelper
5
5
 
6
- def scrolled_favicons_for_entry(theme)
7
- render partial: 'pageflow_scrolled/favicons/entry',
8
- locals:
9
- {
10
- icon_path: scrolled_theme_asset_path(theme, 'favicons/favicon.ico'),
11
- apple_touch_icon_path: scrolled_theme_asset_path(theme, 'favicons/apple-touch-icon.png'),
12
- icon_32_path: scrolled_theme_asset_path(theme, 'favicons/favicon-32x32.png'),
13
- icon_16_path: scrolled_theme_asset_path(theme, 'favicons/favicon-16x16.png'),
14
- safari_pinned_tab_path: scrolled_theme_asset_path(theme, 'favicons/safari-pinned-tab.svg'),
15
- webmanifest_path: scrolled_theme_asset_path(theme, 'favicons/site.webmanifest'),
16
- msapplication_image: scrolled_theme_asset_path(theme, 'favicons/browserconfig.xml'),
17
- theme_color: theme.options[:theme_color]
18
- }
6
+ def scrolled_favicons_for_entry(entry, entry_mode: :published)
7
+ render(
8
+ 'pageflow_scrolled/favicons/entry',
9
+ manifest_path: entry_mode == :published && pageflow.entry_manifest_path(
10
+ entry,
11
+ format: 'webmanifest'
12
+ ),
13
+
14
+ svg_path: entry.theme.files.dig(:favicon, :original),
15
+
16
+ png_16_path: scrolled_theme_asset_path(
17
+ entry.theme,
18
+ 'favicons/favicon-16x16.png',
19
+ theme_file_role: :favicon_png,
20
+ theme_file_style: :w16
21
+ ),
22
+ png_32_path: scrolled_theme_asset_path(
23
+ entry.theme,
24
+ 'favicons/favicon-32x32.png',
25
+ theme_file_role: :favicon_png,
26
+ theme_file_style: :w32
27
+ ),
28
+
29
+ apple_touch_icon_path: scrolled_theme_asset_path(
30
+ entry.theme,
31
+ 'favicons/apple-touch-icon.png',
32
+ theme_file_role: :favicon_png,
33
+ theme_file_style: :w180
34
+ ),
35
+
36
+ ico_path: scrolled_theme_asset_path(
37
+ entry.theme,
38
+ 'favicons/favicon.ico',
39
+ theme_file_role: :favicon_ico,
40
+ theme_file_style: :original
41
+ ),
42
+
43
+ theme_color: entry.theme.options[:theme_color]
44
+ )
19
45
  end
20
46
  end
21
47
  end
@@ -0,0 +1,55 @@
1
+ module PageflowScrolled
2
+ # @api private
3
+ module GeneratedMediaQueriesHelper
4
+ def generated_media_queries_tags_for(html)
5
+ safe_join(
6
+ [
7
+ content_tag(:script,
8
+ 'window.pageflowScrolledSSRAspectRatioMediaQueries = true;'),
9
+ content_tag(:style,
10
+ generated_media_queries_css_for(html))
11
+ ]
12
+ )
13
+ end
14
+
15
+ def generated_media_queries_css_for(html)
16
+ aspect_ratio_class_strings = html.scan(/class="[^"]*aspectRatio[^"]*"/)
17
+
18
+ ratio_classes =
19
+ aspect_ratio_class_strings
20
+ .flat_map { |s| s.scan(/aspectRatio(Mobile)?([0-9]+)/) }
21
+ .uniq
22
+
23
+ ratio_classes.map { |match|
24
+ generated_aspec_ratio_media_query(
25
+ mobile_suffix: match[0],
26
+ numerator: match[1]
27
+ )
28
+ }.join
29
+ end
30
+
31
+ private
32
+
33
+ def generated_aspec_ratio_media_query(numerator:, mobile_suffix:)
34
+ orientation = mobile_suffix ? '(orientation: portrait) and ' : ''
35
+
36
+ # WARNING: This CSS snippet needs to be kept in sync with the
37
+ # corresponding snippet in useBackdropSectionClassName hook
38
+ <<-CSS
39
+ @media #{orientation}(min-aspect-ratio: #{numerator}/1000) {
40
+ section.aspectRatio#{mobile_suffix}#{numerator} {
41
+ --backdrop-positioner-transform: var(--backdrop-positioner-min-ar-transform);
42
+ --backdrop-positioner-width: var(--backdrop-positioner-min-ar-width);
43
+ --backdrop-positioner-height: var(--backdrop-positioner-min-ar-height);
44
+
45
+ --motif-placeholder-width: var(--motif-placeholder-min-ar-width);
46
+
47
+ --motif-display-top: var(--motif-display-min-ar-top);
48
+ --motif-display-bottom: var(--motif-display-min-ar-bottom);
49
+ --motif-display-height: var(--motif-display-min-ar-height);
50
+ }
51
+ }
52
+ CSS
53
+ end
54
+ end
55
+ end
@@ -1,9 +1,13 @@
1
1
  module PageflowScrolled
2
2
  # @api private
3
3
  module ThemesHelper
4
- def scrolled_theme_asset_path(theme, path, theme_file_role: nil, relative_url: false)
4
+ def scrolled_theme_asset_path(theme,
5
+ path,
6
+ theme_file_role: nil,
7
+ theme_file_style: :resized,
8
+ relative_url: false)
5
9
  path =
6
- theme.files.dig(theme_file_role, :resized) ||
10
+ theme.files.dig(theme_file_role, theme_file_style) ||
7
11
  asset_pack_path("media/pageflow-scrolled/themes/#{theme.name}/#{path}")
8
12
 
9
13
  if relative_url
@@ -6,4 +6,6 @@
6
6
 
7
7
  <%= javascript_include_tag 'pageflow/vendor' %>
8
8
  <%= javascript_include_tag 'pageflow/editor/vendor' %>
9
+
10
+ <%= scrolled_webpack_public_path_script_tag %>
9
11
  <%= scrolled_editor_javascript_packs_tag(entry) %>
@@ -0,0 +1,16 @@
1
+ json.icons do
2
+ json.array! %w[192 512] do |size|
3
+ json.type 'image/png'
4
+
5
+ json.src(
6
+ scrolled_theme_asset_path(
7
+ theme,
8
+ "favicons/android-chrome-#{size}x#{size}.png",
9
+ theme_file_role: :favicon_png,
10
+ theme_file_style: :"w#{size}"
11
+ )
12
+ )
13
+
14
+ json.sizes "#{size}x#{size}"
15
+ end
16
+ end
@@ -1,5 +1,5 @@
1
1
  <!DOCTYPE html>
2
- <%= content_tag(:html, lang: I18n.locale) do %>
2
+ <%= content_tag(:html, lang: @entry.locale) do %>
3
3
  <head>
4
4
  <title><%= pretty_entry_title(@entry) %></title>
5
5
 
@@ -10,7 +10,7 @@
10
10
  <%= social_share_meta_tags_for(@entry) %>
11
11
  <%= meta_tags_for_entry(@entry) %>
12
12
 
13
- <%= scrolled_favicons_for_entry(@entry.theme) %>
13
+ <%= scrolled_favicons_for_entry(@entry, entry_mode: @widget_scope) %>
14
14
 
15
15
  <%= javascript_include_tag 'pageflow_scrolled/legacy' %>
16
16
  <%= scrolled_frontend_stylesheet_packs_tag(@entry, widget_scope: @widget_scope) %>
@@ -31,6 +31,12 @@
31
31
  }
32
32
  </script>
33
33
  <% end %>
34
+
35
+ <% ssr_html = @skip_ssr ? '' : render_scrolled_entry(@entry) %>
36
+
37
+ <% if !@skip_ssr && (params[:frontend] == 'v2' || @entry.feature_state('frontend_v2')) %>
38
+ <%= generated_media_queries_tags_for(ssr_html) %>
39
+ <% end %>
34
40
  </head>
35
41
  <body>
36
42
  <%= structured_data_for_entry(@entry) unless @skip_structured_data %>
@@ -38,7 +44,7 @@
38
44
  <%= render 'pageflow_scrolled/entries/global_notices' %>
39
45
 
40
46
  <div id="fullscreenRoot"></div>
41
- <div id="root"><%= render_scrolled_entry(@entry) unless @skip_ssr %></div>
47
+ <div id="root"><%= ssr_html %></div>
42
48
 
43
49
  <div id='template-widget-container'>
44
50
  <%= render_widgets(@entry, scope: @widget_scope, insert_point: :bottom_of_entry) %>
@@ -14,14 +14,14 @@ json.config do
14
14
  json.default_file_rights entry.account.default_file_rights
15
15
 
16
16
  json.legal_info do
17
- theming = entry.theming
17
+ site = entry.site
18
18
  json.imprint do
19
- json.label raw(theming.imprint_link_label)
20
- json.url theming.imprint_link_url
19
+ json.label raw(site.imprint_link_label)
20
+ json.url site.imprint_link_url
21
21
  end
22
22
  json.copyright do
23
- json.label raw(theming.copyright_link_label)
24
- json.url theming.copyright_link_url
23
+ json.label raw(site.copyright_link_label)
24
+ json.url site.copyright_link_url
25
25
  end
26
26
  json.privacy do
27
27
  json.label I18n.t('pageflow.public.privacy_notice')
@@ -1,10 +1,16 @@
1
- <link rel='icon' href='<%= icon_path %>' type='image/ico'>
2
- <link rel='icon' type='image/png' sizes='32x32' href='<%= icon_32_path %>'>
3
- <link rel='icon' type='image/png' sizes='16x16' href='<%= icon_16_path %>'>
4
-
5
- <link rel='apple-touch-icon' sizes='180x180' href='<%= apple_touch_icon_path %>'>
6
- <link rel='manifest' href='<%= webmanifest_path %>'>
7
- <link rel='mask-icon' href='<%= safari_pinned_tab_path %>' color='#5bbad5'>
8
- <meta name='msapplication-TileColor' content='#da532c'>
9
- <meta name="msapplication-config" content='<%= msapplication_image %>'>
10
- <meta name='theme-color' content='<%= theme_color %>'>
1
+ <link rel="icon" sizes="any" href="<%= ico_path %>">
2
+
3
+ <% if svg_path %>
4
+ <link rel="icon" href="<%= svg_path %>" type="image/svg+xml">
5
+ <% else %>
6
+ <link rel="icon" type="image/png" sizes="32x32" href="<%= png_32_path %>">
7
+ <link rel="icon" type="image/png" sizes="16x16" href="<%= png_16_path %>">
8
+ <% end %>
9
+
10
+ <link rel="apple-touch-icon" href="<%= apple_touch_icon_path %>">
11
+
12
+ <% if manifest_path %>
13
+ <link rel="manifest" href="<%= manifest_path %>">
14
+ <% end %>
15
+
16
+ <meta name="theme-color" content="<%= theme_color %>">