diff --git a/.eslintrc.js b/.eslintrc.js index e5049bf1bf..b7a079c568 100644 --- a/.eslintrc.js +++ b/.eslintrc.js @@ -29,6 +29,7 @@ module.exports = { "lodash/prefer-lodash-method": [0], "lodash/prefer-noop": [0], "max-len": ["error", { "code": 110 }], + "no-param-reassign": ["error", { "props": false }], "operator-linebreak": ["error", "before"], // override airbnb-base dev dependencies, latest version does not white list __mocks__ "import/no-extraneous-dependencies": [ diff --git a/.travis.yml b/.travis.yml index c94dcf0b9b..b54c2ca90f 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,6 +1,6 @@ language: node_js node_js: - - '8' + - '10' deploy: # deploy on release, to markbind.org - provider: script diff --git a/appveyor.yml b/appveyor.yml new file mode 100644 index 0000000000..7b88f24ab9 --- /dev/null +++ b/appveyor.yml @@ -0,0 +1,17 @@ +environment: + nodejs_version: "10" + +# Install scripts +install: + # Install nodejs version + - ps: Install-Product node $env:nodejs_version + # Install modules + - npm ci + +# Post-install test scripts +test_script: + - node --version + - npm --version + - npm run testwin + +build: off diff --git a/asset/css/markbind.css b/asset/css/markbind.css index b38ecfa195..927167704d 100644 --- a/asset/css/markbind.css +++ b/asset/css/markbind.css @@ -25,6 +25,36 @@ pre > code.hljs { counter-reset: line; } +pre > code.hljs[heading] { + border-top-right-radius: 0; +} + +.code-block { + position: relative; +} + +.code-block-heading { + background-color: #f2f2ff; + border-radius: 6px 6px 0 0; + color: #8787a5; + float: right; + font-size: 85%; + line-height: 1; + max-width: 85%; + overflow-wrap: break-word; + padding: 0.25em 0.4em; + text-align: right; +} + +.code-block-content { + clear: both; + display: block; +} + +code > span.highlighted { + background: lavender; +} + kbd { background-color: #fafbfc; border: 1px solid #c6cbd1; @@ -94,7 +124,7 @@ code.hljs:hover { header.header-fixed { position: fixed; width: 100%; - z-index: 9999; + z-index: 1000; } /* #app is treated as the main container */ @@ -340,3 +370,74 @@ li.footnote-item:target { top: 0; width: 3em; } + +/* hide popover, modal, tooltip content */ +[data-mb-html-for] { + display: none; +} + +/* styles for triggers */ +.trigger { + text-decoration: underline dotted; +} + +.modal.mb-zoom { + -webkit-transform: scale(0.1); + -moz-transform: scale(0.1); + -ms-transform: scale(0.1); + transform: scale(0.1); + opacity: 0; + -webkit-transition: all 0.3s; + -moz-transition: all 0.3s; + transition: all 0.3s; +} + +.modal.mb-zoom.show { + -webkit-transform: scale(1); + -moz-transform: scale(1); + -ms-transform: scale(1); + transform: scale(1); + opacity: 1; +} + +/* "Copy" code block button */ +pre { + position: relative; +} + +.copy-btn { + background-color: #b4b4b9; + border-radius: 0.25rem; + color: #f8f8ff; + display: inline-block; + font-size: 75%; + line-height: 1; + padding: 0.25em 0.4em; + position: absolute; + right: 0.5em; + text-align: center; + top: 0.4em; + white-space: nowrap; +} + +.copy-btn:hover { + color: #555; +} + +.copy-btn-body { + align-items: center; + display: flex; +} + +.copy-btn svg { + fill: currentColor; + margin-right: 0.4em; +} + +.copy-btn-label { + font-size: 11px; +} + +.copy-btn:focus { + outline: none; +} diff --git a/asset/js/setup.js b/asset/js/setup.js index 114e5a70e8..c6b54ef24f 100644 --- a/asset/js/setup.js +++ b/asset/js/setup.js @@ -171,6 +171,39 @@ function setupWithSearch() { setupSiteNav(); } +function makeInnerGetterFor(attribute) { + return (element) => { + const innerElement = element.querySelector(`[data-mb-html-for="${attribute}"]`); + return innerElement === null ? '' : innerElement.innerHTML; + }; +} + +function makeHtmlGetterFor(componentType, attribute) { + return (element) => { + const contentWrapper = document.getElementById(element.attributes.for.value); + return contentWrapper.dataset.mbComponentType === componentType + ? makeInnerGetterFor(attribute)(contentWrapper) : ''; + }; +} + +/* eslint-disable no-unused-vars */ +/* + These getters are used by triggers to get their popover/tooltip content. + We need to create a completely new popover/tooltip for each trigger due to bootstrap-vue's implementation, + so this is how we retrieve our contents. +*/ +const popoverContentGetter = makeHtmlGetterFor('popover', 'content'); +const popoverHeaderGetter = makeHtmlGetterFor('popover', 'header'); +const popoverInnerContentGetter = makeInnerGetterFor('content'); +const popoverInnerHeaderGetter = makeInnerGetterFor('header'); + +const popoverGenerator = { title: popoverHeaderGetter, content: popoverContentGetter }; +const popoverInnerGenerator = { title: popoverInnerHeaderGetter, content: popoverInnerContentGetter }; + +const tooltipContentGetter = makeHtmlGetterFor('tooltip', '_content'); +const tooltipInnerContentGetter = makeInnerGetterFor('_content'); +/* eslint-enable no-unused-vars */ + if (enableSearch) { setupWithSearch(); } else { diff --git a/docs/images/copyCode.png b/docs/images/copyCode.png new file mode 100644 index 0000000000..0bd900728a Binary files /dev/null and b/docs/images/copyCode.png differ diff --git a/docs/site.json b/docs/site.json index 91ab123fe4..81184cf5f7 100644 --- a/docs/site.json +++ b/docs/site.json @@ -1,5 +1,6 @@ { "baseUrl": "", + "timeZone": "Asia/Singapore", "titlePrefix": "MarkBind", "pages": [ { diff --git a/docs/userGuide/pages/locales.md b/docs/userGuide/pages/locales.md new file mode 100644 index 0000000000..3598b21ea8 --- /dev/null +++ b/docs/userGuide/pages/locales.md @@ -0,0 +1,440 @@ +```js +af_NA: "Afrikaans (Namibia)", +af_ZA: "Afrikaans (South Africa)", +af: "Afrikaans", +ak_GH: "Akan (Ghana)", +ak: "Akan", +sq_AL: "Albanian (Albania)", +sq: "Albanian", +am_ET: "Amharic (Ethiopia)", +am: "Amharic", +ar_DZ: "Arabic (Algeria)", +ar_BH: "Arabic (Bahrain)", +ar_EG: "Arabic (Egypt)", +ar_IQ: "Arabic (Iraq)", +ar_JO: "Arabic (Jordan)", +ar_KW: "Arabic (Kuwait)", +ar_LB: "Arabic (Lebanon)", +ar_LY: "Arabic (Libya)", +ar_MA: "Arabic (Morocco)", +ar_OM: "Arabic (Oman)", +ar_QA: "Arabic (Qatar)", +ar_SA: "Arabic (Saudi Arabia)", +ar_SD: "Arabic (Sudan)", +ar_SY: "Arabic (Syria)", +ar_TN: "Arabic (Tunisia)", +ar_AE: "Arabic (United Arab Emirates)", +ar_YE: "Arabic (Yemen)", +ar: "Arabic", +hy_AM: "Armenian (Armenia)", +hy: "Armenian", +as_IN: "Assamese (India)", +as: "Assamese", +asa_TZ: "Asu (Tanzania)", +asa: "Asu", +az_Cyrl: "Azerbaijani (Cyrillic)", +az_Cyrl_AZ: "Azerbaijani (Cyrillic, Azerbaijan)", +az_Latn: "Azerbaijani (Latin)", +az_Latn_AZ: "Azerbaijani (Latin, Azerbaijan)", +az: "Azerbaijani", +bm_ML: "Bambara (Mali)", +bm: "Bambara", +eu_ES: "Basque (Spain)", +eu: "Basque", +be_BY: "Belarusian (Belarus)", +be: "Belarusian", +bem_ZM: "Bemba (Zambia)", +bem: "Bemba", +bez_TZ: "Bena (Tanzania)", +bez: "Bena", +bn_BD: "Bengali (Bangladesh)", +bn_IN: "Bengali (India)", +bn: "Bengali", +bs_BA: "Bosnian (Bosnia and Herzegovina)", +bs: "Bosnian", +bg_BG: "Bulgarian (Bulgaria)", +bg: "Bulgarian", +my_MM: "Burmese (Myanmar [Burma])", +my: "Burmese", +yue_Hant_HK: "Cantonese (Traditional, Hong Kong SAR China)", +ca_ES: "Catalan (Spain)", +ca: "Catalan", +tzm_Latn: "Central Morocco Tamazight (Latin)", +tzm_Latn_MA: "Central Morocco Tamazight (Latin, Morocco)", +tzm: "Central Morocco Tamazight", +chr_US: "Cherokee (United States)", +chr: "Cherokee", +cgg_UG: "Chiga (Uganda)", +cgg: "Chiga", +zh_Hans: "Chinese (Simplified Han)", +zh_Hans_CN: "Chinese (Simplified Han, China)", +zh_Hans_HK: "Chinese (Simplified Han, Hong Kong SAR China)", +zh_Hans_MO: "Chinese (Simplified Han, Macau SAR China)", +zh_Hans_SG: "Chinese (Simplified Han, Singapore)", +zh_Hant: "Chinese (Traditional Han)", +zh_Hant_HK: "Chinese (Traditional Han, Hong Kong SAR China)", +zh_Hant_MO: "Chinese (Traditional Han, Macau SAR China)", +zh_Hant_TW: "Chinese (Traditional Han, Taiwan)", +zh: "Chinese", +kw_GB: "Cornish (United Kingdom)", +kw: "Cornish", +hr_HR: "Croatian (Croatia)", +hr: "Croatian", +cs_CZ: "Czech (Czech Republic)", +cs: "Czech", +da_DK: "Danish (Denmark)", +da: "Danish", +nl_BE: "Dutch (Belgium)", +nl_NL: "Dutch (Netherlands)", +nl: "Dutch", +ebu_KE: "Embu (Kenya)", +ebu: "Embu", +en_AS: "English (American Samoa)", +en_AU: "English (Australia)", +en_BE: "English (Belgium)", +en_BZ: "English (Belize)", +en_BW: "English (Botswana)", +en_CA: "English (Canada)", +en_GU: "English (Guam)", +en_HK: "English (Hong Kong SAR China)", +en_IN: "English (India)", +en_IE: "English (Ireland)", +en_IL: "English (Israel)", +en_JM: "English (Jamaica)", +en_MT: "English (Malta)", +en_MH: "English (Marshall Islands)", +en_MU: "English (Mauritius)", +en_NA: "English (Namibia)", +en_NZ: "English (New Zealand)", +en_MP: "English (Northern Mariana Islands)", +en_PK: "English (Pakistan)", +en_PH: "English (Philippines)", +en_SG: "English (Singapore)", +en_ZA: "English (South Africa)", +en_TT: "English (Trinidad and Tobago)", +en_UM: "English (U.S. Minor Outlying Islands)", +en_VI: "English (U.S. Virgin Islands)", +en_GB: "English (United Kingdom)", +en_US: "English (United States)", +en_ZW: "English (Zimbabwe)", +en: "English", +eo: "Esperanto", +et_EE: "Estonian (Estonia)", +et: "Estonian", +ee_GH: "Ewe (Ghana)", +ee_TG: "Ewe (Togo)", +ee: "Ewe", +fo_FO: "Faroese (Faroe Islands)", +fo: "Faroese", +fil_PH: "Filipino (Philippines)", +fil: "Filipino", +fi_FI: "Finnish (Finland)", +fi: "Finnish", +fr_BE: "French (Belgium)", +fr_BJ: "French (Benin)", +fr_BF: "French (Burkina Faso)", +fr_BI: "French (Burundi)", +fr_CM: "French (Cameroon)", +fr_CA: "French (Canada)", +fr_CF: "French (Central African Republic)", +fr_TD: "French (Chad)", +fr_KM: "French (Comoros)", +fr_CG: "French (Congo - Brazzaville)", +fr_CD: "French (Congo - Kinshasa)", +fr_CI: "French (Côte d’Ivoire)", +fr_DJ: "French (Djibouti)", +fr_GQ: "French (Equatorial Guinea)", +fr_FR: "French (France)", +fr_GA: "French (Gabon)", +fr_GP: "French (Guadeloupe)", +fr_GN: "French (Guinea)", +fr_LU: "French (Luxembourg)", +fr_MG: "French (Madagascar)", +fr_ML: "French (Mali)", +fr_MQ: "French (Martinique)", +fr_MC: "French (Monaco)", +fr_NE: "French (Niger)", +fr_RW: "French (Rwanda)", +fr_RE: "French (Réunion)", +fr_BL: "French (Saint Barthélemy)", +fr_MF: "French (Saint Martin)", +fr_SN: "French (Senegal)", +fr_CH: "French (Switzerland)", +fr_TG: "French (Togo)", +fr: "French", +ff_SN: "Fulah (Senegal)", +ff: "Fulah", +gl_ES: "Galician (Spain)", +gl: "Galician", +lg_UG: "Ganda (Uganda)", +lg: "Ganda", +ka_GE: "Georgian (Georgia)", +ka: "Georgian", +de_AT: "German (Austria)", +de_BE: "German (Belgium)", +de_DE: "German (Germany)", +de_LI: "German (Liechtenstein)", +de_LU: "German (Luxembourg)", +de_CH: "German (Switzerland)", +de: "German", +el_CY: "Greek (Cyprus)", +el_GR: "Greek (Greece)", +el: "Greek", +gu_IN: "Gujarati (India)", +gu: "Gujarati", +guz_KE: "Gusii (Kenya)", +guz: "Gusii", +ha_Latn: "Hausa (Latin)", +ha_Latn_GH: "Hausa (Latin, Ghana)", +ha_Latn_NE: "Hausa (Latin, Niger)", +ha_Latn_NG: "Hausa (Latin, Nigeria)", +ha: "Hausa", +haw_US: "Hawaiian (United States)", +haw: "Hawaiian", +he_IL: "Hebrew (Israel)", +he: "Hebrew", +hi_IN: "Hindi (India)", +hi: "Hindi", +hu_HU: "Hungarian (Hungary)", +hu: "Hungarian", +is_IS: "Icelandic (Iceland)", +is: "Icelandic", +ig_NG: "Igbo (Nigeria)", +ig: "Igbo", +id_ID: "Indonesian (Indonesia)", +id: "Indonesian", +ga_IE: "Irish (Ireland)", +ga: "Irish", +it_IT: "Italian (Italy)", +it_CH: "Italian (Switzerland)", +it: "Italian", +ja_JP: "Japanese (Japan)", +ja: "Japanese", +kea_CV: "Kabuverdianu (Cape Verde)", +kea: "Kabuverdianu", +kab_DZ: "Kabyle (Algeria)", +kab: "Kabyle", +kl_GL: "Kalaallisut (Greenland)", +kl: "Kalaallisut", +kln_KE: "Kalenjin (Kenya)", +kln: "Kalenjin", +kam_KE: "Kamba (Kenya)", +kam: "Kamba", +kn_IN: "Kannada (India)", +kn: "Kannada", +kk_Cyrl: "Kazakh (Cyrillic)", +kk_Cyrl_KZ: "Kazakh (Cyrillic, Kazakhstan)", +kk: "Kazakh", +km_KH: "Khmer (Cambodia)", +km: "Khmer", +ki_KE: "Kikuyu (Kenya)", +ki: "Kikuyu", +rw_RW: "Kinyarwanda (Rwanda)", +rw: "Kinyarwanda", +kok_IN: "Konkani (India)", +kok: "Konkani", +ko_KR: "Korean (South Korea)", +ko: "Korean", +khq_ML: "Koyra Chiini (Mali)", +khq: "Koyra Chiini", +ses_ML: "Koyraboro Senni (Mali)", +ses: "Koyraboro Senni", +lag_TZ: "Langi (Tanzania)", +lag: "Langi", +lv_LV: "Latvian (Latvia)", +lv: "Latvian", +lt_LT: "Lithuanian (Lithuania)", +lt: "Lithuanian", +luo_KE: "Luo (Kenya)", +luo: "Luo", +luy_KE: "Luyia (Kenya)", +luy: "Luyia", +mk_MK: "Macedonian (Macedonia)", +mk: "Macedonian", +jmc_TZ: "Machame (Tanzania)", +jmc: "Machame", +kde_TZ: "Makonde (Tanzania)", +kde: "Makonde", +mg_MG: "Malagasy (Madagascar)", +mg: "Malagasy", +ms_BN: "Malay (Brunei)", +ms_MY: "Malay (Malaysia)", +ms: "Malay", +ml_IN: "Malayalam (India)", +ml: "Malayalam", +mt_MT: "Maltese (Malta)", +mt: "Maltese", +gv_GB: "Manx (United Kingdom)", +gv: "Manx", +mr_IN: "Marathi (India)", +mr: "Marathi", +mas_KE: "Masai (Kenya)", +mas_TZ: "Masai (Tanzania)", +mas: "Masai", +mer_KE: "Meru (Kenya)", +mer: "Meru", +mfe_MU: "Morisyen (Mauritius)", +mfe: "Morisyen", +naq_NA: "Nama (Namibia)", +naq: "Nama", +ne_IN: "Nepali (India)", +ne_NP: "Nepali (Nepal)", +ne: "Nepali", +nd_ZW: "North Ndebele (Zimbabwe)", +nd: "North Ndebele", +nb_NO: "Norwegian Bokmål (Norway)", +nb: "Norwegian Bokmål", +nn_NO: "Norwegian Nynorsk (Norway)", +nn: "Norwegian Nynorsk", +nyn_UG: "Nyankole (Uganda)", +nyn: "Nyankole", +or_IN: "Oriya (India)", +or: "Oriya", +om_ET: "Oromo (Ethiopia)", +om_KE: "Oromo (Kenya)", +om: "Oromo", +ps_AF: "Pashto (Afghanistan)", +ps: "Pashto", +fa_AF: "Persian (Afghanistan)", +fa_IR: "Persian (Iran)", +fa: "Persian", +pl_PL: "Polish (Poland)", +pl: "Polish", +pt_BR: "Portuguese (Brazil)", +pt_GW: "Portuguese (Guinea-Bissau)", +pt_MZ: "Portuguese (Mozambique)", +pt_PT: "Portuguese (Portugal)", +pt: "Portuguese", +pa_Arab: "Punjabi (Arabic)", +pa_Arab_PK: "Punjabi (Arabic, Pakistan)", +pa_Guru: "Punjabi (Gurmukhi)", +pa_Guru_IN: "Punjabi (Gurmukhi, India)", +pa: "Punjabi", +ro_MD: "Romanian (Moldova)", +ro_RO: "Romanian (Romania)", +ro: "Romanian", +rm_CH: "Romansh (Switzerland)", +rm: "Romansh", +rof_TZ: "Rombo (Tanzania)", +rof: "Rombo", +ru_MD: "Russian (Moldova)", +ru_RU: "Russian (Russia)", +ru_UA: "Russian (Ukraine)", +ru: "Russian", +rwk_TZ: "Rwa (Tanzania)", +rwk: "Rwa", +saq_KE: "Samburu (Kenya)", +saq: "Samburu", +sg_CF: "Sango (Central African Republic)", +sg: "Sango", +seh_MZ: "Sena (Mozambique)", +seh: "Sena", +sr_Cyrl: "Serbian (Cyrillic)", +sr_Cyrl_BA: "Serbian (Cyrillic, Bosnia and Herzegovina)", +sr_Cyrl_ME: "Serbian (Cyrillic, Montenegro)", +sr_Cyrl_RS: "Serbian (Cyrillic, Serbia)", +sr_Latn: "Serbian (Latin)", +sr_Latn_BA: "Serbian (Latin, Bosnia and Herzegovina)", +sr_Latn_ME: "Serbian (Latin, Montenegro)", +sr_Latn_RS: "Serbian (Latin, Serbia)", +sr: "Serbian", +sn_ZW: "Shona (Zimbabwe)", +sn: "Shona", +ii_CN: "Sichuan Yi (China)", +ii: "Sichuan Yi", +si_LK: "Sinhala (Sri Lanka)", +si: "Sinhala", +sk_SK: "Slovak (Slovakia)", +sk: "Slovak", +sl_SI: "Slovenian (Slovenia)", +sl: "Slovenian", +xog_UG: "Soga (Uganda)", +xog: "Soga", +so_DJ: "Somali (Djibouti)", +so_ET: "Somali (Ethiopia)", +so_KE: "Somali (Kenya)", +so_SO: "Somali (Somalia)", +so: "Somali", +es_AR: "Spanish (Argentina)", +es_BO: "Spanish (Bolivia)", +es_CL: "Spanish (Chile)", +es_CO: "Spanish (Colombia)", +es_CR: "Spanish (Costa Rica)", +es_DO: "Spanish (Dominican Republic)", +es_EC: "Spanish (Ecuador)", +es_SV: "Spanish (El Salvador)", +es_GQ: "Spanish (Equatorial Guinea)", +es_GT: "Spanish (Guatemala)", +es_HN: "Spanish (Honduras)", +es_419: "Spanish (Latin America)", +es_MX: "Spanish (Mexico)", +es_NI: "Spanish (Nicaragua)", +es_PA: "Spanish (Panama)", +es_PY: "Spanish (Paraguay)", +es_PE: "Spanish (Peru)", +es_PR: "Spanish (Puerto Rico)", +es_ES: "Spanish (Spain)", +es_US: "Spanish (United States)", +es_UY: "Spanish (Uruguay)", +es_VE: "Spanish (Venezuela)", +es: "Spanish", +sw_KE: "Swahili (Kenya)", +sw_TZ: "Swahili (Tanzania)", +sw: "Swahili", +sv_FI: "Swedish (Finland)", +sv_SE: "Swedish (Sweden)", +sv: "Swedish", +gsw_CH: "Swiss German (Switzerland)", +gsw: "Swiss German", +shi_Latn: "Tachelhit (Latin)", +shi_Latn_MA: "Tachelhit (Latin, Morocco)", +shi_Tfng: "Tachelhit (Tifinagh)", +shi_Tfng_MA: "Tachelhit (Tifinagh, Morocco)", +shi: "Tachelhit", +dav_KE: "Taita (Kenya)", +dav: "Taita", +ta_IN: "Tamil (India)", +ta_LK: "Tamil (Sri Lanka)", +ta: "Tamil", +te_IN: "Telugu (India)", +te: "Telugu", +teo_KE: "Teso (Kenya)", +teo_UG: "Teso (Uganda)", +teo: "Teso", +th_TH: "Thai (Thailand)", +th: "Thai", +bo_CN: "Tibetan (China)", +bo_IN: "Tibetan (India)", +bo: "Tibetan", +ti_ER: "Tigrinya (Eritrea)", +ti_ET: "Tigrinya (Ethiopia)", +ti: "Tigrinya", +to_TO: "Tonga (Tonga)", +to: "Tonga", +tr_TR: "Turkish (Turkey)", +tr: "Turkish", +uk_UA: "Ukrainian (Ukraine)", +uk: "Ukrainian", +ur_IN: "Urdu (India)", +ur_PK: "Urdu (Pakistan)", +ur: "Urdu", +uz_Arab: "Uzbek (Arabic)", +uz_Arab_AF: "Uzbek (Arabic, Afghanistan)", +uz_Cyrl: "Uzbek (Cyrillic)", +uz_Cyrl_UZ: "Uzbek (Cyrillic, Uzbekistan)", +uz_Latn: "Uzbek (Latin)", +uz_Latn_UZ: "Uzbek (Latin, Uzbekistan)", +uz: "Uzbek", +vi_VN: "Vietnamese (Vietnam)", +vi: "Vietnamese", +vun_TZ: "Vunjo (Tanzania)", +vun: "Vunjo", +cy_GB: "Welsh (United Kingdom)", +cy: "Welsh", +yo_NG: "Yoruba (Nigeria)", +yo: "Yoruba", +zu_ZA: "Zulu (South Africa)", +zu: "Zulu" +``` + +%%[source: https://stackoverflow.com/a/28357857/5885921 ]%% \ No newline at end of file diff --git a/docs/userGuide/pages/timeZones.md b/docs/userGuide/pages/timeZones.md new file mode 100644 index 0000000000..07edaf191c --- /dev/null +++ b/docs/userGuide/pages/timeZones.md @@ -0,0 +1,352 @@ +```js +"Africa/Abidjan", +"Africa/Accra", +"Africa/Algiers", +"Africa/Bissau", +"Africa/Cairo", +"Africa/Casablanca", +"Africa/Ceuta", +"Africa/El_Aaiun", +"Africa/Johannesburg", +"Africa/Juba", +"Africa/Khartoum", +"Africa/Lagos", +"Africa/Maputo", +"Africa/Monrovia", +"Africa/Nairobi", +"Africa/Ndjamena", +"Africa/Sao_Tome", +"Africa/Tripoli", +"Africa/Tunis", +"Africa/Windhoek", +"America/Adak", +"America/Anchorage", +"America/Araguaina", +"America/Argentina/Buenos_Aires", +"America/Argentina/Catamarca", +"America/Argentina/Cordoba", +"America/Argentina/Jujuy", +"America/Argentina/La_Rioja", +"America/Argentina/Mendoza", +"America/Argentina/Rio_Gallegos", +"America/Argentina/Salta", +"America/Argentina/San_Juan", +"America/Argentina/San_Luis", +"America/Argentina/Tucuman", +"America/Argentina/Ushuaia", +"America/Asuncion", +"America/Atikokan", +"America/Bahia", +"America/Bahia_Banderas", +"America/Barbados", +"America/Belem", +"America/Belize", +"America/Blanc-Sablon", +"America/Boa_Vista", +"America/Bogota", +"America/Boise", +"America/Cambridge_Bay", +"America/Campo_Grande", +"America/Cancun", +"America/Caracas", +"America/Cayenne", +"America/Chicago", +"America/Chihuahua", +"America/Costa_Rica", +"America/Creston", +"America/Cuiaba", +"America/Curacao", +"America/Danmarkshavn", +"America/Dawson", +"America/Dawson_Creek", +"America/Denver", +"America/Detroit", +"America/Edmonton", +"America/Eirunepe", +"America/El_Salvador", +"America/Fort_Nelson", +"America/Fortaleza", +"America/Glace_Bay", +"America/Godthab", +"America/Goose_Bay", +"America/Grand_Turk", +"America/Guatemala", +"America/Guayaquil", +"America/Guyana", +"America/Halifax", +"America/Havana", +"America/Hermosillo", +"America/Indiana/Indianapolis", +"America/Indiana/Knox", +"America/Indiana/Marengo", +"America/Indiana/Petersburg", +"America/Indiana/Tell_City", +"America/Indiana/Vevay", +"America/Indiana/Vincennes", +"America/Indiana/Winamac", +"America/Inuvik", +"America/Iqaluit", +"America/Jamaica", +"America/Juneau", +"America/Kentucky/Louisville", +"America/Kentucky/Monticello", +"America/La_Paz", +"America/Lima", +"America/Los_Angeles", +"America/Maceio", +"America/Managua", +"America/Manaus", +"America/Martinique", +"America/Matamoros", +"America/Mazatlan", +"America/Menominee", +"America/Merida", +"America/Metlakatla", +"America/Mexico_City", +"America/Miquelon", +"America/Moncton", +"America/Monterrey", +"America/Montevideo", +"America/Nassau", +"America/New_York", +"America/Nipigon", +"America/Nome", +"America/Noronha", +"America/North_Dakota/Beulah", +"America/North_Dakota/Center", +"America/North_Dakota/New_Salem", +"America/Ojinaga", +"America/Panama", +"America/Pangnirtung", +"America/Paramaribo", +"America/Phoenix", +"America/Port-au-Prince", +"America/Port_of_Spain", +"America/Porto_Velho", +"America/Puerto_Rico", +"America/Punta_Arenas", +"America/Rainy_River", +"America/Rankin_Inlet", +"America/Recife", +"America/Regina", +"America/Resolute", +"America/Rio_Branco", +"America/Santarem", +"America/Santiago", +"America/Santo_Domingo", +"America/Sao_Paulo", +"America/Scoresbysund", +"America/Sitka", +"America/St_Johns", +"America/Swift_Current", +"America/Tegucigalpa", +"America/Thule", +"America/Thunder_Bay", +"America/Tijuana", +"America/Toronto", +"America/Vancouver", +"America/Whitehorse", +"America/Winnipeg", +"America/Yakutat", +"America/Yellowknife", +"Antarctica/Casey", +"Antarctica/Davis", +"Antarctica/DumontDUrville", +"Antarctica/Macquarie", +"Antarctica/Mawson", +"Antarctica/Palmer", +"Antarctica/Rothera", +"Antarctica/Syowa", +"Antarctica/Troll", +"Antarctica/Vostok", +"Asia/Almaty", +"Asia/Amman", +"Asia/Anadyr", +"Asia/Aqtau", +"Asia/Aqtobe", +"Asia/Ashgabat", +"Asia/Atyrau", +"Asia/Baghdad", +"Asia/Baku", +"Asia/Bangkok", +"Asia/Barnaul", +"Asia/Beirut", +"Asia/Bishkek", +"Asia/Brunei", +"Asia/Chita", +"Asia/Choibalsan", +"Asia/Colombo", +"Asia/Damascus", +"Asia/Dhaka", +"Asia/Dili", +"Asia/Dubai", +"Asia/Dushanbe", +"Asia/Famagusta", +"Asia/Gaza", +"Asia/Hebron", +"Asia/Ho_Chi_Minh", +"Asia/Hong_Kong", +"Asia/Hovd", +"Asia/Irkutsk", +"Asia/Jakarta", +"Asia/Jayapura", +"Asia/Jerusalem", +"Asia/Kabul", +"Asia/Kamchatka", +"Asia/Karachi", +"Asia/Kathmandu", +"Asia/Khandyga", +"Asia/Kolkata", +"Asia/Krasnoyarsk", +"Asia/Kuala_Lumpur", +"Asia/Kuching", +"Asia/Macau", +"Asia/Magadan", +"Asia/Makassar", +"Asia/Manila", +"Asia/Nicosia", +"Asia/Novokuznetsk", +"Asia/Novosibirsk", +"Asia/Omsk", +"Asia/Oral", +"Asia/Pontianak", +"Asia/Pyongyang", +"Asia/Qatar", +"Asia/Qostanay", +"Asia/Qyzylorda", +"Asia/Riyadh", +"Asia/Sakhalin", +"Asia/Samarkand", +"Asia/Seoul", +"Asia/Shanghai", +"Asia/Singapore", +"Asia/Srednekolymsk", +"Asia/Taipei", +"Asia/Tashkent", +"Asia/Tbilisi", +"Asia/Tehran", +"Asia/Thimphu", +"Asia/Tokyo", +"Asia/Tomsk", +"Asia/Ulaanbaatar", +"Asia/Urumqi", +"Asia/Ust-Nera", +"Asia/Vladivostok", +"Asia/Yakutsk", +"Asia/Yangon", +"Asia/Yekaterinburg", +"Asia/Yerevan", +"Atlantic/Azores", +"Atlantic/Bermuda", +"Atlantic/Canary", +"Atlantic/Cape_Verde", +"Atlantic/Faroe", +"Atlantic/Madeira", +"Atlantic/Reykjavik", +"Atlantic/South_Georgia", +"Atlantic/Stanley", +"Australia/Adelaide", +"Australia/Brisbane", +"Australia/Broken_Hill", +"Australia/Currie", +"Australia/Darwin", +"Australia/Eucla", +"Australia/Hobart", +"Australia/Lindeman", +"Australia/Lord_Howe", +"Australia/Melbourne", +"Australia/Perth", +"Australia/Sydney", +"Europe/Amsterdam", +"Europe/Andorra", +"Europe/Astrakhan", +"Europe/Athens", +"Europe/Belgrade", +"Europe/Berlin", +"Europe/Brussels", +"Europe/Bucharest", +"Europe/Budapest", +"Europe/Chisinau", +"Europe/Copenhagen", +"Europe/Dublin", +"Europe/Gibraltar", +"Europe/Helsinki", +"Europe/Istanbul", +"Europe/Kaliningrad", +"Europe/Kiev", +"Europe/Kirov", +"Europe/Lisbon", +"Europe/London", +"Europe/Luxembourg", +"Europe/Madrid", +"Europe/Malta", +"Europe/Minsk", +"Europe/Monaco", +"Europe/Moscow", +"Europe/Oslo", +"Europe/Paris", +"Europe/Prague", +"Europe/Riga", +"Europe/Rome", +"Europe/Samara", +"Europe/Saratov", +"Europe/Simferopol", +"Europe/Sofia", +"Europe/Stockholm", +"Europe/Tallinn", +"Europe/Tirane", +"Europe/Ulyanovsk", +"Europe/Uzhgorod", +"Europe/Vienna", +"Europe/Vilnius", +"Europe/Volgograd", +"Europe/Warsaw", +"Europe/Zaporozhye", +"Europe/Zurich", +"Indian/Chagos", +"Indian/Christmas", +"Indian/Cocos", +"Indian/Kerguelen", +"Indian/Mahe", +"Indian/Maldives", +"Indian/Mauritius", +"Indian/Reunion", +"Pacific/Apia", +"Pacific/Auckland", +"Pacific/Bougainville", +"Pacific/Chatham", +"Pacific/Chuuk", +"Pacific/Easter", +"Pacific/Efate", +"Pacific/Enderbury", +"Pacific/Fakaofo", +"Pacific/Fiji", +"Pacific/Funafuti", +"Pacific/Galapagos", +"Pacific/Gambier", +"Pacific/Guadalcanal", +"Pacific/Guam", +"Pacific/Honolulu", +"Pacific/Kiritimati", +"Pacific/Kosrae", +"Pacific/Kwajalein", +"Pacific/Majuro", +"Pacific/Marquesas", +"Pacific/Nauru", +"Pacific/Niue", +"Pacific/Norfolk", +"Pacific/Noumea", +"Pacific/Pago_Pago", +"Pacific/Palau", +"Pacific/Pitcairn", +"Pacific/Pohnpei", +"Pacific/Port_Moresby", +"Pacific/Rarotonga", +"Pacific/Tahiti", +"Pacific/Tarawa", +"Pacific/Tongatapu", +"Pacific/Wake", +"Pacific/Wallis" +``` + +%%[source: https://stackoverflow.com/a/54500197/5885921 ]%% \ No newline at end of file diff --git a/docs/userGuide/plugins/codeBlockCopyButtons.mbdf b/docs/userGuide/plugins/codeBlockCopyButtons.mbdf new file mode 100644 index 0000000000..4681894ab1 --- /dev/null +++ b/docs/userGuide/plugins/codeBlockCopyButtons.mbdf @@ -0,0 +1,20 @@ +#### `codeBlockCopyButtons`: Enabling code-blocks to be copied + +This plugin allows you to copy code in code-blocks on a button-click. + +To enable it, simply add `codeBlockCopyButtons` to your site's plugins. + +```js +site.json +{ + ... + "plugins": [ + "codeBlockCopyButtons" + ], +} +``` + +This is what it'll look like once added - + + + diff --git a/docs/userGuide/siteConfiguration.md b/docs/userGuide/siteConfiguration.md index 9d40769090..d83a7f1c6b 100644 --- a/docs/userGuide/siteConfiguration.md +++ b/docs/userGuide/siteConfiguration.md @@ -198,3 +198,24 @@ The example above uses tags as an example of configuring plugin settings, refer #### **`enableSearch`** **Specifies that the website should use MarkBind's search functionality.** Default: `true`. See [User Guide: Making the Site Searchable](makingTheSiteSearchable.html) for more details. + +#### **`timeZone`** + +**Time zone of the [time stamp](reusingContents.html#built-in-variable-timestamp).** Default: `"UTC"`. + + + + + +
+ +#### **`locale`** + +**Language by locale used for the [time stamp](reusingContents.html#built-in-variable-timestamp).** Default: `"en-GB"` (`English (United Kingdom)`).
+The date format is thus -
+`, , <24-hour Time>