@knight-lab/timelinejs 3.8.15 → 3.8.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (305) hide show
  1. package/API.md +1 -2
  2. package/{CHANGELOG → CHANGELOG.md} +70 -8
  3. package/DEPLOYING.md +4 -0
  4. package/README.md +21 -19
  5. package/RELEASING.md +4 -4
  6. package/dist/css/fonts/font.abril-droidsans.css +143 -0
  7. package/dist/css/fonts/font.amatic-andika.css +143 -0
  8. package/dist/css/fonts/font.bevan-pontanosans.css +141 -0
  9. package/dist/css/fonts/font.bitter-raleway.css +149 -0
  10. package/dist/css/fonts/font.clicker-garamond.css +141 -0
  11. package/dist/css/fonts/font.dancing-ledger.css +143 -0
  12. package/dist/css/fonts/font.default.css +155 -0
  13. package/dist/css/fonts/font.fjalla-average.css +141 -0
  14. package/dist/css/fonts/font.georgia-helvetica.css +123 -0
  15. package/dist/css/fonts/font.knightlab.css +125 -0
  16. package/dist/css/fonts/font.lustria-lato.css +147 -0
  17. package/dist/css/fonts/font.medula-lato.css +149 -0
  18. package/dist/css/fonts/font.oldstandard.css +135 -0
  19. package/dist/css/fonts/font.opensans-gentiumbook.css +155 -0
  20. package/dist/css/fonts/font.playfair-faunaone.css +156 -0
  21. package/dist/css/fonts/font.playfair.css +143 -0
  22. package/dist/css/fonts/font.pt.css +153 -0
  23. package/dist/css/fonts/font.roboto-megrim.css +143 -0
  24. package/dist/css/fonts/font.rufina-sintony.css +149 -0
  25. package/dist/css/fonts/font.ubuntu.css +145 -0
  26. package/dist/css/fonts/font.unicaone-vollkorn.css +143 -0
  27. package/dist/css/icons/tl-icons.eot +0 -0
  28. package/dist/css/icons/tl-icons.svg +63 -0
  29. package/dist/css/icons/tl-icons.ttf +0 -0
  30. package/dist/css/icons/tl-icons.woff +0 -0
  31. package/dist/css/icons/tl-icons.woff2 +0 -0
  32. package/dist/css/themes/timeline.theme.contrast.css +3125 -0
  33. package/dist/css/themes/timeline.theme.dark.css +3125 -0
  34. package/dist/css/timeline.css +3128 -0
  35. package/dist/css/timeline.css.map +1 -0
  36. package/dist/embed/compare.html +91 -0
  37. package/dist/embed/index.html +170 -0
  38. package/dist/embed/old-index.html +170 -0
  39. package/dist/embed/popular_timelines.json +1 -0
  40. package/dist/js/locale/af.json +75 -0
  41. package/dist/js/locale/ar.json +76 -0
  42. package/dist/js/locale/be.json +75 -0
  43. package/dist/js/locale/bg.json +75 -0
  44. package/dist/js/locale/ca.json +75 -0
  45. package/dist/js/locale/cz.json +108 -0
  46. package/dist/js/locale/da.json +75 -0
  47. package/dist/js/locale/de.json +76 -0
  48. package/dist/js/locale/el.json +75 -0
  49. package/dist/js/locale/en-24hr.json +75 -0
  50. package/dist/js/locale/en-week.json +75 -0
  51. package/dist/js/locale/en.json +152 -0
  52. package/dist/js/locale/eo.json +75 -0
  53. package/dist/js/locale/es.json +76 -0
  54. package/dist/js/locale/et.json +75 -0
  55. package/dist/js/locale/eu.json +75 -0
  56. package/dist/js/locale/fa.json +74 -0
  57. package/dist/js/locale/fi.json +95 -0
  58. package/dist/js/locale/fo.json +75 -0
  59. package/dist/js/locale/fr.json +119 -0
  60. package/dist/js/locale/fy.json +75 -0
  61. package/dist/js/locale/ga.json +75 -0
  62. package/dist/js/locale/gl.json +75 -0
  63. package/dist/js/locale/he.json +76 -0
  64. package/dist/js/locale/hi.json +76 -0
  65. package/dist/js/locale/hr.json +75 -0
  66. package/dist/js/locale/hu.json +114 -0
  67. package/dist/js/locale/hy.json +75 -0
  68. package/dist/js/locale/id.json +75 -0
  69. package/dist/js/locale/is.json +75 -0
  70. package/dist/js/locale/it.json +92 -0
  71. package/dist/js/locale/iw.json +76 -0
  72. package/dist/js/locale/ja.json +75 -0
  73. package/dist/js/locale/ka.json +75 -0
  74. package/dist/js/locale/ko.json +75 -0
  75. package/dist/js/locale/lb.json +75 -0
  76. package/dist/js/locale/lt.json +75 -0
  77. package/dist/js/locale/lv.json +75 -0
  78. package/dist/js/locale/ms.json +75 -0
  79. package/dist/js/locale/my.json +124 -0
  80. package/dist/js/locale/ne.json +75 -0
  81. package/dist/js/locale/nl.json +75 -0
  82. package/dist/js/locale/no.json +76 -0
  83. package/dist/js/locale/pl.json +75 -0
  84. package/dist/js/locale/pt-br.json +78 -0
  85. package/dist/js/locale/pt.json +78 -0
  86. package/dist/js/locale/rm.json +75 -0
  87. package/dist/js/locale/ro.json +75 -0
  88. package/dist/js/locale/ru.json +75 -0
  89. package/dist/js/locale/si.json +74 -0
  90. package/dist/js/locale/sk.json +75 -0
  91. package/dist/js/locale/sl.json +75 -0
  92. package/dist/js/locale/sr-cy.json +75 -0
  93. package/dist/js/locale/sr.json +75 -0
  94. package/dist/js/locale/sv.json +86 -0
  95. package/dist/js/locale/ta.json +75 -0
  96. package/dist/js/locale/te.json +74 -0
  97. package/dist/js/locale/th.json +108 -0
  98. package/dist/js/locale/tl.json +75 -0
  99. package/dist/js/locale/tr.json +75 -0
  100. package/dist/js/locale/uk.json +75 -0
  101. package/dist/js/locale/ur.json +123 -0
  102. package/dist/js/locale/vi.json +74 -0
  103. package/dist/js/locale/zh-cn.json +76 -0
  104. package/dist/js/locale/zh-tw.json +75 -0
  105. package/dist/js/timeline-min.js +12 -0
  106. package/dist/js/timeline.js +12 -0
  107. package/dist/js/timeline.js.map +1 -0
  108. package/dist/timeline3.zip +0 -0
  109. package/index.js +1 -0
  110. package/package.json +5 -5
  111. package/src/embed/old-index.html +128 -18
  112. package/src/js/core/Browser.js +19 -19
  113. package/src/js/index.js +1 -1
  114. package/src/js/language/locale/zh-cn.json +1 -1
  115. package/src/js/media/MediaType.js +1 -1
  116. package/src/js/media/types/Audio.js +9 -0
  117. package/src/js/media/types/Video.js +11 -0
  118. package/src/js/timeline/Timeline.js +25 -20
  119. package/src/less/fonts/font.knightlab.less +2 -2
  120. package/src/template/all-media-types.json +61 -24
  121. package/src/template/index.html +39 -19
  122. package/{contrib/women_in_computing.csv → src/template/my-own-timeline.csv} +5 -5
  123. package/contrib/README.md +0 -13
  124. package/contrib/csv_to_json.py +0 -106
  125. package/contrib/docs/ImageHosting.md +0 -120
  126. package/contrib/examples/autoload.html +0 -44
  127. package/contrib/examples/iBooksAuthor/README.md +0 -37
  128. package/contrib/examples/iBooksAuthor/TimelineJS.wdgt/Default.png +0 -0
  129. package/contrib/examples/iBooksAuthor/TimelineJS.wdgt/Info.plist +0 -27
  130. package/contrib/examples/iBooksAuthor/TimelineJS.wdgt/index.html +0 -13
  131. package/contrib/examples/react.html +0 -40
  132. package/contrib/examples/vue.html +0 -29
  133. package/contrib/fedorbeets/README.md +0 -3
  134. package/contrib/fedorbeets/timeline.py.txt +0 -56
  135. package/contrib/iamamoose/README.md +0 -3
  136. package/contrib/iamamoose/timeline.py.txt +0 -53
  137. package/contrib/women_in_computing.json +0 -263
  138. package/fabfile.py +0 -64
  139. package/requirements.txt +0 -29
  140. package/util/convert_json.py +0 -96
  141. package/website/__init__.py +0 -0
  142. package/website/app.py +0 -101
  143. package/website/core/__init__.py +0 -0
  144. package/website/core/settings/__init__.py +0 -0
  145. package/website/core/settings/base.py +0 -6
  146. package/website/core/settings/loc.py +0 -16
  147. package/website/examples.json +0 -114
  148. package/website/faq.json +0 -81
  149. package/website/static/css/desert.css +0 -34
  150. package/website/static/css/site.css +0 -74
  151. package/website/static/img/TimelineJSTags.jpg +0 -0
  152. package/website/static/img/examples/houston/eyesclosedftm_10001.jpg +0 -0
  153. package/website/static/img/examples/houston/family.jpg +0 -0
  154. package/website/static/img/examples/houston/family.png +0 -0
  155. package/website/static/img/examples/houston/wh1.jpg +0 -0
  156. package/website/static/img/examples/houston/wh2.jpg +0 -0
  157. package/website/static/img/examples/houston/wh3.jpg +0 -0
  158. package/website/static/img/examples/houston/whChild.jpg +0 -0
  159. package/website/static/img/examples/houston/whlead.jpg +0 -0
  160. package/website/static/img/examples/houston/young.jpg +0 -0
  161. package/website/static/img/examples/logos/Northwestern University.png +0 -0
  162. package/website/static/img/examples/logos/Social-Logos.png +0 -0
  163. package/website/static/img/examples/logos/knightlab-logo-background.png +0 -0
  164. package/website/static/img/examples/logos/knightlab-logo-small.png +0 -0
  165. package/website/static/img/examples/logos/knightlab-logo.png +0 -0
  166. package/website/static/img/examples/logos/less-small.png +0 -0
  167. package/website/static/img/examples/logos/logo_aljazeera.png +0 -0
  168. package/website/static/img/examples/logos/logo_arte.png +0 -0
  169. package/website/static/img/examples/logos/logo_beyondtheseal.png +0 -0
  170. package/website/static/img/examples/logos/logo_centerforpublicintegrity.png +0 -0
  171. package/website/static/img/examples/logos/logo_cnn.png +0 -0
  172. package/website/static/img/examples/logos/logo_denverpost.png +0 -0
  173. package/website/static/img/examples/logos/logo_engadget.png +0 -0
  174. package/website/static/img/examples/logos/logo_gigaom.png +0 -0
  175. package/website/static/img/examples/logos/logo_ibt.png +0 -0
  176. package/website/static/img/examples/logos/logo_knightlab.png +0 -0
  177. package/website/static/img/examples/logos/logo_ksat.png +0 -0
  178. package/website/static/img/examples/logos/logo_lemonde.png +0 -0
  179. package/website/static/img/examples/logos/logo_maneater.png +0 -0
  180. package/website/static/img/examples/logos/logo_mashable.png +0 -0
  181. package/website/static/img/examples/logos/logo_radiolab.png +0 -0
  182. package/website/static/img/examples/logos/logo_time.png +0 -0
  183. package/website/static/img/examples/logos/logo_vh1.png +0 -0
  184. package/website/static/img/examples/logos/logo_vinepair.png +0 -0
  185. package/website/static/img/examples/logos/logo_wbur.png +0 -0
  186. package/website/static/img/examples/thumbs/thumb_akira.jpg +0 -0
  187. package/website/static/img/examples/thumbs/thumb_aljazeera.jpg +0 -0
  188. package/website/static/img/examples/thumbs/thumb_artetv.jpg +0 -0
  189. package/website/static/img/examples/thumbs/thumb_banana.png +0 -0
  190. package/website/static/img/examples/thumbs/thumb_bulger.jpg +0 -0
  191. package/website/static/img/examples/thumbs/thumb_denver_shooting.jpg +0 -0
  192. package/website/static/img/examples/thumbs/thumb_houston.jpg +0 -0
  193. package/website/static/img/examples/thumbs/thumb_isis.jpg +0 -0
  194. package/website/static/img/examples/thumbs/thumb_lemonde.jpg +0 -0
  195. package/website/static/img/examples/thumbs/thumb_malaysia-airlines.jpg +0 -0
  196. package/website/static/img/examples/thumbs/thumb_mandela.jpg +0 -0
  197. package/website/static/img/examples/thumbs/thumb_mobile_device.jpg +0 -0
  198. package/website/static/img/examples/thumbs/thumb_northkorea.jpg +0 -0
  199. package/website/static/img/examples/thumbs/thumb_perpwalk.jpg +0 -0
  200. package/website/static/img/examples/thumbs/thumb_radiolab-colorwalking.jpg +0 -0
  201. package/website/static/img/examples/thumbs/thumb_republican.jpg +0 -0
  202. package/website/static/img/examples/thumbs/thumb_shtpeoplesay.jpg +0 -0
  203. package/website/static/img/examples/thumbs/thumb_supremecourt.jpg +0 -0
  204. package/website/static/img/examples/thumbs/thumb_univofmissouri.jpg +0 -0
  205. package/website/static/img/examples/thumbs/thumb_userinterface.png +0 -0
  206. package/website/static/img/examples/thumbs/thumb_wine.jpg +0 -0
  207. package/website/static/img/examples/user-interface/4s.jpg +0 -0
  208. package/website/static/img/examples/user-interface/apple.jpg +0 -0
  209. package/website/static/img/examples/user-interface/input.png +0 -0
  210. package/website/static/img/examples/user-interface/palm.png +0 -0
  211. package/website/static/img/examples/user-interface/pascaline.jpg +0 -0
  212. package/website/static/img/examples/user-interface/univac.JPG +0 -0
  213. package/website/static/img/font-options.png +0 -0
  214. package/website/static/img/kl-og.png +0 -0
  215. package/website/static/img/knightlab_logo.png +0 -0
  216. package/website/static/img/loading.gif +0 -0
  217. package/website/static/img/make/abril-droidsans.png +0 -0
  218. package/website/static/img/make/amatic-andika.png +0 -0
  219. package/website/static/img/make/bevan-pontanosans.png +0 -0
  220. package/website/static/img/make/bitter-raleway.png +0 -0
  221. package/website/static/img/make/clicker-garamond.png +0 -0
  222. package/website/static/img/make/dancing-ledger.png +0 -0
  223. package/website/static/img/make/default.png +0 -0
  224. package/website/static/img/make/fakedropdown.svg +0 -1
  225. package/website/static/img/make/fjalla-average.png +0 -0
  226. package/website/static/img/make/font-options.png +0 -0
  227. package/website/static/img/make/georgia-helvetica.png +0 -0
  228. package/website/static/img/make/lustria-lato.png +0 -0
  229. package/website/static/img/make/medula-lato.png +0 -0
  230. package/website/static/img/make/oldstandard.png +0 -0
  231. package/website/static/img/make/opensans-gentiumbook.png +0 -0
  232. package/website/static/img/make/playfair-faunaone.png +0 -0
  233. package/website/static/img/make/playfair.png +0 -0
  234. package/website/static/img/make/pt.png +0 -0
  235. package/website/static/img/make/publish_to_web_browser_url.png +0 -0
  236. package/website/static/img/make/publish_to_web_button_small-od1.png +0 -0
  237. package/website/static/img/make/publish_to_web_button_small.png +0 -0
  238. package/website/static/img/make/publish_to_web_small.png +0 -0
  239. package/website/static/img/make/publish_to_web_url_small.png +0 -0
  240. package/website/static/img/make/roboto-megrim.png +0 -0
  241. package/website/static/img/make/rufina-sintony.png +0 -0
  242. package/website/static/img/make/unicaone-vollkorn.png +0 -0
  243. package/website/static/img/make/v4_step_1.png +0 -0
  244. package/website/static/img/make/v4_step_2.png +0 -0
  245. package/website/static/img/timeline.png +0 -0
  246. package/website/static/img/timeline3_intro_image.png +0 -0
  247. package/website/static/js/faq-generator.js +0 -20
  248. package/website/static/js/main.js +0 -240
  249. package/website/static/welcome/step3.png +0 -0
  250. package/website/static/welcome/welcome.json +0 -266
  251. package/website/templates/_about.html +0 -23
  252. package/website/templates/_analytics.html +0 -10
  253. package/website/templates/_banner.html +0 -26
  254. package/website/templates/_demo.html +0 -5
  255. package/website/templates/_developers.html +0 -19
  256. package/website/templates/_examples.html +0 -156
  257. package/website/templates/_faq.html +0 -117
  258. package/website/templates/_footer.html +0 -54
  259. package/website/templates/_head.html +0 -38
  260. package/website/templates/_header.html +0 -18
  261. package/website/templates/_help.html +0 -50
  262. package/website/templates/_make.html +0 -291
  263. package/website/templates/_nav.html +0 -24
  264. package/website/templates/_overview.html +0 -32
  265. package/website/templates/_roadmap.html +0 -27
  266. package/website/templates/_storytelling_tools.html +0 -35
  267. package/website/templates/base.html +0 -37
  268. package/website/templates/docs/faq.html +0 -223
  269. package/website/templates/docs/index.html +0 -57
  270. package/website/templates/docs/instantiate-a-timeline.html +0 -207
  271. package/website/templates/docs/json-format.html +0 -477
  272. package/website/templates/docs/license.html +0 -29
  273. package/website/templates/docs/media-types.html +0 -82
  274. package/website/templates/docs/options.html +0 -472
  275. package/website/templates/docs/overriding-styles.html +0 -357
  276. package/website/templates/docs/using-spreadsheets.html +0 -94
  277. package/website/templates/error.html +0 -28
  278. package/website/templates/examples/_common_example_embed.html +0 -27
  279. package/website/templates/examples/embed-test/index.html +0 -41
  280. package/website/templates/examples/example.json +0 -328
  281. package/website/templates/examples/houston/index.html +0 -40
  282. package/website/templates/examples/houston/timeline2.json +0 -218
  283. package/website/templates/examples/houston/timeline3.json +0 -271
  284. package/website/templates/examples/mediatypes/index.html +0 -61
  285. package/website/templates/examples/mediatypes/timeline3.json +0 -421
  286. package/website/templates/examples/republican/index.html +0 -49
  287. package/website/templates/examples/republican/timeline2.json +0 -0
  288. package/website/templates/examples/republican/timeline3.json +0 -238
  289. package/website/templates/examples/shit-people-say/index.html +0 -39
  290. package/website/templates/examples/shit-people-say/timeline2.json +0 -243
  291. package/website/templates/examples/shit-people-say/timeline3.json +0 -336
  292. package/website/templates/examples/soundcite/index.html +0 -42
  293. package/website/templates/examples/soundcite/timeline3.json +0 -271
  294. package/website/templates/examples/timeline3.json +0 -271
  295. package/website/templates/examples/twain/index.html +0 -85
  296. package/website/templates/examples/twain/marktwain.json +0 -502
  297. package/website/templates/examples/user-interface/index.html +0 -40
  298. package/website/templates/examples/user-interface/timeline2.json +0 -260
  299. package/website/templates/examples/user-interface/timeline3.json +0 -327
  300. package/website/templates/index.html +0 -17
  301. package/website/templates/mediatype-tests.html +0 -121
  302. package/website/templates/test/GoogleSpreadsheetFeedLegacyFormat.json +0 -1
  303. package/website/templates/test/GoogleSpreadsheetFeedTJS3Format.json +0 -1
  304. package/website/templates/test/maps.html +0 -4
  305. package/website/templates/unit-tests.html +0 -775
@@ -1,357 +0,0 @@
1
- {% extends "base.html" %} {% block content %}
2
- <article id="product-body">
3
- <section class="section-color container">
4
- <p class="breadcrumb"><a href="index.html">&#12298; Back to main documentation page</a></p>
5
- <h2 class="header-story">Overriding Timeline's Styles</h2>
6
- <p>
7
- For more technically capable creators, you can override or extend TimelineJS's <abbr title="Cascading Style Sheets">CSS</abbr> to have more control over how your timeline looks. To do this, you must be able to create CSS files and host them
8
- at a URL where TimelineJS can find them.
9
- </p>
10
- <h3 id="typography">Fonts and Typography</h3>
11
- <p>
12
- The easiest way to change the fonts TimelineJS uses is to select from one of the list in the "Optional settings" section of step 3 of the Timeline authoring tool. However, if none of those font combinations work for you, you can create your own.
13
- </p>
14
- <p>
15
- To create your own, you can <a href="https://cdn.knightlab.com/libs/timeline3/latest/css/fonts/font.abril-droidsans.css">download a model copy</a> of a typical font CSS file from our CDN. You may want to put it through a <a href="http://www.cleancss.com/css-beautify/">CSS formatter before you start to edit it.</a> If you are familiar with <a href="http://lesscss.org/">LESS</a>, you may prefer to work from <a href="https://github.com/NUKnightLab/TimelineJS3/tree/master/src/less">our LESS files on GitHub</a>. If you set up Timeline as an <a href="https://docs.npmjs.com/cli/v6/commands/npm">`npm`</a> project, then after you edit those files, you can run <code>npm run dist</code> to compile the LESS into CSS. You'll find your generated font CSS file in the <code>dist/css/fonts</code> directory.</p>
16
- <p>
17
- Whether you use <code>npm</code> or simply edit a copy of one of the provided font CSS files, it's up to you to put this file on a web server. If you're using the embed code to publish your timeline, then you should change the <code>src</code> attribute of your <code>iframe</code> so that it has a parameter <code>font</code> with the URL to your font CSS as the value. <a href="https://cdn.knightlab.com/libs/timeline3/latest/embed/index.html?source=1xuY4upIooEeszZ_lCmeNx24eSFWe0rHe9ZdqH2xqVNk&font=Default&lang=en&initial_zoom=2&height=650&font=https://cdn.knightlab.com/libs/timeline3/latest/css/fonts/font.ubuntu.css">This URL</a> demonstrates setting the font with a URL, albeit in this case a URL to one of our provided font sets.
18
- </p>
19
- <p>
20
- If, instead of the embed, you are directly instantiating the timeline in your page using JavaScript, see <a href="http://timeline.knightlab.com/docs/instantiate-a-timeline.html#custom-fonts">this documentation</a> for more details.
21
- </p>
22
- <h3>Other CSS presentation</h3>
23
- <p>TimelineJS uses the <a href="http://lesscss.org/">Less CSS pre-processor</a> to manage the complex number of elements, variables, and conditions needed to make everything look great. One side effect of how we use <code>Less</code> is that various
24
- style rules for TimelineJS are often very specific. Since, in CSS, more specific rules take precedence over less specific ones, you may find it easier to edit Timeline's <code>Less</code> files and compile your own stylesheet than to work
25
- out the exact selector which controls style rules.
26
- </p>
27
- <p>
28
- If you want to change more than just typography, the basics are similar. You can create a Timeline CSS file by editing a copy of <a href="http://cdn.knightlab.com/libs/timeline3/latest/css/timeline.css">the main CSS file</a>, or by
29
- <a href="https://github.com/NUKnightLab/TimelineJS3/"></a>checking out TimelineJS from GitHub</a> and using <code>npm</code> to set up the development environment, and then editing the <a href="https://github.com/NUKnightLab/TimelineJS3/tree/master/src/less">LESS files</a> TimelineJS uses. If
30
- you are <a href="http://timeline.knightlab.com/docs/instantiate-a-timeline.html">instantiating the timeline using JavaScript</a>, you may also be able to selectively override CSS with <code>&lt;style&gt;</code> tags in the page.
31
- </p>
32
-
33
- <p>
34
- Assuming you've created your own CSS file and put it on a web server somewhere, if you are using <code>iframe</code> embeds, you can edit the <code>src</code> of your embed to tell TimelineJS to load your CSS. Add a parameter called <code>theme</code> and set its value to the URL for your custom CSS. (At one point we considered providing alternative themes with TimelineJS, but we haven't made the time to fully complete and test any.)
35
- </p>
36
- <p>
37
- See below for more details on various CSS classes which TimelineJS uses.
38
- </p>
39
-
40
- </section>
41
- <section class="section container" id="overriding-styles">
42
- <div class="grid">
43
- <div class="column-12">
44
- <h3>Timeline CSS classes</h3>
45
- <p>This table lists the major CSS classes which TimelineJS uses. You may just be able to tweak some of these. However, TimelineJS uses Less for CSS preprocessing, which means that some of the CSS rules are very specific.
46
-
47
- </p>
48
- <p><strong><em>Slide options</em></strong> affect the media and text areas of slides.</p>
49
- <div class="grid">
50
- <div class="column-2 column-6-phone">
51
- <strong>Class Name</strong>
52
- </div>
53
- <div class="column-2 column-6-phone">
54
- <strong>Element Type?</strong>
55
- </div>
56
- <div class="column-8">
57
- <strong>Notes</strong>
58
- </div>
59
- </div>
60
-
61
- <div class="grid">
62
- <div class="column-2 column-6-phone">
63
- <code>tl-timeline</code>
64
- </div>
65
- <div class="column-2 column-6-phone">
66
- <code>div</code>
67
- </div>
68
- <div class="column-8">
69
- Added to the initial div containing the timeline. Contains entire element.
70
- </div>
71
-
72
- <div class="column-2 column-6-phone">
73
- <code>tl-slider-container-mask</code>
74
- </div>
75
- <div class="column-2 column-6-phone">
76
- <code>div</code>
77
- </div>
78
- <div class="column-8">
79
- A wrapper around the slides. Background colors or images can be set here.
80
- </div>
81
-
82
- <div class="column-2 column-6-phone">
83
- <code>tl-slide</code>
84
- </div>
85
- <div class="column-2 column-6-phone">
86
- <code>div</code>
87
- </div>
88
- <div class="column-8">
89
- Each complete set of slide items. May appear in conjunction with <code>.tl-slide-titleslide</code> (for title slides) or <code>.tl-slide-media-only</code> (slides without text).
90
- </div>
91
-
92
- <div class="column-2 column-6-phone">
93
- <code>tl-media-content-container</code>
94
- </div>
95
- <div class="column-2 column-6-phone">
96
- <code>div</code>
97
- </div>
98
- <div class="column-8">
99
- Contains the media, its credit, and its caption.
100
- </div>
101
-
102
- <div class="column-2 column-6-phone">
103
- <code>tl-media-content</code>
104
- </div>
105
- <div class="column-2 column-6-phone">
106
- <code>div</code>
107
- </div>
108
- <div class="column-8">
109
- Contains the media item. Use this to add borders, padding and more.
110
- </div>
111
-
112
- <div class="column-2 column-6-phone">
113
- <code>tl-credit</code>
114
- </div>
115
- <div class="column-2 column-6-phone">
116
- <code>div</code>
117
- </div>
118
- <div class="column-8">
119
- The media item's credit.
120
- </div>
121
-
122
- <div class="column-2 column-6-phone">
123
- <code>tl-caption</code>
124
- </div>
125
- <div class="column-2 column-6-phone">
126
- <code>div</code>
127
- </div>
128
- <div class="column-8">
129
- The media item's caption.
130
- </div>
131
-
132
- <div class="column-2 column-6-phone">
133
- <code>tl-text</code>
134
- </div>
135
- <div class="column-2 column-6-phone">
136
- <code>div</code>
137
- </div>
138
- <div class="column-8">
139
- The slide's text plus padding. Add background color to the text portion of the slide here.
140
- </div>
141
-
142
- <div class="column-2 column-6-phone">
143
- <code>tl-text-content-container</code>
144
- </div>
145
- <div class="column-2 column-6-phone">
146
- <code>div</code>
147
- </div>
148
- <div class="column-8">
149
- The slide's text minus padding.
150
- </div>
151
-
152
- <div class="column-2 column-6-phone">
153
- <code>tl-headline-date</code>
154
- </div>
155
- <div class="column-2 column-6-phone">
156
- <code>h3</code>
157
- </div>
158
- <div class="column-8">
159
- The date that appears over the slide's headline.
160
- </div>
161
-
162
- <div class="column-2 column-6-phone">
163
- <code>tl-headline</code>
164
- </div>
165
- <div class="column-2 column-6-phone">
166
- <code>h2</code>
167
- </div>
168
- <div class="column-8">
169
- The slide's headline. Title slides have the additional class <code>.tl-headline-title</code>. Note that you will probably need to use the selector <code>h2.tl-headline</code> to change the appearance of the slide titles.
170
- </div>
171
-
172
- <div class="column-2 column-6-phone">
173
- <code>tl-text-content</code>
174
- </div>
175
- <div class="column-2 column-6-phone">
176
- <code>div</code>
177
- </div>
178
- <div class="column-8">
179
- The text of the slide, in <code>p</code> tags.
180
- </div>
181
-
182
- <div class="column-2 column-6-phone">
183
- <code>tl-slidenav-next</code>
184
- <br/>or</br>
185
- <code>tl-slidenav-previous</code>
186
- </div>
187
- <div class="column-2 column-6-phone">
188
- <code>div</code>
189
- </div>
190
- <div class="column-8">
191
- The navigation and text for moving forward and back. Use in conjunction with the following selectors to render the navigation arrows and text.
192
- </div>
193
-
194
- <div class="column-2 column-6-phone">
195
- <code>tl-slidenav-icon::before</code>
196
- </div>
197
- <div class="column-2 column-6-phone">
198
- <code>div</code>
199
- </div>
200
- <div class="column-8">
201
- Inserts the navigation arrow. Preface with <code>.tl-slidenav-next</code> or <code>.tl-slidenav-previous</code> to specify which arrow to render.
202
- </div>
203
-
204
- <div class="column-2 column-6-phone">
205
- <code>tl-slidenav-title</code>
206
- </div>
207
- <div class="column-2 column-6-phone">
208
- <code>div</code>
209
- </div>
210
- <div class="column-8">
211
- The title of the next/previous slide. Preface with <code>.tl-slidenav-next</code> or <code>.tl-slidenav-previous</code> to specify which title to render.
212
- </div>
213
-
214
- <div class="column-2 column-6-phone">
215
- <code>tl-slidenav-description</code>
216
- </div>
217
- <div class="column-2 column-6-phone">
218
- <code>div</code>
219
- </div>
220
- <div class="column-8">
221
- The description of the next/previous slide. Appears on hover. Preface with <code>.tl-slidenav-next</code> or <code>.tl-slidenav-previous</code> to specify which description to render.
222
- </div>
223
- </div>
224
- <p><strong><em>Timenav options</em></strong> affect the portion of the timeline that renders the time series.</p>
225
- <div class="grid">
226
- <div class="column-2 column-6-phone">
227
- <strong>Class Name</strong>
228
- </div>
229
- <div class="column-2 column-6-phone">
230
- <strong>Element Type?</strong>
231
- </div>
232
- <div class="column-8">
233
- <strong>Notes</strong>
234
- </div>
235
- </div>
236
-
237
- <div class="grid">
238
- <div class="column-2 column-6-phone">
239
- <code>tl-timenav</code>
240
- </div>
241
- <div class="column-2 column-6-phone">
242
- <code>div</code>
243
- </div>
244
- <div class="column-8">
245
- The timeline element. Change the background color here.
246
- </div>
247
-
248
- <div class="column-2 column-6-phone">
249
- <code>tl-menubar</code>
250
- </div>
251
- <div class="column-2 column-6-phone">
252
- <code>div</code>
253
- </div>
254
- <div class="column-8">
255
- The zoom icons.
256
- </div>
257
-
258
- <div class="column-2 column-6-phone">
259
- <code>tl-timemarker</code>
260
- </div>
261
- <div class="column-2 column-6-phone">
262
- <code>div</code>
263
- </div>
264
- <div class="column-8">
265
- All of the elements that make up the markers (flags and lines) on the timenav. The marker of the current slide also has the class <code>.tl-timemarker-active</code>.
266
- </div>
267
-
268
- <div class="column-2 column-6-phone">
269
- <code>tl-timemarker-content-container</code>
270
- </div>
271
- <div class="column-2 column-6-phone">
272
- <code>div</code>
273
- </div>
274
- <div class="column-8">
275
- The flag of the marker. You can set the flag's background color and text color here. When writing styles for this selector, preface this selector with <code>.tl-timemarker</code> (for slides other than the current slide) or <code>.tl-timemarker.tl-timemarker-active</code> (for the current slide).
276
- </div>
277
-
278
- <div class="column-2 column-6-phone">
279
- <code>tl-timemarker-timespan</code>
280
- </div>
281
- <div class="column-2 column-6-phone">
282
- <code>div</code>
283
- </div>
284
- <div class="column-8">
285
- The width of the marker. This draws the translucent background behind markers if your event has a start and end date. When writing styles for this selector, preface this selector with <code>.tl-timemarker</code> (for slides other
286
- than the current slide) or <code>.tl-timemarker.tl-timemarker-active</code> (for the current slide).
287
- </div>
288
-
289
- <div class="column-2 column-6-phone">
290
- <code>tl-timemarker-media-container</code>
291
- </div>
292
- <div class="column-2 column-6-phone">
293
- <code>div</code>
294
- </div>
295
- <div class="column-8">
296
- The icon or thumbnail representing the media in the timeline flag.
297
- </div>
298
-
299
- <div class="column-2 column-6-phone">
300
- <code>tl-headline</code>
301
- </div>
302
- <div class="column-2 column-6-phone">
303
- <code>h2</code>
304
- </div>
305
- <div class="column-8">
306
- The text of the flag. Set color and font family here. Note that this is the same class used for the headline in the main slide body. If you want to change only the headline in the navigation, use <code>.tl-timemarker .tl-timemarker-content-container .tl-timemarker-content .tl-timemarker-text h2.tl-headline</code>.
307
- (Yes, ideally it wouldn't need to be so specific, but for now, it does.)
308
- </div>
309
-
310
- <div class="column-2 column-6-phone">
311
- <code>tl-timeaxis</code>
312
- </div>
313
- <div class="column-2 column-6-phone">
314
- <code>div</code>
315
- </div>
316
- <div class="column-8">
317
- The ticks representing the timescale.
318
- </div>
319
-
320
- <div class="column-2 column-6-phone">
321
- <code>tl-timeaxis-background</code>
322
- </div>
323
- <div class="column-2 column-6-phone">
324
- <code>div</code>
325
- </div>
326
- <div class="column-8">
327
- The appearance of the background for the tick marks.
328
- </div>
329
-
330
- <div class="column-2 column-6-phone">
331
- <code>tl-timeaxis-tick:before</code>
332
- </div>
333
- <div class="column-2 column-6-phone">
334
- <code>div</code>
335
- </div>
336
- <div class="column-8">
337
- The line drawing the tick. Set the background color to change the color of the line. Preface with <code>.tl-timeaxis-major</code> to target major ticks or <code>.tl-timeaxis-minor</code> to target minor ticks.
338
- </div>
339
- </div>
340
-
341
- </div>
342
- </div>
343
- </section>
344
- </article>
345
- {% endblock %} {% block scripts %}
346
- <script type="text/javascript">
347
- jQuery(document).ready(function() {
348
- // make permalinks function for each question
349
- jQuery("p[id]").each(function() {
350
- jQuery(this).css('cursor', 'pointer');
351
- jQuery(this).click(function() {
352
- window.location.hash = "#" + this.id;
353
- })
354
- });
355
- });
356
- </script>
357
- {% endblock %}
@@ -1,94 +0,0 @@
1
- {% extends "base.html" %}
2
- {% block content %}
3
- <article>
4
- <section class="section-color container">
5
- <p class="breadcrumb"><a href="index.html">&#12298; Back to main documentation page</a></p>
6
- <header>
7
- <h2 class="header-story">Making a timeline from a Google Spreadsheet</h2>
8
- <p>
9
- You can create a simple timeline in a few short minutes using our <a href="https://drive.google.com/previewtemplate?id=1pHBvXN7nmGkiG8uQSUB82eNlnL8xHu6kydzH_-eguHQ&mode=public">Google spreadsheet template</a>, and this quick guide explaining the basic process. <a href="json-format.html">Experts can use their JSON</a> skills to create custom installations, while keeping TimelineJS3's core look and functionality.
10
- </p>
11
- <p>
12
- For an example of a completed spreadsheet, see <a href="https://docs.google.com/spreadsheets/u/1/d/1xuY4upIooEeszZ_lCmeNx24eSFWe0rHe9ZdqH2xqVNk/pubhtml" target="_blank">the spreadsheet</a> which powers the example on our <a href="/index.html">home page</a>.
13
- </p>
14
- </header>
15
- </section>
16
- <section class="product-page container">
17
- <div>
18
- <h4 id="dates">Working with dates</h4>
19
- <p id="start_date">
20
- The first four spreadsheet columns (<strong>A-D</strong>) are the date of your timeline entry. You can just enter the year, or you can get down to details such as month, day and even time of an event. You <em>must</em> enter at least the year, except for a 'title' slide. (To enter BCE dates, use a negative year, such as <em>-500</em>)
21
- </p>
22
- <p id="end_date">
23
- You have the option to add end dates (columns <strong>E-H</strong>). Again, you can just enter the year, or you can get as detailed as you like. End dates will cause TimelineJS to display spans of time (a.k.a. eras) in the bottom portion of the timeline. If your event doesn't have an "end date", leave these blank&mdash;you don't need to repeat the start date.
24
- </p>
25
- <p id="display_date">
26
- If you need more flexibility about how dates are shown in a slide, you can use column <strong>I</strong> to specify a "display date," which will override any decisions TimelineJS makes about how to show the date. This can be helpful if the actual date is not known, but you still need to specify some date using one or more of the previous (A-H) columns so that TimelineJS knows how to display it relative to other events. If you use this column, the display date is used on the slide where it is specified, and on labels for the "next" and "previous" buttons which lead to that slide.
27
- </p>
28
- <h4>Adding text content</h4>
29
- <p id="slide_text">
30
- Columns <strong>J</strong> and <strong>K</strong> of the spreadsheet contain the headline and the body text that will be displayed on each slide of your timeline. You can use simple HTML in these fields to style your text or to link to other pages on the web. Some HTML may be stripped out or changed as a security precaution.
31
- </p>
32
- <p>Neither "headline" nor "text" are strictly required, but we recommend including at least a headline, as this is also used in the timeline navigation tool to label the markers.</p>
33
- <h4 id="media">Adding media (optional)</h4>
34
- <p>
35
- TimelineJS can pull in media from a variety of sources and has built-in support for Twitter, Instagram, Flickr, Google Maps, DropBox, DocumentCloud, Wikipedia, SoundCloud, Storify, iframes, major video sites (YouTube, Vimeo, etc.) and more. <a href="media-types.html">Read more about the media types TimelineJS works with.</a>
36
- </p>
37
- <p>
38
- You have the option to add media to your slides in columns <strong>L-O</strong>. Under the <strong>Media</strong> column (<strong>L</strong>) enter the link (URL) to the media you wish to display. TimelineJS supports multiple <a href="media-types.html">media types</a>. In the next column (<strong>M</strong>), you can credit the media's original source, and in column <strong>N</strong> you can include a short caption. As with the text and headline, you may use basic HTML for formatting and linking in the credit and caption (<strong>M</strong> and <strong>N</strong>) columns.
39
- </p>
40
- <p id="media_markup">
41
- If TimelineJS doesn't support the media type you want on your slide, you can often make do by entering <code>&lt;iframe&gt;</code> markup in the <strong>Media</strong> column (<strong>L</strong>) instead of a URL. You can also enter <code>&lt;blockquote&gt;</code> markup in column L.
42
- </p>
43
- <p id="thumbnail">
44
- Markers for slides that contain media show a small icon representing the type of media used. If you'd like, you can show a thumbnail of the media there, instead. Simply add the URL of the image you'd like to use to column <strong>O</strong>.
45
- </p>
46
- <p id="slide_background">
47
- If you like, you can set the background of the slide to a specific color or an image. To do this, enter a <a href="https://www.w3schools.com/cssref/css_colors.asp">CSS hex color</a> value, <a href="http://www.w3schools.com/cssref/css_colors.asp">CSS named color</a>, or the URL to an image in the <strong>Background</strong> column (<strong>R</strong>).
48
- </p>
49
- <h4 id="title_slides">Titles and Eras</h4>
50
- <p>
51
- The <strong>Type</strong> column (<strong>P</strong>) can be used to activate a few more specialized features in Timeline. In most cases, you'll leave it blank. Many support questions we get relate to people accidentally filling in the "type" column when they don't intend to use it.
52
- </p>
53
- <p>
54
- If you use the word <code>title</code> in this column, then Timeline will use the row as a "title slide," which is shown before all others, and which does not require a date. Title
55
- slides do not appear in the markers in the navigation component of the Timeline. You should only have one row with "title" in the Type column.
56
- </p>
57
- <p>
58
- If you use the word <code>era</code> in this column, then Timeline will use the row to label a span of time in the "axis" area of the timeline navigation component. Eras should have start and end dates (at least the year for each) and a headline. No other cells are relevant to rows with type 'era'.</p>
59
- <p>Each era gets
60
- a distinct color, which is not currently configurable. At this time, overlapping eras are not well-supported, but we are investigating design strategies for that use case.
61
- </p>
62
- <h4 id="organizing_slides">Organizing slides</h4>
63
- <p>
64
- TimelineJS automatically orders slides according to their start date, and always puts the title slide first, no matter how the rows in your spreadsheet are ordered. If you need to have two slides with exactly the same start date, then the row which appears first in the spreadsheet will be shown first in the timeline.
65
- </p>
66
- <p id="groups">
67
- Using the <strong>Group</strong> column (<strong>Q</strong>), you can organize your slides by groups (formerly known as "tags"). You can put any values you want in the Group column. Events with the same group will be put in the same row or adjacent rows, and TimelineJS will use the text from the Group column as a label at the left edge of the row(s) containing those events. The group text will also be displayed on each slide. If you like, you can have a mix of slides in groups and slides with a blank value in the Group column. Creators cannot control the order in which groups are shown in the navigation area: they are listed based on the chronological order in which they are used, except that if there are slides with no group, those are at the bottom after the other groups.
68
- </p>
69
- </div>
70
- </section>
71
- <section class="section-color section-color-complement">
72
- <div class="container">
73
- <h4 id="publishing">Publishing your Timeline</h4>
74
- <p>Now that you have your spreadsheet set up, publish it to the web as explained in <a href="/#make-step-2">step 2 of "Make a Timeline"</a>, and follow the rest of the instructions on that page.</p>
75
-
76
- </div>
77
- </section>
78
- </article>
79
-
80
- {% endblock %}
81
-
82
- {% block scripts %}
83
- <script type="text/javascript">
84
- jQuery(document).ready(function() {
85
- // make permalinks function for each question
86
- jQuery("p[id],h4[id]").each(function(){
87
- jQuery(this).css('cursor','pointer');
88
- jQuery(this).click(function(){
89
- window.location.hash = "#" + this.id;
90
- })
91
- });
92
- });
93
- </script>
94
- {% endblock %}
@@ -1,28 +0,0 @@
1
- {% extends "base.html" %}
2
- {% block content %}
3
- <script type="text/javascript" charset="utf-8" src="https://ajax.googleapis.com/ajax/libs/jquery/1.4.4/jquery.min.js"></script>
4
-
5
- <script type="text/javascript" charset="utf-8">
6
- $(document).ready(function() {
7
-
8
- // Add the missing url to the text
9
- $("#url").text(window.location.pathname);
10
-
11
- // Fix the css locations dynamically
12
- $("head link").each(function() {
13
- for (var i=0; i<window.location.pathname.split(/\//g).length-2; i++)
14
- $(this).attr("href", "../" + $(this).attr("href"));
15
- });
16
-
17
- })
18
- </script>
19
- <section id="error" class="background-white">
20
- <div class="container">
21
- <div class="row">
22
- <p class="span12 error">
23
- Sorry the page <b id="url"></b> could not be found on this server.
24
- </p>
25
- </div>
26
- </div>
27
- </section>
28
- {% endblock %}
@@ -1,27 +0,0 @@
1
- <!-- Demo -->
2
- <div id="timeline-embed">
3
- <div id="timeline"></div>
4
- </div>
5
- <!-- build:css //cdn.knightlab.com/libs/timeline3/%(cdn)s/css/timeline.css -->
6
- <link rel="stylesheet" href="/dist/css/fonts/font.knightlab.css">
7
- <!-- endbuild -->
8
- <!-- build:css //cdn.knightlab.com/libs/timeline3/%(cdn)s/css/timeline.css -->
9
- <link title="timeline-styles" rel="stylesheet" href="/dist/css/timeline.css">
10
- <!-- endbuild -->
11
- <!-- build:js //cdn.knightlab.com/libs/timeline3/%(cdn)s/js/timeline-min.js -->
12
- <script src="/dist/js/timeline.js"></script>
13
- <!-- endbuild -->
14
- <script>
15
- $(document).ready(function() {
16
- var embed = document.getElementById('timeline-embed');
17
- embed.style.height = getComputedStyle(document.body).height;
18
- window.timeline = new TL.Timeline('timeline-embed', 'timeline3.json', {
19
- hash_bookmark: false
20
- });
21
- window.addEventListener('resize', function() {
22
- var embed = document.getElementById('timeline-embed');
23
- embed.style.height = getComputedStyle(document.body).height;
24
- timeline.updateDisplay();
25
- })
26
- });
27
- </script>
@@ -1,41 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en"><!--
3
-
4
- 88888888888 d8b 888 d8b 888888 d8888b
5
- 888 Y8P 888 Y8P 88b d88P Y88b
6
- 888 888 888 Y88b
7
- 888 888 88888b d88b d88b 888 888 88888b d88b 888 Y888b
8
- 888 888 888 888 88b d8P Y8b 888 888 888 88b d8P Y8b 888 Y88b
9
- 888 888 888 888 888 88888888 888 888 888 888 88888888 888 888
10
- 888 888 888 888 888 Y8b 888 888 888 888 Y8b 88P Y88b d88P
11
- 888 888 888 888 888 Y8888 888 888 888 888 Y8888 888 Y8888P
12
- d88P
13
- d88P
14
- 888P
15
- -->
16
- <head>
17
- <title>Test Timeline embedded with iframe</title>
18
- <meta name="description" content="Demonstrating an iframe embed, to verify that it works over HTTPS">
19
- <meta charset="utf-8">
20
- <meta name="viewport" content="initial-scale=1,width=device-width">
21
- <meta name="apple-mobile-web-app-capable" content="yes">
22
- <meta name="apple-touch-fullscreen" content="yes">
23
- <!-- Style-->
24
- <style>
25
- html, body {
26
- height:100%;
27
- padding: 0px;
28
- margin: 0px;
29
- }
30
- </style>
31
- <!-- HTML5 shim, for IE6-8 support of HTML elements--><!--[if lt IE 9]>
32
- <script src="//html5shim.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
33
- <link rel="shortcut icon" href="https://cdn.knightlab.com/libs/blueline/latest/assets/logos/favicon.ico">
34
- </head>
35
- <body>
36
- <iframe src='https://cdn.knightlab.com/libs/timeline3/latest/embed/index.html?source=1cWqQBZCkX9GpzFtxCWHoqFXCHg-ylTVUWlnrdYMzKUI&font=Default&lang=en&initial_zoom=2&height=650' width='100%' height='650' frameborder='0'></iframe>
37
-
38
- {% include "_analytics.html" %}
39
-
40
- </body>
41
- </html>