From a7fb78a7faedee3de78fbe11cf731094210668d7 Mon Sep 17 00:00:00 2001 From: "translatewiki.net" Date: Thu, 30 Apr 2026 18:03:33 +0300 Subject: [PATCH 01/12] chore: Localisation updates from https://translatewiki.net (#9780) --- packages/blockly/msg/json/be-tarask.json | 2 +- packages/blockly/msg/json/bg.json | 25 +++++++++++++++++++++++- packages/blockly/msg/json/cs.json | 12 +++++++++++- packages/blockly/msg/json/ko.json | 22 ++++++++++----------- packages/blockly/msg/json/ps.json | 6 +++--- 5 files changed, 50 insertions(+), 17 deletions(-) diff --git a/packages/blockly/msg/json/be-tarask.json b/packages/blockly/msg/json/be-tarask.json index 538abd123..be31945fd 100644 --- a/packages/blockly/msg/json/be-tarask.json +++ b/packages/blockly/msg/json/be-tarask.json @@ -85,7 +85,7 @@ "CONTROLS_IF_MSG_ELSE": "інакш", "CONTROLS_IF_IF_TOOLTIP": "Дадаць, выдаліць ці пераставіць сэкцыі для пераканфігураваньня гэтага блёку «калі».", "CONTROLS_IF_ELSEIF_TOOLTIP": "Дадаць умову да блёку «калі».", - "CONTROLS_IF_ELSE_TOOLTIP": "Дадаць заключную ўмову для ўсіх астатніх варыянтаў блёку «калі».", + "CONTROLS_IF_ELSE_TOOLTIP": "Дадаць канцавую ўмову для ўсіх астатніх варыянтаў блёку «калі».", "LOGIC_COMPARE_HELPURL": "https://be-tarask.wikipedia.org/wiki/Няроўнасьць", "LOGIC_COMPARE_TOOLTIP_EQ": "Вяртае «ісьціна», калі абодва ўводы роўныя.", "LOGIC_COMPARE_TOOLTIP_NEQ": "Вяртае «ісьціна», калі абодва ўводы ня роўныя.", diff --git a/packages/blockly/msg/json/bg.json b/packages/blockly/msg/json/bg.json index 29f4d78be..bb389b3bc 100644 --- a/packages/blockly/msg/json/bg.json +++ b/packages/blockly/msg/json/bg.json @@ -26,6 +26,7 @@ "DELETE_X_BLOCKS": "Изтрий %1 блока", "DELETE_ALL_BLOCKS": "Изтриване на всички %1 блокове?", "CLEAN_UP": "Премахни блокове", + "CLOSE": "Затваряне", "COLLAPSE_BLOCK": "Скрий блок", "COLLAPSE_ALL": "Скрий блокове", "EXPAND_BLOCK": "Покажи блок", @@ -343,5 +344,27 @@ "WORKSPACE_ARIA_LABEL": "Работна област на Blockly", "COLLAPSED_WARNINGS_WARNING": "Свитите блокове съдържат предупреждения.", "DIALOG_OK": "ОК", - "DIALOG_CANCEL": "Отказ" + "DIALOG_CANCEL": "Отказ", + "EDIT_BLOCK_CONTENTS": "Редактиране на съдържанието на блока", + "MOVE_BLOCK": "Преместване на блок", + "WINDOWS": "Уиндоус", + "MAC_OS": "macOS", + "CHROME_OS": "ChromeOS", + "LINUX": "Линукс", + "UNKNOWN": "Неизвестно", + "CONTROL_KEY": "Ctrl", + "COMMAND_KEY": "⌘ Command", + "OPTION_KEY": "⌥ Option", + "ALT_KEY": "Alt", + "CUT_SHORTCUT": "Изрязване", + "COPY_SHORTCUT": "Копиране", + "PASTE_SHORTCUT": "Поставяне", + "HELP_PROMPT": "Натиснете %1 за помощ при управлението на клавиатурата", + "SHORTCUTS_GENERAL": "Общи", + "SHORTCUTS_EDITING": "Редактиране", + "SHORTCUTS_CODE_NAVIGATION": "Навигация по кода", + "KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "Задръжте %1 и използвайте клавишите със стрелки, за да се движите свободно, след това %2, за да приемете позицията", + "KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "Използвайте стрелките, за да се преместите, след това %1 да приемете позицията", + "KEYBOARD_NAV_COPIED_HINT": "Копирано. Натиснете %1, за да поставите.", + "KEYBOARD_NAV_CUT_HINT": "Изрязано. Натиснете %1, за да поставите." } diff --git a/packages/blockly/msg/json/cs.json b/packages/blockly/msg/json/cs.json index 2d2b59728..38a1b97e4 100644 --- a/packages/blockly/msg/json/cs.json +++ b/packages/blockly/msg/json/cs.json @@ -1,6 +1,7 @@ { "@metadata": { "authors": [ + "Aisacat", "Chmee2", "Clon", "Dita", @@ -28,7 +29,7 @@ "ADD_COMMENT": "Přidat komentář", "REMOVE_COMMENT": "Odstranit komentář", "DUPLICATE_COMMENT": "Duplikovat komentář", - "EXTERNAL_INPUTS": "vnější vstupy", + "EXTERNAL_INPUTS": "Vnější vstupy", "INLINE_INPUTS": "Vložené vstupy", "DELETE_BLOCK": "Smazat blok", "DELETE_X_BLOCKS": "Smazat %1 bloků", @@ -244,6 +245,12 @@ "TEXT_PROMPT_TYPE_NUMBER": "výzva k zadání čísla se zprávou", "TEXT_PROMPT_TOOLTIP_NUMBER": "Výzva pro uživatele k zadání čísla.", "TEXT_PROMPT_TOOLTIP_TEXT": "Výzva pro uživatele k zadání nějakého textu.", + "TEXT_COUNT_MESSAGE0": "počet výskytů %1 v %2", + "TEXT_COUNT_TOOLTIP": "Spočítat, kolikrát se daný text vyskytuje v jiném textu.", + "TEXT_REPLACE_MESSAGE0": "nahradit %1 za %2 v řetězci %3", + "TEXT_REPLACE_TOOLTIP": "Nahradit všechny výskyty daného textu v jiném textu.", + "TEXT_REVERSE_MESSAGE0": "obrátit %1", + "TEXT_REVERSE_TOOLTIP": "Obrátit pořadí znaků v textu.", "LISTS_CREATE_EMPTY_TITLE": "vytvořit prázdný seznam", "LISTS_CREATE_EMPTY_TOOLTIP": "Vrátí seznam nulové délky, který neobsahuje žádné datové záznamy", "LISTS_CREATE_WITH_TOOLTIP": "Vytvoř seznam s libovolným počtem položek.", @@ -313,6 +320,8 @@ "LISTS_SPLIT_WITH_DELIMITER": "s oddělovačem", "LISTS_SPLIT_TOOLTIP_SPLIT": "Rozdělit text do seznamu textů, lámání na oddělovačích.", "LISTS_SPLIT_TOOLTIP_JOIN": "Spojit seznam textů do jednoho textu, rozdělaného oddělovači.", + "LISTS_REVERSE_MESSAGE0": "obrátit %1", + "LISTS_REVERSE_TOOLTIP": "Obrátit kopii seznamu.", "VARIABLES_GET_TOOLTIP": "Vrátí hodnotu této proměnné.", "VARIABLES_GET_CREATE_SET": "Vytvořit \"nastavit %1\"", "VARIABLES_SET": "nastavit %1 na %2", @@ -341,6 +350,7 @@ "PROCEDURES_CREATE_DO": "Vytvořit '%1'", "PROCEDURES_IFRETURN_TOOLTIP": "Je-li hodnota pravda, pak vrátí druhou hodnotu.", "PROCEDURES_IFRETURN_WARNING": "Varování: Tento blok může být použit pouze uvnitř definici funkce.", + "COLLAPSED_WARNINGS_WARNING": "Sbalené bloky obsahují varování.", "DIALOG_OK": "OK", "DIALOG_CANCEL": "Zrušit", "WINDOWS": "Windows", diff --git a/packages/blockly/msg/json/ko.json b/packages/blockly/msg/json/ko.json index 6543954c7..aae384b83 100644 --- a/packages/blockly/msg/json/ko.json +++ b/packages/blockly/msg/json/ko.json @@ -82,24 +82,24 @@ "CONTROLS_REPEAT_TITLE": "%1회 반복", "CONTROLS_REPEAT_INPUT_DO": "하기", "CONTROLS_REPEAT_TOOLTIP": "여러 번 반복해 명령들을 실행합니다.", - "CONTROLS_WHILEUNTIL_HELPURL": "https://github.com/google/blockly/wiki/Loops#repeat", + "CONTROLS_WHILEUNTIL_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Loops#repeat", "CONTROLS_WHILEUNTIL_OPERATOR_WHILE": "동안 반복", "CONTROLS_WHILEUNTIL_OPERATOR_UNTIL": "다음까지 반복", "CONTROLS_WHILEUNTIL_TOOLTIP_WHILE": "값이 참일 때, 명령들을 실행합니다.", "CONTROLS_WHILEUNTIL_TOOLTIP_UNTIL": "값이 거짓인 동안 명령문을 실행합니다.", - "CONTROLS_FOR_HELPURL": "https://github.com/google/blockly/wiki/Loops#count-with", + "CONTROLS_FOR_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Loops#count-with", "CONTROLS_FOR_TOOLTIP": "변수 '%1'이(가) 지정된 간격으로 시작 번호에서 끝 번호까지 세는 동시에 지정된 블록을 실행하게 하세요.", "CONTROLS_FOR_TITLE": "으로 계산 %1 %2에서 %4을 이용하여 %3로", - "CONTROLS_FOREACH_HELPURL": "https://github.com/google/blockly/wiki/Loops#for-each", + "CONTROLS_FOREACH_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Loops#for-each", "CONTROLS_FOREACH_TITLE": "각 항목에 대해 %1 목록으로 %2", "CONTROLS_FOREACH_TOOLTIP": "리스트 안에 들어있는 각 아이템들을, 순서대로 변수 '%1' 에 한 번씩 저장시키고, 그 때 마다 명령을 실행합니다.", - "CONTROLS_FLOW_STATEMENTS_HELPURL": "https://github.com/google/blockly/wiki/Loops#loop-termination-blocks", + "CONTROLS_FLOW_STATEMENTS_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Loops#loop-termination-blocks", "CONTROLS_FLOW_STATEMENTS_OPERATOR_BREAK": "반복 중단", "CONTROLS_FLOW_STATEMENTS_OPERATOR_CONTINUE": "다음 반복", "CONTROLS_FLOW_STATEMENTS_TOOLTIP_BREAK": "현재 반복 실행 블럭을 빠져나갑니다.", "CONTROLS_FLOW_STATEMENTS_TOOLTIP_CONTINUE": "나머지 반복 부분을 더 이상 실행하지 않고, 다음 반복을 수행합니다.", "CONTROLS_FLOW_STATEMENTS_WARNING": "경고 : 이 블록은 반복 실행 블럭 안에서만 사용됩니다.", - "CONTROLS_IF_HELPURL": "https://ko.wikipedia.org/wiki/%EC%A1%B0%EA%B1%B4%EB%AC%B8", + "CONTROLS_IF_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/IfElse", "CONTROLS_IF_TOOLTIP_1": "조건식의 계산 결과가 참이면, 명령을 실행합니다.", "CONTROLS_IF_TOOLTIP_2": "조건식의 계산 결과가 참이면, 첫 번째 블럭의 명령을 실행하고, 그렇지 않으면 두 번째 블럭의 명령을 실행합니다.", "CONTROLS_IF_TOOLTIP_3": "첫 번째 조건식의 계산 결과가 참이면, 첫 번째 블럭의 명령을 실행하고, 두 번째 조건식의 계산 결과가 참이면, 두 번째 블럭의 명령을 실행합니다.", @@ -117,15 +117,15 @@ "LOGIC_COMPARE_TOOLTIP_LTE": "첫 번째 값이 두 번째 값보다 작거나 같으면, 참(true) 값을 돌려줍니다.", "LOGIC_COMPARE_TOOLTIP_GT": "첫 번째 값이 두 번째 값보다 크면, 참(true) 값을 돌려줍니다.", "LOGIC_COMPARE_TOOLTIP_GTE": "첫 번째 값이 두 번째 값보다 크거나 같으면, 참(true) 값을 돌려줍니다.", - "LOGIC_OPERATION_HELPURL": "https://github.com/google/blockly/wiki/Logic#logical-operations", + "LOGIC_OPERATION_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Logic#logical-operations", "LOGIC_OPERATION_TOOLTIP_AND": "두 값이 모두 참(true) 값이면, 참 값을 돌려줍니다.", "LOGIC_OPERATION_AND": "그리고", "LOGIC_OPERATION_TOOLTIP_OR": "적어도 하나의 값이 참일 경우 참을 반환합니다.", "LOGIC_OPERATION_OR": "또는", - "LOGIC_NEGATE_HELPURL": "https://github.com/google/blockly/wiki/Logic#not", + "LOGIC_NEGATE_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Logic#not", "LOGIC_NEGATE_TITLE": "%1가 아닙니다", "LOGIC_NEGATE_TOOLTIP": "입력값이 거짓이라면 참을 반환합니다. 참이라면 거짓을 반환합니다.", - "LOGIC_BOOLEAN_HELPURL": "https://github.com/google/blockly/wiki/Logic#values", + "LOGIC_BOOLEAN_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Logic#values", "LOGIC_BOOLEAN_TRUE": "참", "LOGIC_BOOLEAN_FALSE": "거짓", "LOGIC_BOOLEAN_TOOLTIP": "참 혹은 거짓 모두 반환합니다.", @@ -339,10 +339,10 @@ "LISTS_SPLIT_TOOLTIP_JOIN": "구분 기호로 구분하여 텍스트 목록을 하나의 텍스트에 병합합니다.", "LISTS_REVERSE_MESSAGE0": "%1 뒤집기", "LISTS_REVERSE_TOOLTIP": "리스트의 복사본을 뒤집습니다.", - "VARIABLES_GET_HELPURL": "https://github.com/google/blockly/wiki/Variables#get", + "VARIABLES_GET_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Variables#get", "VARIABLES_GET_TOOLTIP": "변수에 저장 되어있는 값을 돌려줍니다.", "VARIABLES_GET_CREATE_SET": "'집합 %1' 생성", - "VARIABLES_SET_HELPURL": "https://github.com/google/blockly/wiki/Variables#set", + "VARIABLES_SET_HELPURL": "https://github.com/RaspberryPiFoundation/blockly/wiki/Variables#set", "VARIABLES_SET": "%1를 %2로 설정", "VARIABLES_SET_TOOLTIP": "변수의 값을 입력한 값으로 변경해 줍니다.", "VARIABLES_SET_CREATE_GET": "'%1 값 읽기' 블럭 생성", @@ -351,7 +351,7 @@ "PROCEDURES_DEFNORETURN_PROCEDURE": "함수 이름", "PROCEDURES_BEFORE_PARAMS": "사용:", "PROCEDURES_CALL_BEFORE_PARAMS": "사용:", - "PROCEDURES_CALL_DISABLED_DEF_WARNING": "정의 블록이 비활성화되었기 때문에 사용자 정의 함수 '%1'를 실행할 수 없습니다.", + "PROCEDURES_CALL_DISABLED_DEF_WARNING": "정의 블록이 비활성화되었기 때문에 사용자 지정 함수 '%1'를 실행할 수 없습니다.", "PROCEDURES_DEFNORETURN_TOOLTIP": "실행 후, 결과 값을 돌려주지 않는 함수를 만듭니다.", "PROCEDURES_DEFNORETURN_COMMENT": "이 함수를 설명하세요...", "PROCEDURES_DEFRETURN_HELPURL": "https://ko.wikipedia.org/wiki/함수_(컴퓨터_과학)", diff --git a/packages/blockly/msg/json/ps.json b/packages/blockly/msg/json/ps.json index 55c892a60..3ceb3b1b8 100644 --- a/packages/blockly/msg/json/ps.json +++ b/packages/blockly/msg/json/ps.json @@ -9,8 +9,8 @@ "UNNAMED_KEY": "بې‌نومه", "TODAY": "نن", "DUPLICATE_BLOCK": "دوه‌گونی", - "ADD_COMMENT": "تبصره ورگډول", - "REMOVE_COMMENT": "تبصره غورځول", + "ADD_COMMENT": "څرگندونه ورگډول", + "REMOVE_COMMENT": "څرگندونه لرې‌کول", "DUPLICATE_COMMENT": "دوه‌گونې څرگندونه", "EXTERNAL_INPUTS": "باندنۍ ننوېستنې", "INLINE_INPUTS": "پرکرښه ننوېستنې", @@ -55,7 +55,7 @@ "MATH_TRIG_SIN": "سين", "MATH_TRIG_COS": "کاوسين", "MATH_TRIG_TAN": "تانجانت", - "TEXT_GET_SUBSTRING_INPUT_IN_TEXT": "په متن کې", + "TEXT_GET_SUBSTRING_INPUT_IN_TEXT": "په ليک کې", "LISTS_CREATE_WITH_CONTAINER_TITLE_ADD": "لړليک", "LISTS_ISEMPTY_TITLE": "%1 تش دی", "LISTS_GET_INDEX_GET": "ترلاسه کول", From 1e002dda33322a8d9fea33d1056598d915722fc9 Mon Sep 17 00:00:00 2001 From: "translatewiki.net" Date: Mon, 4 May 2026 16:57:30 +0300 Subject: [PATCH 02/12] chore: Localisation updates from https://translatewiki.net (#9809) --- packages/blockly/msg/json/ko.json | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/packages/blockly/msg/json/ko.json b/packages/blockly/msg/json/ko.json index aae384b83..bf13851fd 100644 --- a/packages/blockly/msg/json/ko.json +++ b/packages/blockly/msg/json/ko.json @@ -390,6 +390,12 @@ "CUT_SHORTCUT": "잘라내기", "COPY_SHORTCUT": "복사", "PASTE_SHORTCUT": "붙여넣기", + "HELP_PROMPT": "%1을 눌러 키보드 조작법에 대한 도움말 보기", "SHORTCUTS_GENERAL": "일반", - "SHORTCUTS_EDITING": "편집" + "SHORTCUTS_EDITING": "편집", + "SHORTCUTS_CODE_NAVIGATION": "코드 둘러보기", + "KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "%1 키를 누른 상태에서 화살표 키를 사용하여 자유롭게 이동한 다음, %2 키를 눌러 위치를 확정하세요", + "KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "화살표 키를 사용하여 이동한 다음, %1 키를 눌러 위치를 확정하세요", + "KEYBOARD_NAV_COPIED_HINT": "복사되었습니다. %1를 눌러 붙여넣으세요.", + "KEYBOARD_NAV_CUT_HINT": "잘라내었습니다. %1를 눌러 붙여넣으세요." } From 16bd030994e3a7847396abc5e03996910ed3de4c Mon Sep 17 00:00:00 2001 From: "translatewiki.net" Date: Thu, 7 May 2026 17:23:56 +0300 Subject: [PATCH 03/12] chore: Localisation updates from https://translatewiki.net (#9826) --- packages/blockly/msg/json/be-tarask.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/blockly/msg/json/be-tarask.json b/packages/blockly/msg/json/be-tarask.json index be31945fd..5caedb42e 100644 --- a/packages/blockly/msg/json/be-tarask.json +++ b/packages/blockly/msg/json/be-tarask.json @@ -146,9 +146,9 @@ "MATH_IS_PRIME": "простая", "MATH_IS_WHOLE": "цэлая", "MATH_IS_POSITIVE": "дадатная", - "MATH_IS_NEGATIVE": "адмоўная", + "MATH_IS_NEGATIVE": "нэґатыўны", "MATH_IS_DIVISIBLE_BY": "дзеліцца на", - "MATH_IS_TOOLTIP": "Правярае, ці зьяўляецца лік цотным, няцотным, простым, цэлым, дадатным, адмоўным, ці ён дзеліцца на пэўны лік. Вяртае значэньне ісьціна або няпраўда.", + "MATH_IS_TOOLTIP": "Правярае, ці зьяўляецца лік цотным, няцотным, простым, цэлым, дадатным, нэґатыўным, ці ён дзеліцца на пэўны лік. Вяртае значэньне ісьціна або няпраўда.", "MATH_CHANGE_TITLE": "зьмяніць %1 на %2", "MATH_CHANGE_TOOLTIP": "Дадае лічбу да зьменнай '%1'.", "MATH_ROUND_TOOLTIP": "Акругленьне ліку да большага ці меншага.", From c919d8849ef98690fba0cb6d63025ce932341b93 Mon Sep 17 00:00:00 2001 From: "translatewiki.net" Date: Mon, 18 May 2026 15:34:54 +0300 Subject: [PATCH 04/12] Localisation updates from https://translatewiki.net. (#9883) --- packages/blockly/msg/json/cs.json | 16 +++++++++++++++- packages/blockly/msg/json/fi.json | 8 +++++++- packages/blockly/msg/json/uk.json | 1 + 3 files changed, 23 insertions(+), 2 deletions(-) diff --git a/packages/blockly/msg/json/cs.json b/packages/blockly/msg/json/cs.json index 38a1b97e4..28feec2d3 100644 --- a/packages/blockly/msg/json/cs.json +++ b/packages/blockly/msg/json/cs.json @@ -11,6 +11,7 @@ "Georg101", "Ilimanaq29", "Koo6", + "Luckaper", "Matus cz", "Matěj Grabovský", "Mormegil", @@ -353,11 +354,24 @@ "COLLAPSED_WARNINGS_WARNING": "Sbalené bloky obsahují varování.", "DIALOG_OK": "OK", "DIALOG_CANCEL": "Zrušit", + "MOVE_BLOCK": "Přesunout blok", "WINDOWS": "Windows", "MAC_OS": "macOS", "CHROME_OS": "ChromeOS", "LINUX": "Linux", "UNKNOWN": "Neznámý", "CONTROL_KEY": "Ctrl", - "COMMAND_KEY": "⌘ Příkaz" + "COMMAND_KEY": "⌘ Příkaz", + "OPTION_KEY": "⌥ Možnost", + "ALT_KEY": "Alt", + "CUT_SHORTCUT": "Vyjmout", + "COPY_SHORTCUT": "Kopírovat", + "PASTE_SHORTCUT": "Vložit", + "HELP_PROMPT": "Stiskněte %1 pro nápovědu k ovládání pomocí klávesnice", + "SHORTCUTS_GENERAL": "Obecné", + "SHORTCUTS_EDITING": "Editace", + "KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "Podržte %1 k volnému pohybu pomocí šipek, poté pomocí %2 pozici potvrďte", + "KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "Použijte šipky k pohybu, poté stiskněte %1 pro potvrzení pozice", + "KEYBOARD_NAV_COPIED_HINT": "Zkopírováno. Stiskněte %1 pro vložení.", + "KEYBOARD_NAV_CUT_HINT": "Vyjmuto. Stiskněte %1 pro vložení." } diff --git a/packages/blockly/msg/json/fi.json b/packages/blockly/msg/json/fi.json index 361a51913..451eb36d4 100644 --- a/packages/blockly/msg/json/fi.json +++ b/packages/blockly/msg/json/fi.json @@ -365,6 +365,12 @@ "CUT_SHORTCUT": "Leikkaa", "COPY_SHORTCUT": "Kopioi", "PASTE_SHORTCUT": "Liitä", + "HELP_PROMPT": "Paina %1 saadaksesi ohjeita näppäinkomentoihin", "SHORTCUTS_GENERAL": "Yleinen", - "SHORTCUTS_EDITING": "Muokkaaminen" + "SHORTCUTS_EDITING": "Muokkaaminen", + "SHORTCUTS_CODE_NAVIGATION": "Koodin navigaatio", + "KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "Pidä %1 pohjassa ja käytä nuolinäppäimiä liikkuaksesi vapaasti, sitten paina %2 hyväksyäksesi sijainnin", + "KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "Käytä nuolinäppäimiä liikkuaksesi ja hyväksy sitten sijainti painamalla %1", + "KEYBOARD_NAV_COPIED_HINT": "Kopioitu. Liitä painamalla %1.", + "KEYBOARD_NAV_CUT_HINT": "Leikattu. Liitä painamalla %1." } diff --git a/packages/blockly/msg/json/uk.json b/packages/blockly/msg/json/uk.json index d880c758f..120d950e7 100644 --- a/packages/blockly/msg/json/uk.json +++ b/packages/blockly/msg/json/uk.json @@ -28,6 +28,7 @@ "DELETE_X_BLOCKS": "Видалити %1 блоків", "DELETE_ALL_BLOCKS": "Вилучити всі блоки %1?", "CLEAN_UP": "Очистити блоки", + "CLOSE": "Закрити", "COLLAPSE_BLOCK": "Згорнути блок", "COLLAPSE_ALL": "Згорнути блоки", "EXPAND_BLOCK": "Розгорнути блок", From ed4cc9be19b1a9437c83a2abc516ad64b237961e Mon Sep 17 00:00:00 2001 From: Michael Harvey <43474485+mikeharv@users.noreply.github.com> Date: Mon, 18 May 2026 08:35:22 -0400 Subject: [PATCH 05/12] chore: remove field-colour plugin blocks from normal toolbox (#9881) --- packages/blockly/tests/playground.html | 38 -------------------------- 1 file changed, 38 deletions(-) diff --git a/packages/blockly/tests/playground.html b/packages/blockly/tests/playground.html index 4ae723ce0..642a0991b 100644 --- a/packages/blockly/tests/playground.html +++ b/packages/blockly/tests/playground.html @@ -1228,44 +1228,6 @@ - - - - - - - 100 - - - - - 50 - - - - - 0 - - - - - - - #ff0000 - - - - - #3333ff - - - - - 0.5 - - - - Date: Wed, 20 May 2026 10:40:40 +0100 Subject: [PATCH 06/12] chore(docs): switch from GH Pages to CF Pages for deployment --- .github/workflows/deploy-docusaurus.yml | 50 ++++++++++++------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/.github/workflows/deploy-docusaurus.yml b/.github/workflows/deploy-docusaurus.yml index f9fd33471..2a7c16cc7 100644 --- a/.github/workflows/deploy-docusaurus.yml +++ b/.github/workflows/deploy-docusaurus.yml @@ -1,11 +1,19 @@ # .github/workflows/deploy-docusaurus.yml -# This workflow deploys the Blockly documentation to GitHub Pages. +# +# This workflow deploys the Blockly documentation to Cloudflare Pages. # Run this manually after a release to publish updated documentation. +# +# Prerequisites (one-off setup): +# 1. Create the Pages project in Cloudflare (Dashboard -> Workers & Pages -> Create +# -> Pages -> Direct Upload, or `npx wrangler pages project create blockly-docs`). +# 2. Add the following GitHub Actions secrets (Settings -> Secrets and variables -> Actions): +# - CLOUDFLARE_API_TOKEN (token with the "Cloudflare Pages: Edit" permission) +# - CLOUDFLARE_ACCOUNT_ID (the Cloudflare account ID) -name: Deploy Docusaurus to GitHub Pages +name: Deploy Docusaurus to Cloudflare Pages on: - # To run: GitHub -> Actions -> "Deploy Docusaurus to GitHub Pages" -> Run workflow + # To run: GitHub -> Actions -> "Deploy Docusaurus to Cloudflare Pages" -> Run workflow # Optionally set `ref` to the release branch/tag workflow_dispatch: inputs: @@ -15,23 +23,19 @@ on: default: "main" type: string -# Sets the permissions for the GITHUB_TOKEN to allow deployment to GitHub Pages permissions: contents: read - pages: write - id-token: write + deployments: write -# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued -# However, do not cancel in-progress runs as we want to allow these production deployments to complete concurrency: - group: "pages" + group: "cloudflare-pages" cancel-in-progress: false jobs: deploy: environment: - name: github-pages - url: ${{ steps.deployment.outputs.page_url }} + name: cloudflare-pages + url: ${{ steps.deployment.outputs.deployment-url }} runs-on: ubuntu-latest steps: - name: Checkout your repository @@ -61,19 +65,15 @@ jobs: working-directory: ./packages/docs run: npm run build env: - # When deploying to a subdirectory of your .github.io domain, the BASE_URL - # must be set to the name of the repo, go to your repo → Settings → Environments: - # Open the github-pages environment, under Environment variables, add: PAGES_BASE_URL - BASE_URL: ${{ vars.PAGES_BASE_URL || '/docs/' }} + # Override by setting the PAGES_BASE_URL repo variable (Settings -> Environments -> cloudflare-pages -> Environment variables) if docs are to be served from a subpath + BASE_URL: ${{ vars.PAGES_BASE_URL || '/' }} - - name: Setup GitHub Pages - uses: actions/configure-pages@v5 - - - name: Upload build artifact - uses: actions/upload-pages-artifact@v3 - with: - path: ./packages/docs/build - - - name: Deploy to GitHub Pages + - name: Deploy to Cloudflare Pages id: deployment - uses: actions/deploy-pages@v4 + uses: cloudflare/wrangler-action@v3 + with: + apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }} + accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }} + # `--branch=main` ensures this is published as a "Production" deployment in the Pages project regardless of which `ref` was checked out for the build + command: pages deploy ./packages/docs/build --project-name=blockly-docs --branch=main + gitHubToken: ${{ secrets.GITHUB_TOKEN }} From 4deaf37fdc62d3f39235f83459b0db9e81b7e2a4 Mon Sep 17 00:00:00 2001 From: Greg Annandale Date: Wed, 20 May 2026 10:41:06 +0100 Subject: [PATCH 07/12] chore(docs): remove unneeded client redirects, add server-side redirects --- package-lock.json | 25 ------------------------- packages/docs/docusaurus.config.js | 15 --------------- packages/docs/package.json | 1 - packages/docs/static/_redirects | 10 ++++++++++ 4 files changed, 10 insertions(+), 41 deletions(-) create mode 100644 packages/docs/static/_redirects diff --git a/package-lock.json b/package-lock.json index c066b4a92..f177b9cfb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -4108,30 +4108,6 @@ "react-dom": "*" } }, - "node_modules/@docusaurus/plugin-client-redirects": { - "version": "3.9.2", - "resolved": "https://registry.npmjs.org/@docusaurus/plugin-client-redirects/-/plugin-client-redirects-3.9.2.tgz", - "integrity": "sha512-lUgMArI9vyOYMzLRBUILcg9vcPTCyyI2aiuXq/4npcMVqOr6GfmwtmBYWSbNMlIUM0147smm4WhpXD0KFboffw==", - "license": "MIT", - "dependencies": { - "@docusaurus/core": "3.9.2", - "@docusaurus/logger": "3.9.2", - "@docusaurus/utils": "3.9.2", - "@docusaurus/utils-common": "3.9.2", - "@docusaurus/utils-validation": "3.9.2", - "eta": "^2.2.0", - "fs-extra": "^11.1.1", - "lodash": "^4.17.21", - "tslib": "^2.6.0" - }, - "engines": { - "node": ">=20.0" - }, - "peerDependencies": { - "react": "^18.0.0 || ^19.0.0", - "react-dom": "^18.0.0 || ^19.0.0" - } - }, "node_modules/@docusaurus/plugin-content-blog": { "version": "3.9.2", "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-blog/-/plugin-content-blog-3.9.2.tgz", @@ -29299,7 +29275,6 @@ "license": "Apache-2.0", "dependencies": { "@docusaurus/core": "3.9.2", - "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/preset-classic": "3.9.2", "@mdx-js/react": "^3.0.1", "clsx": "^2.1.1", diff --git a/packages/docs/docusaurus.config.js b/packages/docs/docusaurus.config.js index 7cce90805..abe15e604 100644 --- a/packages/docs/docusaurus.config.js +++ b/packages/docs/docusaurus.config.js @@ -35,21 +35,6 @@ const config = { locales: ['en'], }, - plugins: [ - [ - '@docusaurus/plugin-client-redirects', - { - fromExtensions: ['md', 'mdx'], - createRedirects(existingPath) { - if (existingPath.startsWith('/reference/')) { - return [existingPath.replace('/reference/', '/reference/js/')]; - } - return undefined; - }, - }, - ], - ], - presets: [ [ 'classic', diff --git a/packages/docs/package.json b/packages/docs/package.json index e62af97d0..8aa08f691 100644 --- a/packages/docs/package.json +++ b/packages/docs/package.json @@ -20,7 +20,6 @@ }, "dependencies": { "@docusaurus/core": "3.9.2", - "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/preset-classic": "3.9.2", "@mdx-js/react": "^3.0.1", "clsx": "^2.1.1", diff --git a/packages/docs/static/_redirects b/packages/docs/static/_redirects new file mode 100644 index 000000000..63a16db93 --- /dev/null +++ b/packages/docs/static/_redirects @@ -0,0 +1,10 @@ +# Cloudflare Pages Redirects +# Syntax: source destination [status_code] +# https://developers.cloudflare.com/pages/configuration/redirects/ + +# Legacy /reference/js/* paths redirect to canonical /reference/* URLs +/reference/js/* /reference/:splat 302 + +# Strip .md/.mdx extensions if someone lands on the raw filename +/reference/*.md /reference/:splat 302 +/reference/*.mdx /reference/:splat 302 From f4b45f96e80cb152b3d61215685c4fc8c43a58da Mon Sep 17 00:00:00 2001 From: Greg Annandale Date: Wed, 20 May 2026 10:45:57 +0100 Subject: [PATCH 08/12] chore(docs): remove gh-pages packages from docs devdependencies --- package-lock.json | 245 ------------------------------------- packages/docs/package.json | 1 - 2 files changed, 246 deletions(-) diff --git a/package-lock.json b/package-lock.json index f177b9cfb..47a8dcb7f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10797,13 +10797,6 @@ "integrity": "sha512-QE33hToZseCH3jS0qN96O/bSh3kaw/h+Tq7ngyY9eWDUnTlTNUyqfqvCXioLe5Na5jFsL78ra/wuBU4iuEgd4w==", "license": "ISC" }, - "node_modules/commondir": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz", - "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==", - "dev": true, - "license": "MIT" - }, "node_modules/compare-func": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", @@ -12655,13 +12648,6 @@ "integrity": "sha512-IbxXrsTlD3hRodkLnbxAPP4OuJYdWCeM3IOdT+CpcMoIwIoDfCmRpEtSPfwBXxVkg9xmBeY7Lz2Eo2TDn/HC3Q==", "license": "ISC" }, - "node_modules/email-addresses": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/email-addresses/-/email-addresses-5.0.0.tgz", - "integrity": "sha512-4OIPYlA6JXqtVn8zpHpGiI7vE6EQOAg16aGnDMIAlZVinnoZ8208tW1hAbjWydgN/4PLTT9q+O1K6AH/vALJGw==", - "dev": true, - "license": "MIT" - }, "node_modules/emoji-regex": { "version": "9.2.2", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", @@ -14046,34 +14032,6 @@ "url": "https://opencollective.com/webpack" } }, - "node_modules/filename-reserved-regex": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/filename-reserved-regex/-/filename-reserved-regex-2.0.0.tgz", - "integrity": "sha512-lc1bnsSr4L4Bdif8Xb/qrtokGbq5zlsms/CYH8PP+WtCkGNF65DPiQY8vG3SakEdRn8Dlnm+gW/qWKKjS5sZzQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=4" - } - }, - "node_modules/filenamify": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/filenamify/-/filenamify-4.3.0.tgz", - "integrity": "sha512-hcFKyUG57yWGAzu1CMt/dPzYZuv+jAJUT85bL8mrXvNe6hWj6yEHEc4EdcgiA6Z3oi1/9wXJdZPXF2dZNgwgOg==", - "dev": true, - "license": "MIT", - "dependencies": { - "filename-reserved-regex": "^2.0.0", - "strip-outer": "^1.0.1", - "trim-repeated": "^1.0.0" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/fill-range": { "version": "7.1.1", "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", @@ -14541,126 +14499,6 @@ "node": ">= 14" } }, - "node_modules/gh-pages": { - "version": "6.3.0", - "resolved": "https://registry.npmjs.org/gh-pages/-/gh-pages-6.3.0.tgz", - "integrity": "sha512-Ot5lU6jK0Eb+sszG8pciXdjMXdBJ5wODvgjR+imihTqsUWF2K6dJ9HST55lgqcs8wWcw6o6wAsUzfcYRhJPXbA==", - "dev": true, - "license": "MIT", - "dependencies": { - "async": "^3.2.4", - "commander": "^13.0.0", - "email-addresses": "^5.0.0", - "filenamify": "^4.3.0", - "find-cache-dir": "^3.3.1", - "fs-extra": "^11.1.1", - "globby": "^11.1.0" - }, - "bin": { - "gh-pages": "bin/gh-pages.js", - "gh-pages-clean": "bin/gh-pages-clean.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/gh-pages/node_modules/commander": { - "version": "13.1.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-13.1.0.tgz", - "integrity": "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=18" - } - }, - "node_modules/gh-pages/node_modules/find-cache-dir": { - "version": "3.3.2", - "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-3.3.2.tgz", - "integrity": "sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig==", - "dev": true, - "license": "MIT", - "dependencies": { - "commondir": "^1.0.1", - "make-dir": "^3.0.2", - "pkg-dir": "^4.1.0" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/avajs/find-cache-dir?sponsor=1" - } - }, - "node_modules/gh-pages/node_modules/find-up": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", - "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", - "dev": true, - "license": "MIT", - "dependencies": { - "locate-path": "^5.0.0", - "path-exists": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/gh-pages/node_modules/locate-path": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", - "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-locate": "^4.1.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/gh-pages/node_modules/p-limit": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", - "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-try": "^2.0.0" - }, - "engines": { - "node": ">=6" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/gh-pages/node_modules/p-locate": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", - "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-limit": "^2.2.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/gh-pages/node_modules/pkg-dir": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", - "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "find-up": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, "node_modules/git-raw-commits": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-5.0.1.tgz", @@ -17657,32 +17495,6 @@ "es5-ext": "~0.10.2" } }, - "node_modules/make-dir": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz", - "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==", - "dev": true, - "license": "MIT", - "dependencies": { - "semver": "^6.0.0" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/make-dir/node_modules/semver": { - "version": "6.3.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", - "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - } - }, "node_modules/map-cache": { "version": "0.2.2", "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz", @@ -21077,16 +20889,6 @@ "node": ">=8" } }, - "node_modules/p-try": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", - "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=6" - } - }, "node_modules/pac-proxy-agent": { "version": "7.2.0", "resolved": "https://registry.npmjs.org/pac-proxy-agent/-/pac-proxy-agent-7.2.0.tgz", @@ -25977,29 +25779,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/strip-outer": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/strip-outer/-/strip-outer-1.0.1.tgz", - "integrity": "sha512-k55yxKHwaXnpYGsOzg4Vl8+tDrWylxDEpknGjhTiZB8dFRU5rTo9CAzeycivxV3s+zlTKwrs6WxMxR95n26kwg==", - "dev": true, - "license": "MIT", - "dependencies": { - "escape-string-regexp": "^1.0.2" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/strip-outer/node_modules/escape-string-regexp": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", - "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.8.0" - } - }, "node_modules/strnum": { "version": "2.2.2", "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz", @@ -26571,29 +26350,6 @@ "url": "https://github.com/sponsors/wooorm" } }, - "node_modules/trim-repeated": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/trim-repeated/-/trim-repeated-1.0.0.tgz", - "integrity": "sha512-pkonvlKk8/ZuR0D5tLW8ljt5I8kmxp2XKymhepUeOdCEfKpZaktSArkLHZt76OB1ZvO9bssUsDty4SWhLvZpLg==", - "dev": true, - "license": "MIT", - "dependencies": { - "escape-string-regexp": "^1.0.2" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/trim-repeated/node_modules/escape-string-regexp": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", - "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.8.0" - } - }, "node_modules/trough": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", @@ -29290,7 +29046,6 @@ "@docusaurus/types": "3.9.2", "eslint": "9.36.0", "eslint-plugin-mdx": "^3.7.0", - "gh-pages": "^6.3.0", "prettier": "3.6.2" }, "engines": { diff --git a/packages/docs/package.json b/packages/docs/package.json index 8aa08f691..2550c5ce7 100644 --- a/packages/docs/package.json +++ b/packages/docs/package.json @@ -35,7 +35,6 @@ "@docusaurus/types": "3.9.2", "eslint": "9.36.0", "eslint-plugin-mdx": "^3.7.0", - "gh-pages": "^6.3.0", "prettier": "3.6.2" }, "browserslist": { From fee8c396ea428ca4596ff8b3bd063133dcae78ab Mon Sep 17 00:00:00 2001 From: "translatewiki.net" Date: Thu, 21 May 2026 18:15:15 +0300 Subject: [PATCH 09/12] Localisation updates from https://translatewiki.net. (#9917) --- packages/blockly/msg/json/nl.json | 4 ++-- packages/blockly/msg/json/uk.json | 8 ++++++++ 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/packages/blockly/msg/json/nl.json b/packages/blockly/msg/json/nl.json index bc23b8246..6267b9070 100644 --- a/packages/blockly/msg/json/nl.json +++ b/packages/blockly/msg/json/nl.json @@ -45,7 +45,7 @@ "REDO": "Opnieuw", "CHANGE_VALUE_TITLE": "Waarde wijzigen:", "RENAME_VARIABLE": "Variabele hernoemen...", - "RENAME_VARIABLE_TITLE": "Alle variabelen “%1” hernoemen tot:", + "RENAME_VARIABLE_TITLE": "Alle “%1”-variabelen hernoemen naar:", "NEW_VARIABLE": "Variabele maken...", "NEW_STRING_VARIABLE": "Tekstvariabele maken...", "NEW_NUMBER_VARIABLE": "Numeriek variabele maken...", @@ -373,7 +373,7 @@ "HELP_PROMPT": "Druk op %1 voor hulp bij toetsenbordbesturing", "SHORTCUTS_GENERAL": "Algemeen", "SHORTCUTS_EDITING": "Bewerken", - "SHORTCUTS_CODE_NAVIGATION": "Code-navigatie", + "SHORTCUTS_CODE_NAVIGATION": "Codenavigatie", "KEYBOARD_NAV_UNCONSTRAINED_MOVE_HINT": "Houd %1 ingedrukt en gebruik de pijltjestoetsen om vrij te bewegen, druk dan op %2 om de positie te accepteren", "KEYBOARD_NAV_CONSTRAINED_MOVE_HINT": "Gebruik de pijltjestoetsen om te bewegen, druk dan op %1 om de positie te accepteren", "KEYBOARD_NAV_COPIED_HINT": "Gekopieerd. Druk op %1 om te plakken.", diff --git a/packages/blockly/msg/json/uk.json b/packages/blockly/msg/json/uk.json index 120d950e7..2e3254297 100644 --- a/packages/blockly/msg/json/uk.json +++ b/packages/blockly/msg/json/uk.json @@ -49,6 +49,7 @@ "NEW_VARIABLE_TITLE": "Нова назва змінної:", "VARIABLE_ALREADY_EXISTS": "Змінна з назвою '%1' вже існує.", "VARIABLE_ALREADY_EXISTS_FOR_ANOTHER_TYPE": "Змінна з назвою '%1' вже існує в іншому типі: '%2'.", + "VARIABLE_ALREADY_EXISTS_FOR_A_PARAMETER": "Змінна з іменем '%1' вже існує як параметр у процедурі '%2'.", "DELETE_VARIABLE_CONFIRMATION": "Вилучити %1 використання змінної '%2'?", "CANNOT_DELETE_VARIABLE_PROCEDURE": "Неможливо видалити змінну '%1', тому що це частина визначення функції '%2'", "DELETE_VARIABLE": "Вилучити змінну '%1'", @@ -117,6 +118,12 @@ "LOGIC_TERNARY_TOOLTIP": "Перевіряє умову в 'тест'. Якщо умова істинна, то повертає значення 'якщо істина'; в іншому випадку повертає значення 'якщо хибність'.", "MATH_NUMBER_HELPURL": "https://uk.wikipedia.org/wiki/Число", "MATH_NUMBER_TOOLTIP": "Число.", + "MATH_TRIG_SIN": "sin", + "MATH_TRIG_COS": "cos", + "MATH_TRIG_TAN": "tan", + "MATH_TRIG_ASIN": "arcsin", + "MATH_TRIG_ACOS": "arccos", + "MATH_TRIG_ATAN": "arctan", "MATH_ARITHMETIC_HELPURL": "https://uk.wikipedia.org/wiki/Арифметика", "MATH_ARITHMETIC_TOOLTIP_ADD": "Повертає суму двох чисел.", "MATH_ARITHMETIC_TOOLTIP_MINUS": "Повертає різницю двох чисел.", @@ -320,6 +327,7 @@ "PROCEDURES_DEFNORETURN_PROCEDURE": "щось зробити", "PROCEDURES_BEFORE_PARAMS": "з:", "PROCEDURES_CALL_BEFORE_PARAMS": "з:", + "PROCEDURES_CALL_DISABLED_DEF_WARNING": "Не вдається запустити користувацьку функцію '%1', оскільки блок визначення вимкнено.", "PROCEDURES_DEFNORETURN_TOOLTIP": "Створює функцію без виводу.", "PROCEDURES_DEFNORETURN_COMMENT": "Опишіть цю функцію...", "PROCEDURES_DEFRETURN_HELPURL": "https://uk.wikipedia.org/wiki/Підпрограма", From 00cacc4d6f184f1bda6f1dbc169074c0869fb0ee Mon Sep 17 00:00:00 2001 From: Maribeth Moffatt Date: Fri, 22 May 2026 15:45:09 -0400 Subject: [PATCH 10/12] chore: fix some problems with docs site (#9928) * update api-documenter versions and patch * fix: update sidebar generation * fix: docusaurus config changes * fix: remove unnecessary slugs * chore: fix url redirects with md suffix --- package-lock.json | 542 +++--------------- package.json | 3 +- packages/blockly/package.json | 5 +- .../blockly/scripts/gulpfiles/docs_tasks.mjs | 41 +- .../add-a-context-menu-item.mdx | 1 - .../codelabs/context-menu-option/callback.mdx | 1 - .../context-menu-option/codelab-overview.mdx | 1 - .../context-menu-option/display-text.mdx | 1 - .../precondition-blockly-state.mdx | 1 - .../precondition-external-state.mdx | 1 - .../precondition-node-type.mdx | 1 - .../context-menu-option/separators.mdx | 1 - .../codelabs/context-menu-option/setup.mdx | 1 - .../codelabs/context-menu-option/summary.mdx | 1 - .../context-menu-option/weight-and-id.mdx | 1 - packages/docs/docs/codelabs/css/blocks.mdx | 1 - .../docs/docs/codelabs/css/categories.mdx | 1 - .../docs/codelabs/css/codelab-overview.mdx | 1 - .../docs/docs/codelabs/css/components.mdx | 1 - packages/docs/docs/codelabs/css/setup.mdx | 1 - packages/docs/docs/codelabs/css/summary.mdx | 1 - packages/docs/docs/codelabs/css/tour.mdx | 1 - .../array-block-generator.mdx | 1 - .../block-generator-overview.mdx | 1 - .../custom-generator/codelab-overview.mdx | 1 - .../custom-generator/generating-a-stack.mdx | 1 - .../member-block-generator.mdx | 1 - .../object-block-generator.mdx | 1 - .../docs/codelabs/custom-generator/setup.mdx | 1 - .../codelabs/custom-generator/summary.mdx | 1 - .../codelabs/custom-generator/the-basics.mdx | 1 - .../value-block-generators.mdx | 1 - .../change-connection-shapes.mdx | 1 - .../custom-renderer/codelab-overview.mdx | 1 - .../define-and-register-a-custom-renderer.mdx | 1 - .../observe-the-built-in-renderers.mdx | 1 - .../custom-renderer/override-constants.mdx | 1 - .../docs/codelabs/custom-renderer/setup.mdx | 1 - .../docs/codelabs/custom-renderer/summary.mdx | 1 - .../typed-connection-shapes.mdx | 1 - .../understand-connection-shapes.mdx | 1 - .../add-an-icon-to-your-category.mdx | 1 - .../adding-a-custom-toolbox-item.mdx | 1 - .../change-the-category-HTML.mdx | 1 - .../change-the-look-of-a-category.mdx | 1 - ...change-the-look-of-a-selected-category.mdx | 1 - .../custom-toolbox/codelab-overview.mdx | 1 - .../docs/codelabs/custom-toolbox/setup.mdx | 1 - .../docs/codelabs/custom-toolbox/summary.mdx | 1 - .../getting-started/add-blockly-libraries.mdx | 1 - .../getting-started/codelab-overview.mdx | 1 - .../create-a-blockly-workspace.mdx | 1 - .../getting-started/create-a-custom-block.mdx | 1 - .../getting-started/explore-the-app.mdx | 1 - .../generate-javaScript-code.mdx | 1 - .../getting-started/run-generated-code.mdx | 1 - .../getting-started/save-load-workspace.mdx | 1 - .../docs/codelabs/getting-started/setup.mdx | 1 - .../docs/codelabs/getting-started/the-end.mdx | 1 - packages/docs/docs/codelabs/index.mdx | 1 - .../codelab-overview.mdx | 1 - .../customize-block-styles.mdx | 1 - .../customize-category-styles.mdx | 1 - .../customize-components.mdx | 1 - .../theme-extension-identifier/setup.mdx | 1 - .../theme-extension-identifier/summary.mdx | 1 - .../workspace-theme.mdx | 1 - .../codelab-overview.mdx | 1 - .../displaying-warnings.mdx | 1 - .../validation-and-warnings/setup.mdx | 1 - .../validation-and-warnings/summary.mdx | 1 - .../validating-blocks.mdx | 1 - .../docs/guides/contribute/core/index.mdx | 1 - .../guides/contribute/get-started/index.mdx | 9 +- .../get-started/write_a_good_issue.mdx | 2 +- .../docs/docs/guides/contribute/index.mdx | 7 +- .../contribute/samples/block_factory.mdx | 2 +- .../docs/guides/contribute/samples/index.mdx | 1 - .../guides/programming/forking_blockly.mdx | 2 +- packages/docs/docusaurus.config.js | 9 +- packages/docs/static/_redirects | 15 +- .../@microsoft+api-documenter+7.22.4.patch | 76 --- .../@microsoft+api-documenter+7.28.2.patch | 80 --- ...ft+api-documenter+7.30.5+001+initial.patch | 161 ++++++ 84 files changed, 292 insertions(+), 732 deletions(-) delete mode 100644 patches/@microsoft+api-documenter+7.22.4.patch delete mode 100644 patches/@microsoft+api-documenter+7.28.2.patch create mode 100644 patches/@microsoft+api-documenter+7.30.5+001+initial.patch diff --git a/package-lock.json b/package-lock.json index 47a8dcb7f..2e1311e92 100644 --- a/package-lock.json +++ b/package-lock.json @@ -7,6 +7,7 @@ "": { "name": "blockly-repo", "version": "0.0.0", + "hasInstallScript": true, "license": "Apache-2.0", "workspaces": [ "packages/*" @@ -5688,57 +5689,42 @@ } }, "node_modules/@microsoft/api-documenter": { - "version": "7.22.4", - "resolved": "https://registry.npmjs.org/@microsoft/api-documenter/-/api-documenter-7.22.4.tgz", - "integrity": "sha512-d4htEhBd8UkFKff/+/nAi/z7rrspm1DanFmsRHLUp4gKMo/8hYDH/IQBWB4r9X/8X72jCv3I++VVWAfichL1rw==", + "version": "7.30.5", + "resolved": "https://registry.npmjs.org/@microsoft/api-documenter/-/api-documenter-7.30.5.tgz", + "integrity": "sha512-Ui+QDj54dMGvAfVJ3D4wmIW3sfsvgXohPvlnMqIrZPGM3dVBjqnC3g/8oG4Mue+Kui/JwRom5YpZgTnVjcKNdg==", "dev": true, "license": "MIT", "dependencies": { - "@microsoft/api-extractor-model": "7.26.8", - "@microsoft/tsdoc": "0.14.2", - "@rushstack/node-core-library": "3.58.0", - "@rushstack/ts-command-line": "4.13.2", - "colors": "~1.2.1", - "js-yaml": "~3.13.1", + "@microsoft/api-extractor-model": "7.33.8", + "@microsoft/tsdoc": "~0.16.0", + "@rushstack/node-core-library": "5.23.1", + "@rushstack/terminal": "0.24.0", + "@rushstack/ts-command-line": "5.3.9", + "js-yaml": "~4.1.0", "resolve": "~1.22.1" }, "bin": { "api-documenter": "bin/api-documenter" } }, - "node_modules/@microsoft/api-documenter/node_modules/js-yaml": { - "version": "3.13.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.13.1.tgz", - "integrity": "sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==", - "dev": true, - "license": "MIT", - "dependencies": { - "argparse": "^1.0.7", - "esprima": "^4.0.0" - }, - "bin": { - "js-yaml": "bin/js-yaml.js" - } - }, "node_modules/@microsoft/api-extractor": { - "version": "7.58.0", - "resolved": "https://registry.npmjs.org/@microsoft/api-extractor/-/api-extractor-7.58.0.tgz", - "integrity": "sha512-XcHlDylX5GblbGbs1eBoexjVyvdJMioTPuBCgCorE2rqijzTYxi6eudXyez3xACRxtH9aDtahoL9fYM4XTvQmg==", + "version": "7.58.7", + "resolved": "https://registry.npmjs.org/@microsoft/api-extractor/-/api-extractor-7.58.7.tgz", + "integrity": "sha512-yK6OycD46gIzLRpj6ueVUWPk1ACSpkN1LBo05gY1qPTylbWyUCanXfH7+VgkI5LJrJoRSQR5F04XuCffCXLOBw==", "dev": true, "license": "MIT", "dependencies": { - "@microsoft/api-extractor-model": "7.33.5", + "@microsoft/api-extractor-model": "7.33.8", "@microsoft/tsdoc": "~0.16.0", "@microsoft/tsdoc-config": "~0.18.1", - "@rushstack/node-core-library": "5.21.0", - "@rushstack/rig-package": "0.7.2", - "@rushstack/terminal": "0.22.4", - "@rushstack/ts-command-line": "5.3.4", + "@rushstack/node-core-library": "5.23.1", + "@rushstack/rig-package": "0.7.3", + "@rushstack/terminal": "0.24.0", + "@rushstack/ts-command-line": "5.3.9", "diff": "~8.0.2", - "lodash": "~4.17.23", "minimatch": "10.2.3", "resolve": "~1.22.1", - "semver": "~7.5.4", + "semver": "~7.7.4", "source-map": "~0.6.1", "typescript": "5.9.3" }, @@ -5747,177 +5733,15 @@ } }, "node_modules/@microsoft/api-extractor-model": { - "version": "7.26.8", - "resolved": "https://registry.npmjs.org/@microsoft/api-extractor-model/-/api-extractor-model-7.26.8.tgz", - "integrity": "sha512-ESj3bBJkiMg/8tS0PW4+2rUgTVwOEfy41idTnFgdbVX+O50bN6S99MV6FIPlCZWCnRDcBfwxRXLdAkOQQ0JqGw==", - "dev": true, - "license": "MIT", - "dependencies": { - "@microsoft/tsdoc": "0.14.2", - "@microsoft/tsdoc-config": "~0.16.1", - "@rushstack/node-core-library": "3.58.0" - } - }, - "node_modules/@microsoft/api-extractor-model/node_modules/@microsoft/tsdoc-config": { - "version": "0.16.2", - "resolved": "https://registry.npmjs.org/@microsoft/tsdoc-config/-/tsdoc-config-0.16.2.tgz", - "integrity": "sha512-OGiIzzoBLgWWR0UdRJX98oYO+XKGf7tiK4Zk6tQ/E4IJqGCe7dvkTvgDZV5cFJUzLGDOjeAXrnZoA6QkVySuxw==", - "dev": true, - "license": "MIT", - "dependencies": { - "@microsoft/tsdoc": "0.14.2", - "ajv": "~6.12.6", - "jju": "~1.4.0", - "resolve": "~1.19.0" - } - }, - "node_modules/@microsoft/api-extractor-model/node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", - "dev": true, - "license": "MIT", - "dependencies": { - "fast-deep-equal": "^3.1.1", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.4.1", - "uri-js": "^4.2.2" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/epoberezkin" - } - }, - "node_modules/@microsoft/api-extractor-model/node_modules/json-schema-traverse": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", - "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true, - "license": "MIT" - }, - "node_modules/@microsoft/api-extractor-model/node_modules/resolve": { - "version": "1.19.0", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.19.0.tgz", - "integrity": "sha512-rArEXAgsBG4UgRGcynxWIWKFvh/XZCcS8UJdHhwy91zwAvCZIbcs+vAbflgBnNjYMs/i/i+/Ux6IZhML1yPvxg==", - "dev": true, - "license": "MIT", - "dependencies": { - "is-core-module": "^2.1.0", - "path-parse": "^1.0.6" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/@microsoft/api-extractor/node_modules/@microsoft/api-extractor-model": { - "version": "7.33.5", - "resolved": "https://registry.npmjs.org/@microsoft/api-extractor-model/-/api-extractor-model-7.33.5.tgz", - "integrity": "sha512-Xh4dXuusndVQqVz4nEN9xOp0DyzsKxeD2FFJkSPg4arAjDSKPcy6cAc7CaeBPA7kF2wV1fuDlo2p/bNMpVr8yg==", + "version": "7.33.8", + "resolved": "https://registry.npmjs.org/@microsoft/api-extractor-model/-/api-extractor-model-7.33.8.tgz", + "integrity": "sha512-aIcoQggPyer3B6Ze3usz0YWC/oBwUHfRH5ETUsr+oT2BRA6SfTJl7IKPcPZkX4UR+PohowzW4uMxsvjrn8vm+w==", "dev": true, "license": "MIT", "dependencies": { "@microsoft/tsdoc": "~0.16.0", "@microsoft/tsdoc-config": "~0.18.1", - "@rushstack/node-core-library": "5.21.0" - } - }, - "node_modules/@microsoft/api-extractor/node_modules/@microsoft/tsdoc": { - "version": "0.16.0", - "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.16.0.tgz", - "integrity": "sha512-xgAyonlVVS+q7Vc7qLW0UrJU7rSFcETRWsqdXZtjzRU8dF+6CkozTK4V4y1LwOX7j8r/vHphjDeMeGI4tNGeGA==", - "dev": true, - "license": "MIT" - }, - "node_modules/@microsoft/api-extractor/node_modules/@rushstack/node-core-library": { - "version": "5.21.0", - "resolved": "https://registry.npmjs.org/@rushstack/node-core-library/-/node-core-library-5.21.0.tgz", - "integrity": "sha512-LFzN+1lyWROit/P8Md6yxAth7lLYKn37oCKJHirEE2TQB25NDUM7bALf0ar+JAtwFfRCH+D+DGOA7DAzIi2r+g==", - "dev": true, - "license": "MIT", - "dependencies": { - "ajv": "~8.18.0", - "ajv-draft-04": "~1.0.0", - "ajv-formats": "~3.0.1", - "fs-extra": "~11.3.0", - "import-lazy": "~4.0.0", - "jju": "~1.4.0", - "resolve": "~1.22.1", - "semver": "~7.5.4" - }, - "peerDependencies": { - "@types/node": "*" - }, - "peerDependenciesMeta": { - "@types/node": { - "optional": true - } - } - }, - "node_modules/@microsoft/api-extractor/node_modules/@rushstack/ts-command-line": { - "version": "5.3.4", - "resolved": "https://registry.npmjs.org/@rushstack/ts-command-line/-/ts-command-line-5.3.4.tgz", - "integrity": "sha512-MLkVKVEN6/2clKTrjN2B2KqKCuPxRwnNsWY7a+FCAq2EMdkj10cM8YgiBSMeGFfzM0mDMzargpHNnNzaBi9Whg==", - "dev": true, - "license": "MIT", - "dependencies": { - "@rushstack/terminal": "0.22.4", - "@types/argparse": "1.0.38", - "argparse": "~1.0.9", - "string-argv": "~0.3.1" - } - }, - "node_modules/@microsoft/api-extractor/node_modules/ajv-formats": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", - "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "ajv": "^8.0.0" - }, - "peerDependencies": { - "ajv": "^8.0.0" - }, - "peerDependenciesMeta": { - "ajv": { - "optional": true - } - } - }, - "node_modules/@microsoft/api-extractor/node_modules/lodash": { - "version": "4.17.23", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", - "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", - "dev": true, - "license": "MIT" - }, - "node_modules/@microsoft/api-extractor/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "dev": true, - "license": "ISC", - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/@microsoft/api-extractor/node_modules/semver": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", - "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", - "dev": true, - "license": "ISC", - "dependencies": { - "lru-cache": "^6.0.0" - }, - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" + "@rushstack/node-core-library": "5.23.1" } }, "node_modules/@microsoft/api-extractor/node_modules/source-map": { @@ -5930,17 +5754,10 @@ "node": ">=0.10.0" } }, - "node_modules/@microsoft/api-extractor/node_modules/yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", - "dev": true, - "license": "ISC" - }, "node_modules/@microsoft/tsdoc": { - "version": "0.14.2", - "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.14.2.tgz", - "integrity": "sha512-9b8mPpKrfeGRuhFH5iO1iwCLeIIsV6+H1sRfxbkoGXIyQE2BTsPd9zqSqQJ+pv5sJ/hT5M1zvOFL02MnEezFug==", + "version": "0.16.0", + "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.16.0.tgz", + "integrity": "sha512-xgAyonlVVS+q7Vc7qLW0UrJU7rSFcETRWsqdXZtjzRU8dF+6CkozTK4V4y1LwOX7j8r/vHphjDeMeGI4tNGeGA==", "dev": true, "license": "MIT" }, @@ -5957,13 +5774,6 @@ "resolve": "~1.22.2" } }, - "node_modules/@microsoft/tsdoc-config/node_modules/@microsoft/tsdoc": { - "version": "0.16.0", - "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.16.0.tgz", - "integrity": "sha512-xgAyonlVVS+q7Vc7qLW0UrJU7rSFcETRWsqdXZtjzRU8dF+6CkozTK4V4y1LwOX7j8r/vHphjDeMeGI4tNGeGA==", - "dev": true, - "license": "MIT" - }, "node_modules/@noble/hashes": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz", @@ -6761,150 +6571,9 @@ } }, "node_modules/@rushstack/node-core-library": { - "version": "3.58.0", - "resolved": "https://registry.npmjs.org/@rushstack/node-core-library/-/node-core-library-3.58.0.tgz", - "integrity": "sha512-DHAZ3LTOEq2/EGURznpTJDnB3SNE2CKMDXuviQ6afhru6RykE3QoqXkeyjbpLb5ib5cpIRCPE/wykNe0xmQj3w==", - "dev": true, - "license": "MIT", - "dependencies": { - "colors": "~1.2.1", - "fs-extra": "~7.0.1", - "import-lazy": "~4.0.0", - "jju": "~1.4.0", - "resolve": "~1.22.1", - "semver": "~7.3.0", - "z-schema": "~5.0.2" - }, - "peerDependencies": { - "@types/node": "*" - }, - "peerDependenciesMeta": { - "@types/node": { - "optional": true - } - } - }, - "node_modules/@rushstack/node-core-library/node_modules/fs-extra": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz", - "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==", - "dev": true, - "license": "MIT", - "dependencies": { - "graceful-fs": "^4.1.2", - "jsonfile": "^4.0.0", - "universalify": "^0.1.0" - }, - "engines": { - "node": ">=6 <7 || >=8" - } - }, - "node_modules/@rushstack/node-core-library/node_modules/jsonfile": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz", - "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", - "dev": true, - "license": "MIT", - "optionalDependencies": { - "graceful-fs": "^4.1.6" - } - }, - "node_modules/@rushstack/node-core-library/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "dev": true, - "license": "ISC", - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/@rushstack/node-core-library/node_modules/semver": { - "version": "7.3.8", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.8.tgz", - "integrity": "sha512-NB1ctGL5rlHrPJtFDVIVzTyQylMLu9N9VICA6HSFJo8MCGVTMW6gfpicwKmmK/dAjTOrqu5l63JJOpDSrAis3A==", - "dev": true, - "license": "ISC", - "dependencies": { - "lru-cache": "^6.0.0" - }, - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/@rushstack/node-core-library/node_modules/universalify": { - "version": "0.1.2", - "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz", - "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 4.0.0" - } - }, - "node_modules/@rushstack/node-core-library/node_modules/yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", - "dev": true, - "license": "ISC" - }, - "node_modules/@rushstack/problem-matcher": { - "version": "0.2.1", - "resolved": "https://registry.npmjs.org/@rushstack/problem-matcher/-/problem-matcher-0.2.1.tgz", - "integrity": "sha512-gulfhBs6n+I5b7DvjKRfhMGyUejtSgOHTclF/eONr8hcgF1APEDjhxIsfdUYYMzC3rvLwGluqLjbwCFZ8nxrog==", - "dev": true, - "license": "MIT", - "peerDependencies": { - "@types/node": "*" - }, - "peerDependenciesMeta": { - "@types/node": { - "optional": true - } - } - }, - "node_modules/@rushstack/rig-package": { - "version": "0.7.2", - "resolved": "https://registry.npmjs.org/@rushstack/rig-package/-/rig-package-0.7.2.tgz", - "integrity": "sha512-9XbFWuqMYcHUso4mnETfhGVUSaADBRj6HUAAEYk50nMPn8WRICmBuCphycQGNB3duIR6EEZX3Xj3SYc2XiP+9A==", - "dev": true, - "license": "MIT", - "dependencies": { - "resolve": "~1.22.1", - "strip-json-comments": "~3.1.1" - } - }, - "node_modules/@rushstack/terminal": { - "version": "0.22.4", - "resolved": "https://registry.npmjs.org/@rushstack/terminal/-/terminal-0.22.4.tgz", - "integrity": "sha512-fhtLjnXCc/4WleVbVl6aoc7jcWnU6yqjS1S8WoaNREG3ycu/viZ9R/9QM7Y/b4CDvcXoiDyMNIay7JMwBptM3g==", - "dev": true, - "license": "MIT", - "dependencies": { - "@rushstack/node-core-library": "5.21.0", - "@rushstack/problem-matcher": "0.2.1", - "supports-color": "~8.1.1" - }, - "peerDependencies": { - "@types/node": "*" - }, - "peerDependenciesMeta": { - "@types/node": { - "optional": true - } - } - }, - "node_modules/@rushstack/terminal/node_modules/@rushstack/node-core-library": { - "version": "5.21.0", - "resolved": "https://registry.npmjs.org/@rushstack/node-core-library/-/node-core-library-5.21.0.tgz", - "integrity": "sha512-LFzN+1lyWROit/P8Md6yxAth7lLYKn37oCKJHirEE2TQB25NDUM7bALf0ar+JAtwFfRCH+D+DGOA7DAzIi2r+g==", + "version": "5.23.1", + "resolved": "https://registry.npmjs.org/@rushstack/node-core-library/-/node-core-library-5.23.1.tgz", + "integrity": "sha512-wlKmIKIYCKuCASbITvOxLZXepPbwXvrv7S6ig6XNWFchSyhL/E2txmVXspHY49Wu2dzf7nI27a2k/yV5BA3EiA==", "dev": true, "license": "MIT", "dependencies": { @@ -6915,7 +6584,7 @@ "import-lazy": "~4.0.0", "jju": "~1.4.0", "resolve": "~1.22.1", - "semver": "~7.5.4" + "semver": "~7.7.4" }, "peerDependencies": { "@types/node": "*" @@ -6926,7 +6595,7 @@ } } }, - "node_modules/@rushstack/terminal/node_modules/ajv-formats": { + "node_modules/@rushstack/node-core-library/node_modules/ajv-formats": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", @@ -6944,52 +6613,62 @@ } } }, - "node_modules/@rushstack/terminal/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", + "node_modules/@rushstack/problem-matcher": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/@rushstack/problem-matcher/-/problem-matcher-0.2.1.tgz", + "integrity": "sha512-gulfhBs6n+I5b7DvjKRfhMGyUejtSgOHTclF/eONr8hcgF1APEDjhxIsfdUYYMzC3rvLwGluqLjbwCFZ8nxrog==", "dev": true, - "license": "ISC", - "dependencies": { - "yallist": "^4.0.0" + "license": "MIT", + "peerDependencies": { + "@types/node": "*" }, - "engines": { - "node": ">=10" + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } } }, - "node_modules/@rushstack/terminal/node_modules/semver": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", - "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", - "dev": true, - "license": "ISC", - "dependencies": { - "lru-cache": "^6.0.0" - }, - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/@rushstack/terminal/node_modules/yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", - "dev": true, - "license": "ISC" - }, - "node_modules/@rushstack/ts-command-line": { - "version": "4.13.2", - "resolved": "https://registry.npmjs.org/@rushstack/ts-command-line/-/ts-command-line-4.13.2.tgz", - "integrity": "sha512-bCU8qoL9HyWiciltfzg7GqdfODUeda/JpI0602kbN5YH22rzTxyqYvv7aRLENCM7XCQ1VRs7nMkEqgJUOU8Sag==", + "node_modules/@rushstack/rig-package": { + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/@rushstack/rig-package/-/rig-package-0.7.3.tgz", + "integrity": "sha512-aAA518n6wxxjCfnTAOjQnm7ngNE0FVHxHAw2pxKlIhxrMn0XQjGcXKF0oKWpjBgJOmsaJpVob/v+zr3zxgPWuA==", "dev": true, "license": "MIT", "dependencies": { + "jju": "~1.4.0", + "resolve": "~1.22.1" + } + }, + "node_modules/@rushstack/terminal": { + "version": "0.24.0", + "resolved": "https://registry.npmjs.org/@rushstack/terminal/-/terminal-0.24.0.tgz", + "integrity": "sha512-8ZQS4MMaGsv27EXCBiH7WMPkRZrffeDoIevs6z9TM5dzqiY6+Hn4evfK/G+gvgBTjfvfkHIZPQQmalmI2sM4TQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rushstack/node-core-library": "5.23.1", + "@rushstack/problem-matcher": "0.2.1", + "supports-color": "~8.1.1" + }, + "peerDependencies": { + "@types/node": "*" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@rushstack/ts-command-line": { + "version": "5.3.9", + "resolved": "https://registry.npmjs.org/@rushstack/ts-command-line/-/ts-command-line-5.3.9.tgz", + "integrity": "sha512-GIHqU+sRGQ3LGWAZu1O+9Yh++qwtyNIIGuNbcWHJjBTm2qRez0cwINUHZ+pQLR8UuzZDcMajrDaNbUYoaL/XtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rushstack/terminal": "0.24.0", "@types/argparse": "1.0.38", "argparse": "~1.0.9", - "colors": "~1.2.1", "string-argv": "~0.3.1" } }, @@ -10743,16 +10422,6 @@ "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==", "license": "MIT" }, - "node_modules/colors": { - "version": "1.2.5", - "resolved": "https://registry.npmjs.org/colors/-/colors-1.2.5.tgz", - "integrity": "sha512-erNRLao/Y3Fv54qUa0LBB+//Uf3YwMUmdJinN20yMXm9zdKKqH9wt7R9IIVZ+K7ShzfpLV/Zg8+VyrBJYB4lpg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.1.90" - } - }, "node_modules/combine-promises": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/combine-promises/-/combine-promises-1.2.0.tgz", @@ -17294,14 +16963,6 @@ "dev": true, "license": "MIT" }, - "node_modules/lodash.isequal": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz", - "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==", - "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead.", - "dev": true, - "license": "MIT" - }, "node_modules/lodash.kebabcase": { "version": "4.1.1", "resolved": "https://registry.npmjs.org/lodash.kebabcase/-/lodash.kebabcase-4.1.1.tgz", @@ -27411,16 +27072,6 @@ "node": "^14.17.0 || ^16.13.0 || >=18.0.0" } }, - "node_modules/validator": { - "version": "13.15.35", - "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.35.tgz", - "integrity": "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 0.10" - } - }, "node_modules/value-equal": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/value-equal/-/value-equal-1.0.1.tgz", @@ -28783,38 +28434,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/z-schema": { - "version": "5.0.5", - "resolved": "https://registry.npmjs.org/z-schema/-/z-schema-5.0.5.tgz", - "integrity": "sha512-D7eujBWkLa3p2sIpJA0d1pr7es+a7m0vFAnZLlCEKq/Ij2k0MLi9Br2UPxoxdYystm5K1yeBGzub0FlYUEWj2Q==", - "dev": true, - "license": "MIT", - "dependencies": { - "lodash.get": "^4.4.2", - "lodash.isequal": "^4.5.0", - "validator": "^13.7.0" - }, - "bin": { - "z-schema": "bin/z-schema" - }, - "engines": { - "node": ">=8.0.0" - }, - "optionalDependencies": { - "commander": "^9.4.1" - } - }, - "node_modules/z-schema/node_modules/commander": { - "version": "9.5.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz", - "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==", - "dev": true, - "license": "MIT", - "optional": true, - "engines": { - "node": "^12.20.0 || >=14" - } - }, "node_modules/zip-stream": { "version": "6.0.1", "resolved": "https://registry.npmjs.org/zip-stream/-/zip-stream-6.0.1.tgz", @@ -28900,7 +28519,6 @@ }, "packages/blockly": { "version": "12.5.1", - "hasInstallScript": true, "license": "Apache-2.0", "dependencies": { "jsdom": "26.1.0" @@ -28912,8 +28530,8 @@ "@blockly/theme-modern": "^7.0.1", "@hyperjump/browser": "^1.1.4", "@hyperjump/json-schema": "^1.5.0", - "@microsoft/api-documenter": "7.22.4", - "@microsoft/api-extractor": "^7.29.5", + "@microsoft/api-documenter": "7.30.5", + "@microsoft/api-extractor": "7.58.7", "ajv": "^8.17.1", "async-done": "^2.0.0", "chai": "^6.0.1", diff --git a/package.json b/package.json index 6f279b21b..d55a9016f 100644 --- a/package.json +++ b/package.json @@ -31,6 +31,7 @@ "test": "npm run test --ws --if-present", "lint": "npm run lint --ws --if-present", "build": "npm run build --ws --if-present", - "format:check": "npm run format:check --ws --if-present" + "format:check": "npm run format:check --ws --if-present", + "postinstall": "patch-package" } } diff --git a/packages/blockly/package.json b/packages/blockly/package.json index d3ff244fd..002fdcad5 100644 --- a/packages/blockly/package.json +++ b/packages/blockly/package.json @@ -34,7 +34,6 @@ "langfiles": "gulp langfiles", "minify": "gulp minify", "package": "gulp pack", - "postinstall": "patch-package", "prepareDemos": "gulp prepareDemos", "publish": "npm ci && gulp publish", "publish:beta": "npm ci && gulp publishBeta", @@ -105,8 +104,8 @@ "@blockly/theme-modern": "^7.0.1", "@hyperjump/browser": "^1.1.4", "@hyperjump/json-schema": "^1.5.0", - "@microsoft/api-documenter": "7.22.4", - "@microsoft/api-extractor": "^7.29.5", + "@microsoft/api-documenter": "7.30.5", + "@microsoft/api-extractor": "7.58.7", "ajv": "^8.17.1", "async-done": "^2.0.0", "chai": "^6.0.1", diff --git a/packages/blockly/scripts/gulpfiles/docs_tasks.mjs b/packages/blockly/scripts/gulpfiles/docs_tasks.mjs index 68d290651..1d739b1d7 100644 --- a/packages/blockly/scripts/gulpfiles/docs_tasks.mjs +++ b/packages/blockly/scripts/gulpfiles/docs_tasks.mjs @@ -368,38 +368,39 @@ const buildAlternatePathsMap = function(allFiles) { } /** - * Parse HTML tables from the blockly.md file to extract classes, interfaces, etc. - * @param {string} fileContent The content of blockly.md + * Parse HTML tables from blockly.mdx to extract classes, interfaces, etc. + * Each ## section contains an HTML table with markdown links in the first column. + * @param {string} fileContent The content of blockly.mdx * @returns {Object} Object with sections as keys and arrays of {name, path} as values */ const parseHtmlTables = function(fileContent) { const result = {}; - - // Split by ## headings + const linkRegex = /\[([^\]]+)\]\(\/reference\/([^\)]+)\)/g; + const tableRegex = /][\s\S]*?<\/table>/gi; + + // Split by ## headings (skip preamble before the first heading) const sections = fileContent.split('##'); - - for (let section of sections) { - const lines = section.split('\n'); - const sectionName = lines[0].trim(); - + + for (let i = 1; i < sections.length; i++) { + const section = sections[i]; + const sectionName = section.split('\n')[0].trim(); + if (!sectionName || sectionName === 'blockly package') continue; - - // Match links in markdown pipe tables: | [Name](/reference/path) | ... - const tableRowRegex = /\|\s*\[([^\]]+)\]\(\/reference\/([^\)]+)\)/g; + const items = []; - - let match; - while ((match = tableRowRegex.exec(section)) !== null) { - const name = match[1]; - const href = match[2]; - items.push({ name, path: href }); + let tableMatch; + while ((tableMatch = tableRegex.exec(section)) !== null) { + let linkMatch; + while ((linkMatch = linkRegex.exec(tableMatch[0])) !== null) { + items.push({name: linkMatch[1], path: linkMatch[2]}); + } } - + if (items.length > 0) { result[sectionName] = items; } } - + return result; } diff --git a/packages/docs/docs/codelabs/context-menu-option/add-a-context-menu-item.mdx b/packages/docs/docs/codelabs/context-menu-option/add-a-context-menu-item.mdx index cd2625d65..4f12f6b35 100644 --- a/packages/docs/docs/codelabs/context-menu-option/add-a-context-menu-item.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/add-a-context-menu-item.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/add-a-context-menu-item description: How to add a context menu item to the registry. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/callback.mdx b/packages/docs/docs/codelabs/context-menu-option/callback.mdx index 6189aca00..97687e25a 100644 --- a/packages/docs/docs/codelabs/context-menu-option/callback.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/callback.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/callback description: How to add a callback to a context menu item. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/codelab-overview.mdx b/packages/docs/docs/codelabs/context-menu-option/codelab-overview.mdx index 6261807ba..a4ce8f7fd 100644 --- a/packages/docs/docs/codelabs/context-menu-option/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/context-menu-option/codelab-overview description: Overview of the "Customizing context menus" codelab. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/display-text.mdx b/packages/docs/docs/codelabs/context-menu-option/display-text.mdx index 98ec7ef9e..7d80adfd3 100644 --- a/packages/docs/docs/codelabs/context-menu-option/display-text.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/display-text.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/display-text description: How to set the display text of a context menu item. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/precondition-blockly-state.mdx b/packages/docs/docs/codelabs/context-menu-option/precondition-blockly-state.mdx index 75fdc20c8..f08bb07bb 100644 --- a/packages/docs/docs/codelabs/context-menu-option/precondition-blockly-state.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/precondition-blockly-state.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/precondition-blockly-state description: How to include a context menu item based on Blockly's state. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/precondition-external-state.mdx b/packages/docs/docs/codelabs/context-menu-option/precondition-external-state.mdx index 5701d9dfc..ba6f998f5 100644 --- a/packages/docs/docs/codelabs/context-menu-option/precondition-external-state.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/precondition-external-state.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/precondition-external-state description: How to include a context menu item based on an external condition. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/precondition-node-type.mdx b/packages/docs/docs/codelabs/context-menu-option/precondition-node-type.mdx index 40014af01..532457135 100644 --- a/packages/docs/docs/codelabs/context-menu-option/precondition-node-type.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/precondition-node-type.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/precondition-node-type description: How to include a context menu item based on the node type. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/separators.mdx b/packages/docs/docs/codelabs/context-menu-option/separators.mdx index c2ac0b698..8dd3ea959 100644 --- a/packages/docs/docs/codelabs/context-menu-option/separators.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/separators.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/separators description: How to add a separator to a context menu. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/setup.mdx b/packages/docs/docs/codelabs/context-menu-option/setup.mdx index d3d0d3cef..12a516037 100644 --- a/packages/docs/docs/codelabs/context-menu-option/setup.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/setup description: Setting up the "Customizing context menus" codelab. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/summary.mdx b/packages/docs/docs/codelabs/context-menu-option/summary.mdx index 5ccc32261..70f146c4d 100644 --- a/packages/docs/docs/codelabs/context-menu-option/summary.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/context-menu-option/summary description: Summary of the "Customizing context menus" codelab. --- diff --git a/packages/docs/docs/codelabs/context-menu-option/weight-and-id.mdx b/packages/docs/docs/codelabs/context-menu-option/weight-and-id.mdx index 28d3acb1d..137a65017 100644 --- a/packages/docs/docs/codelabs/context-menu-option/weight-and-id.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/weight-and-id.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/context-menu-option/weight-and-id description: How to set the weight and ID of a context menu item. --- diff --git a/packages/docs/docs/codelabs/css/blocks.mdx b/packages/docs/docs/codelabs/css/blocks.mdx index 30ecc9589..b1ec168e6 100644 --- a/packages/docs/docs/codelabs/css/blocks.mdx +++ b/packages/docs/docs/codelabs/css/blocks.mdx @@ -1,6 +1,5 @@ --- title: Use CSS in Blockly - Blocks -slug: /codelabs/css/blocks description: Styling blocks with CSS --- diff --git a/packages/docs/docs/codelabs/css/categories.mdx b/packages/docs/docs/codelabs/css/categories.mdx index 4d5fc7d15..a23958fbd 100644 --- a/packages/docs/docs/codelabs/css/categories.mdx +++ b/packages/docs/docs/codelabs/css/categories.mdx @@ -1,6 +1,5 @@ --- title: Use CSS in Blockly - Toolbox Categories -slug: /codelabs/css/categories description: Styling toolbox categories with CSS --- diff --git a/packages/docs/docs/codelabs/css/codelab-overview.mdx b/packages/docs/docs/codelabs/css/codelab-overview.mdx index 49c5795d4..e5cc8ae4e 100644 --- a/packages/docs/docs/codelabs/css/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/css/codelab-overview.mdx @@ -1,7 +1,6 @@ --- pagination_prev: null title: Use CSS in Blockly - Codelab Overview -slug: /codelabs/css/codelab-overview description: Overview of the CSS in Blockly codelab --- diff --git a/packages/docs/docs/codelabs/css/components.mdx b/packages/docs/docs/codelabs/css/components.mdx index 16e8bc92d..92a35cbf4 100644 --- a/packages/docs/docs/codelabs/css/components.mdx +++ b/packages/docs/docs/codelabs/css/components.mdx @@ -1,6 +1,5 @@ --- title: Use CSS in Blockly - Components -slug: /codelabs/css/components description: Styling Blockly components with CSS --- diff --git a/packages/docs/docs/codelabs/css/setup.mdx b/packages/docs/docs/codelabs/css/setup.mdx index 39b80bf03..b20fce6d7 100644 --- a/packages/docs/docs/codelabs/css/setup.mdx +++ b/packages/docs/docs/codelabs/css/setup.mdx @@ -1,6 +1,5 @@ --- title: Use CSS in Blockly - Setup -slug: /codelabs/css/setup description: Setup for the CSS in Blockly codelab --- diff --git a/packages/docs/docs/codelabs/css/summary.mdx b/packages/docs/docs/codelabs/css/summary.mdx index 8732d0e70..473400a33 100644 --- a/packages/docs/docs/codelabs/css/summary.mdx +++ b/packages/docs/docs/codelabs/css/summary.mdx @@ -1,7 +1,6 @@ --- pagination_next: null title: Use CSS in Blockly - Summary -slug: /codelabs/css/summary description: Summary of the CSS in Blockly codelab --- diff --git a/packages/docs/docs/codelabs/css/tour.mdx b/packages/docs/docs/codelabs/css/tour.mdx index a2a6ab8f3..af131db33 100644 --- a/packages/docs/docs/codelabs/css/tour.mdx +++ b/packages/docs/docs/codelabs/css/tour.mdx @@ -1,6 +1,5 @@ --- title: Use CSS in Blockly - A tour of Blockly's elements -slug: /codelabs/css/tour description: Explore Blockly's HTML and SVG elements in the CSS codelab --- diff --git a/packages/docs/docs/codelabs/custom-generator/array-block-generator.mdx b/packages/docs/docs/codelabs/custom-generator/array-block-generator.mdx index 2ff9f48ac..436b91da2 100644 --- a/packages/docs/docs/codelabs/custom-generator/array-block-generator.mdx +++ b/packages/docs/docs/codelabs/custom-generator/array-block-generator.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/array-block-generator description: How to write a block code generator that creates an array. --- diff --git a/packages/docs/docs/codelabs/custom-generator/block-generator-overview.mdx b/packages/docs/docs/codelabs/custom-generator/block-generator-overview.mdx index edcbca743..613e60b05 100644 --- a/packages/docs/docs/codelabs/custom-generator/block-generator-overview.mdx +++ b/packages/docs/docs/codelabs/custom-generator/block-generator-overview.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/block-generator-overview description: Introduction to block generators. --- diff --git a/packages/docs/docs/codelabs/custom-generator/codelab-overview.mdx b/packages/docs/docs/codelabs/custom-generator/codelab-overview.mdx index 730e958f0..a0b80bc93 100644 --- a/packages/docs/docs/codelabs/custom-generator/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/custom-generator/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/custom-generator/codelab-overview description: Overview of the "Build a custom generator" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-generator/generating-a-stack.mdx b/packages/docs/docs/codelabs/custom-generator/generating-a-stack.mdx index 064674ade..c4878f896 100644 --- a/packages/docs/docs/codelabs/custom-generator/generating-a-stack.mdx +++ b/packages/docs/docs/codelabs/custom-generator/generating-a-stack.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/generating-a-stack description: How to generate code for the blocks in a stack. --- diff --git a/packages/docs/docs/codelabs/custom-generator/member-block-generator.mdx b/packages/docs/docs/codelabs/custom-generator/member-block-generator.mdx index 5696af734..f6c09e250 100644 --- a/packages/docs/docs/codelabs/custom-generator/member-block-generator.mdx +++ b/packages/docs/docs/codelabs/custom-generator/member-block-generator.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/member-block-generator description: How to write a block code generator using field and input values. --- diff --git a/packages/docs/docs/codelabs/custom-generator/object-block-generator.mdx b/packages/docs/docs/codelabs/custom-generator/object-block-generator.mdx index a5b684a03..4c663445d 100644 --- a/packages/docs/docs/codelabs/custom-generator/object-block-generator.mdx +++ b/packages/docs/docs/codelabs/custom-generator/object-block-generator.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/object-block-generator description: How to write a block code generator that creates an object. --- diff --git a/packages/docs/docs/codelabs/custom-generator/setup.mdx b/packages/docs/docs/codelabs/custom-generator/setup.mdx index d7d035687..625363a00 100644 --- a/packages/docs/docs/codelabs/custom-generator/setup.mdx +++ b/packages/docs/docs/codelabs/custom-generator/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/setup description: Setting up the "Build a custom generator" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-generator/summary.mdx b/packages/docs/docs/codelabs/custom-generator/summary.mdx index 9eb9dbd22..4f73963db 100644 --- a/packages/docs/docs/codelabs/custom-generator/summary.mdx +++ b/packages/docs/docs/codelabs/custom-generator/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/custom-generator/summary description: Summary of the "Build a custom generator" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-generator/the-basics.mdx b/packages/docs/docs/codelabs/custom-generator/the-basics.mdx index 0fea1a5be..4c98bda18 100644 --- a/packages/docs/docs/codelabs/custom-generator/the-basics.mdx +++ b/packages/docs/docs/codelabs/custom-generator/the-basics.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/the-basics description: How to define and call a language generator. --- diff --git a/packages/docs/docs/codelabs/custom-generator/value-block-generators.mdx b/packages/docs/docs/codelabs/custom-generator/value-block-generators.mdx index 372a29d5c..7f74071b1 100644 --- a/packages/docs/docs/codelabs/custom-generator/value-block-generators.mdx +++ b/packages/docs/docs/codelabs/custom-generator/value-block-generators.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-generator/value-block-generators description: How to write a block code generator for a simple value block. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/change-connection-shapes.mdx b/packages/docs/docs/codelabs/custom-renderer/change-connection-shapes.mdx index 9144dc604..ff3065067 100644 --- a/packages/docs/docs/codelabs/custom-renderer/change-connection-shapes.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/change-connection-shapes.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/change-connection-shapes description: How to change connection shapes. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/codelab-overview.mdx b/packages/docs/docs/codelabs/custom-renderer/codelab-overview.mdx index 6c4346332..f03afd7e3 100644 --- a/packages/docs/docs/codelabs/custom-renderer/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/custom-renderer/codelab-overview description: Overview of the "Build custom renderers" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/define-and-register-a-custom-renderer.mdx b/packages/docs/docs/codelabs/custom-renderer/define-and-register-a-custom-renderer.mdx index d8bf1ea39..4751a607f 100644 --- a/packages/docs/docs/codelabs/custom-renderer/define-and-register-a-custom-renderer.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/define-and-register-a-custom-renderer.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/define-and-register-a-custom-renderer description: How to register a custom renderer. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/observe-the-built-in-renderers.mdx b/packages/docs/docs/codelabs/custom-renderer/observe-the-built-in-renderers.mdx index da9de7df2..6fc617432 100644 --- a/packages/docs/docs/codelabs/custom-renderer/observe-the-built-in-renderers.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/observe-the-built-in-renderers.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/observe-the-built-in-renderers description: Introduction to the built-in renderers. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/override-constants.mdx b/packages/docs/docs/codelabs/custom-renderer/override-constants.mdx index 530beb4e3..1c683abdc 100644 --- a/packages/docs/docs/codelabs/custom-renderer/override-constants.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/override-constants.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/override-constants description: How to override the constants in a renderer. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/setup.mdx b/packages/docs/docs/codelabs/custom-renderer/setup.mdx index 8eb3e1576..6d6295971 100644 --- a/packages/docs/docs/codelabs/custom-renderer/setup.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/setup description: Setting up the "Build custom renderers" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/summary.mdx b/packages/docs/docs/codelabs/custom-renderer/summary.mdx index bc5a5de5d..460619136 100644 --- a/packages/docs/docs/codelabs/custom-renderer/summary.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/custom-renderer/summary description: Summary of the "Build custom renderers" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/typed-connection-shapes.mdx b/packages/docs/docs/codelabs/custom-renderer/typed-connection-shapes.mdx index 216e72cb8..3890aac03 100644 --- a/packages/docs/docs/codelabs/custom-renderer/typed-connection-shapes.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/typed-connection-shapes.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/typed-connection-shapes description: How to set connection shapes based on connection types. --- diff --git a/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx b/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx index 3a497550c..135728421 100644 --- a/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-renderer/understand-connection-shapes description: Introduction to connection shapes. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx b/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx index b072f3180..35d225de2 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/add-an-icon-to-your-category description: How to add an icon to your category. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/adding-a-custom-toolbox-item.mdx b/packages/docs/docs/codelabs/custom-toolbox/adding-a-custom-toolbox-item.mdx index e89f5f1fe..140955f6a 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/adding-a-custom-toolbox-item.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/adding-a-custom-toolbox-item.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/adding-a-custom-toolbox-item description: How to add a custom item to a toolbox. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/change-the-category-HTML.mdx b/packages/docs/docs/codelabs/custom-toolbox/change-the-category-HTML.mdx index cb7e73d44..85633a143 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/change-the-category-HTML.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/change-the-category-HTML.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/change-the-category-HTML description: How to change the HTML used by a category. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx index f2212d07d..ecc0bd94f 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/change-the-look-of-a-category description: How to change the look of a category. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-selected-category.mdx b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-selected-category.mdx index 08a84de42..033e31517 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-selected-category.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-selected-category.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/change-the-look-of-a-selected-category description: How to change the look of a selected category. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx b/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx index edd370ba7..e61f28169 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/custom-toolbox/codelab-overview description: Overview of the "Customizing a Blockly toolbox" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx index 0e210d3f5..e5f17a131 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/custom-toolbox/setup description: Setting up the "Customizing a Blockly toolbox" codelab. --- diff --git a/packages/docs/docs/codelabs/custom-toolbox/summary.mdx b/packages/docs/docs/codelabs/custom-toolbox/summary.mdx index 367eff8b9..e58b8b260 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/summary.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/custom-toolbox/summary description: Summary of the "Customizing a Blockly toolbox" codelab. --- diff --git a/packages/docs/docs/codelabs/getting-started/add-blockly-libraries.mdx b/packages/docs/docs/codelabs/getting-started/add-blockly-libraries.mdx index d58661a1e..6603041db 100644 --- a/packages/docs/docs/codelabs/getting-started/add-blockly-libraries.mdx +++ b/packages/docs/docs/codelabs/getting-started/add-blockly-libraries.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/add-blockly-libraries description: How to add Blockly libraries to an app. --- diff --git a/packages/docs/docs/codelabs/getting-started/codelab-overview.mdx b/packages/docs/docs/codelabs/getting-started/codelab-overview.mdx index 89df5690f..72d6ea816 100644 --- a/packages/docs/docs/codelabs/getting-started/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/getting-started/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/getting-started/codelab-overview description: Overview of the "Getting started with Blockly" codelab. --- diff --git a/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx b/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx index 4671d42f0..8df69a0ab 100644 --- a/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx +++ b/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/create-a-blockly-workspace description: How to add a workspace to your app. --- diff --git a/packages/docs/docs/codelabs/getting-started/create-a-custom-block.mdx b/packages/docs/docs/codelabs/getting-started/create-a-custom-block.mdx index 090004479..3b1787d33 100644 --- a/packages/docs/docs/codelabs/getting-started/create-a-custom-block.mdx +++ b/packages/docs/docs/codelabs/getting-started/create-a-custom-block.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/create-a-custom-block description: How to create a custom block. --- diff --git a/packages/docs/docs/codelabs/getting-started/explore-the-app.mdx b/packages/docs/docs/codelabs/getting-started/explore-the-app.mdx index 9b93ecbf3..ef864e56e 100644 --- a/packages/docs/docs/codelabs/getting-started/explore-the-app.mdx +++ b/packages/docs/docs/codelabs/getting-started/explore-the-app.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/explore-the-app description: Explore Blockly's getting started app. --- diff --git a/packages/docs/docs/codelabs/getting-started/generate-javaScript-code.mdx b/packages/docs/docs/codelabs/getting-started/generate-javaScript-code.mdx index 6b9c3f70e..ad874d7a6 100644 --- a/packages/docs/docs/codelabs/getting-started/generate-javaScript-code.mdx +++ b/packages/docs/docs/codelabs/getting-started/generate-javaScript-code.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/generate-javaScript-code description: How to generate JavaScript code. --- diff --git a/packages/docs/docs/codelabs/getting-started/run-generated-code.mdx b/packages/docs/docs/codelabs/getting-started/run-generated-code.mdx index f628fa64d..52a6986dd 100644 --- a/packages/docs/docs/codelabs/getting-started/run-generated-code.mdx +++ b/packages/docs/docs/codelabs/getting-started/run-generated-code.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/run-generated-code description: How to run generated code. --- diff --git a/packages/docs/docs/codelabs/getting-started/save-load-workspace.mdx b/packages/docs/docs/codelabs/getting-started/save-load-workspace.mdx index cb18f67fb..039ea3895 100644 --- a/packages/docs/docs/codelabs/getting-started/save-load-workspace.mdx +++ b/packages/docs/docs/codelabs/getting-started/save-load-workspace.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/save-load-workspace description: How to save and load your workspace. --- diff --git a/packages/docs/docs/codelabs/getting-started/setup.mdx b/packages/docs/docs/codelabs/getting-started/setup.mdx index 1ee6fac22..bb1b653ee 100644 --- a/packages/docs/docs/codelabs/getting-started/setup.mdx +++ b/packages/docs/docs/codelabs/getting-started/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/getting-started/setup description: Setting up the "Getting started with Blockly" codelab. --- diff --git a/packages/docs/docs/codelabs/getting-started/the-end.mdx b/packages/docs/docs/codelabs/getting-started/the-end.mdx index 078e7e8c8..3ef945ecc 100644 --- a/packages/docs/docs/codelabs/getting-started/the-end.mdx +++ b/packages/docs/docs/codelabs/getting-started/the-end.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/getting-started/the-end description: Summary of the "Getting started with Blockly" codelab. --- diff --git a/packages/docs/docs/codelabs/index.mdx b/packages/docs/docs/codelabs/index.mdx index de98704ec..8269dc98f 100644 --- a/packages/docs/docs/codelabs/index.mdx +++ b/packages/docs/docs/codelabs/index.mdx @@ -2,7 +2,6 @@ title: Welcome to the Blockly Codelabs pagination_next: null pagination_prev: null -slug: /codelabs --- import { CodelabGrid, CodelabCard } from '@site/src/components/CodelabCards'; diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/codelab-overview.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/codelab-overview.mdx index fba7e0f40..5c1b3fb36 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/theme-extension-identifier/codelab-overview description: Overview of the "Customizing your themes" codelab. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx index 84a53eecf..af66725dc 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/theme-extension-identifier/customize-block-styles description: How to use a theme to set the colours of blocks. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/customize-category-styles.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/customize-category-styles.mdx index 0a2132514..2927b430f 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/customize-category-styles.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/customize-category-styles.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/theme-extension-identifier/customize-category-styles description: How to use a theme to set the colours of categories. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/customize-components.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/customize-components.mdx index 707d2b078..f07bdfd88 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/customize-components.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/customize-components.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/theme-extension-identifier/customize-components description: How to use a theme to set the colours of components. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx index 5086103a9..d864ea70e 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/theme-extension-identifier/setup description: Setting up the "Customizing your themes" codelab. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx index d04e7b7e9..673c0958d 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/theme-extension-identifier/summary description: Summary of the "Customizing your themes" codelab. --- diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/workspace-theme.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/workspace-theme.mdx index b8a9a9879..f89fc0794 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/workspace-theme.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/workspace-theme.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/theme-extension-identifier/workspace-theme description: How to create a theme. --- diff --git a/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx b/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx index 836214712..cff867a14 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx @@ -1,6 +1,5 @@ --- pagination_prev: null -slug: /codelabs/validation-and-warnings/codelab-overview description: Overview of the "Block validation and warnings" codelab. --- diff --git a/packages/docs/docs/codelabs/validation-and-warnings/displaying-warnings.mdx b/packages/docs/docs/codelabs/validation-and-warnings/displaying-warnings.mdx index f2bbe2108..8616484aa 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/displaying-warnings.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/displaying-warnings.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/validation-and-warnings/displaying-warnings description: How to display a warning when a block fails validation. --- diff --git a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx index 83a788caf..3154e4e78 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/validation-and-warnings/setup description: Setting up the "Block validation and warnings" codelab. --- diff --git a/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx b/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx index d6cca3368..1d75c241f 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx @@ -1,6 +1,5 @@ --- pagination_next: null -slug: /codelabs/validation-and-warnings/summary description: Summary of the "Block validation and warnings" codelab. --- diff --git a/packages/docs/docs/codelabs/validation-and-warnings/validating-blocks.mdx b/packages/docs/docs/codelabs/validation-and-warnings/validating-blocks.mdx index 657bcbd2f..9ed7bb85c 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/validating-blocks.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/validating-blocks.mdx @@ -1,5 +1,4 @@ --- -slug: /codelabs/validation-and-warnings/validating-blocks description: How to validate the fields in a block. --- diff --git a/packages/docs/docs/guides/contribute/core/index.mdx b/packages/docs/docs/guides/contribute/core/index.mdx index 36750cf53..514e5ba46 100644 --- a/packages/docs/docs/guides/contribute/core/index.mdx +++ b/packages/docs/docs/guides/contribute/core/index.mdx @@ -2,7 +2,6 @@ description: Learn how to contribute changes to Blockly Core. title: Contribute to core image: images/blockly_banner.png -slug: /guides/contribute/core/index --- # Contribute to core diff --git a/packages/docs/docs/guides/contribute/get-started/index.mdx b/packages/docs/docs/guides/contribute/get-started/index.mdx index f3f62b463..9e261c254 100644 --- a/packages/docs/docs/guides/contribute/get-started/index.mdx +++ b/packages/docs/docs/guides/contribute/get-started/index.mdx @@ -2,7 +2,6 @@ description: Learn about contributing to Blockly. title: Get started contributing to Blockly image: images/blockly_banner.png -slug: /guides/contribute/get-started/index --- # Get started contributing to Blockly @@ -15,8 +14,8 @@ you are new to open source development. For information specific to Blockly that you should read before making a contribution, see the -[Contributing to Core](/guides/contribute/core/index) and -[Contributing to Samples](/guides/contribute/samples/index) sections. +[Contributing to Core](/guides/contribute/core) and +[Contributing to Samples](/guides/contribute/samples) sections. ## Which repository? @@ -53,8 +52,8 @@ These are the general steps you will follow any time you make a change. terminal. The name should help you remember what you're working on. 1. **Make your changes.** 1. **Validate your changes,** following the guide for - [core](/guides/contribute/core/index) or - [samples](/guides/contribute/samples/index). + [core](/guides/contribute/core) or + [samples](/guides/contribute/samples). 1. **Save your changes** with `git commit -am "fix: My commit message"`. [Read more about commit messages](#). 1. **Push your changes** to GitHub with `git push origin myBranchName`. diff --git a/packages/docs/docs/guides/contribute/get-started/write_a_good_issue.mdx b/packages/docs/docs/guides/contribute/get-started/write_a_good_issue.mdx index fef42fdfe..d633196f3 100644 --- a/packages/docs/docs/guides/contribute/get-started/write_a_good_issue.mdx +++ b/packages/docs/docs/guides/contribute/get-started/write_a_good_issue.mdx @@ -151,7 +151,7 @@ requests we will pursue. Here are the guidelines for each of the different categories of projects: -- [Blockly core](/guides/contribute/index) +- [Blockly core](/guides/contribute) - [Plugins](/guides/contribute/samples/add_a_plugin#first-party-criteria) - Examples: Show how to use only one or two Blockly features. - Codelabs: Show how to complete a single task or implement a single behaviour. diff --git a/packages/docs/docs/guides/contribute/index.mdx b/packages/docs/docs/guides/contribute/index.mdx index 4ed12daad..c4d3689ea 100644 --- a/packages/docs/docs/guides/contribute/index.mdx +++ b/packages/docs/docs/guides/contribute/index.mdx @@ -2,7 +2,6 @@ description: How to contribute (not just code!) to Blockly. title: Contribute to Blockly image: images/blockly_banner.png -slug: /guides/contribute/index --- # Contribute to Blockly @@ -24,11 +23,11 @@ contributions. - If you're new to open source development, or you want to get more background knowledge, head over to the - [Getting Started contributing](/guides/contribute/get-started/index) + [Getting Started contributing](/guides/contribute/get-started) guides. - If you are ready to jump in, check out the - [Contributing to Core](/guides/contribute/core/index) or - [Contributing to Samples](/guides/contribute/samples/index) guides. + [Contributing to Core](/guides/contribute/core) or + [Contributing to Samples](/guides/contribute/samples) guides. ### Talk to us! diff --git a/packages/docs/docs/guides/contribute/samples/block_factory.mdx b/packages/docs/docs/guides/contribute/samples/block_factory.mdx index f130dea28..a5a5f111b 100644 --- a/packages/docs/docs/guides/contribute/samples/block_factory.mdx +++ b/packages/docs/docs/guides/contribute/samples/block_factory.mdx @@ -234,7 +234,7 @@ to an input on a block, and watch the output change. Check that the preview of the block looks right, and that the code for each of the output sections is correct. -[blockly-samples-development]: /guides/contribute/samples/index +[blockly-samples-development]: /guides/contribute/samples [source-developer-tools]: https://github.com/RaspberryPiFoundation/blockly-samples/blob/main/examples/developer-tools [source-blocks-index]: https://github.com/RaspberryPiFoundation/blockly-samples/blob/main/examples/developer-tools/src/blocks/index.ts [source-blocks-fields]: https://github.com/RaspberryPiFoundation/blockly-samples/blob/main/examples/developer-tools/src/blocks/fields.ts diff --git a/packages/docs/docs/guides/contribute/samples/index.mdx b/packages/docs/docs/guides/contribute/samples/index.mdx index 759f27372..a40e666f5 100644 --- a/packages/docs/docs/guides/contribute/samples/index.mdx +++ b/packages/docs/docs/guides/contribute/samples/index.mdx @@ -2,7 +2,6 @@ description: Learn how to contribute changes to Blockly Samples. title: Contribute to samples image: images/blockly_banner.png -slug: /guides/contribute/samples/index --- # Contribute to samples diff --git a/packages/docs/docs/guides/programming/forking_blockly.mdx b/packages/docs/docs/guides/programming/forking_blockly.mdx index 5a1ba6af5..6afb9eba4 100644 --- a/packages/docs/docs/guides/programming/forking_blockly.mdx +++ b/packages/docs/docs/guides/programming/forking_blockly.mdx @@ -49,7 +49,7 @@ Blockly welcomes contributions! If your change is general-purpose, your best bet may be to make a pull request. Blockly improves, you don't have to maintain a fork, and everyone wins. -Check out the [contributing](/guides/contribute/index) page to learn +Check out the [contributing](/guides/contribute) page to learn more. ## Updating a fork diff --git a/packages/docs/docusaurus.config.js b/packages/docs/docusaurus.config.js index abe15e604..badc91451 100644 --- a/packages/docs/docusaurus.config.js +++ b/packages/docs/docusaurus.config.js @@ -13,8 +13,11 @@ const config = { v4: true, }, - url: 'https://raspberrypifoundation.github.io', - baseUrl: process.env.BASE_URL || '/docs/', + // CloudFlare Pages requires a trailing slash for index pages to work correctly. + trailingSlash: true, + + url: 'https://docs.blockly.com', + baseUrl: process.env.BASE_URL || '/', // GitHub pages deployment config organizationName: 'RaspberryPiFoundation', @@ -102,7 +105,7 @@ const config = { }, { label: 'Contribute to Blockly', - to: 'guides/contribute/index', + to: 'guides/contribute', }, ], }, diff --git a/packages/docs/static/_redirects b/packages/docs/static/_redirects index 63a16db93..50fd0514c 100644 --- a/packages/docs/static/_redirects +++ b/packages/docs/static/_redirects @@ -2,9 +2,14 @@ # Syntax: source destination [status_code] # https://developers.cloudflare.com/pages/configuration/redirects/ -# Legacy /reference/js/* paths redirect to canonical /reference/* URLs -/reference/js/* /reference/:splat 302 +# Legacy Google reference URLs used /reference/js/ and may end in .md. +# Canonical URLs are /reference// (trailingSlash: true, no /js/, no extension). +# More specific rules must appear before broader /reference/js/*. -# Strip .md/.mdx extensions if someone lands on the raw filename -/reference/*.md /reference/:splat 302 -/reference/*.mdx /reference/:splat 302 +/reference/js/*.md /reference/:splat/ 302 +/reference/js/*.mdx /reference/:splat/ 302 +/reference/js/* /reference/:splat/ 302 + +# Strip .md/.mdx extensions on canonical /reference/* paths +/reference/*.md /reference/:splat/ 302 +/reference/*.mdx /reference/:splat/ 302 diff --git a/patches/@microsoft+api-documenter+7.22.4.patch b/patches/@microsoft+api-documenter+7.22.4.patch deleted file mode 100644 index 3cc97035d..000000000 --- a/patches/@microsoft+api-documenter+7.22.4.patch +++ /dev/null @@ -1,76 +0,0 @@ -diff --git a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -index 5284d10..4f8b439 100644 ---- a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -+++ b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -@@ -877,12 +877,14 @@ class MarkdownDocumenter { - } - _writeBreadcrumb(output, apiItem) { - const configuration = this._tsdocConfiguration; -- output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ -- configuration, -- tagName: '@link', -- linkText: 'Home', -- urlDestination: this._getLinkFilenameForApiItem(this._apiModel) -- })); -+ // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link. -+ // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ -+ // configuration, -+ // tagName: '@link', -+ // linkText: 'Home', -+ // urlDestination: this._getLinkFilenameForApiItem(this._apiModel) -+ // })); -+ let first = true; - for (const hierarchyItem of apiItem.getHierarchy()) { - switch (hierarchyItem.kind) { - case api_extractor_model_1.ApiItemKind.Model: -@@ -892,18 +894,23 @@ class MarkdownDocumenter { - // this may change in the future. - break; - default: -- output.appendNodesInParagraph([ -+ if (!first) { -+ // Only print the breadcrumb separator if it's not the first item we're printing. -+ output.appendNodeInParagraph( - new tsdoc_1.DocPlainText({ - configuration, - text: ' > ' -- }), -+ })); -+ } -+ first = false; -+ output.appendNodeInParagraph( - new tsdoc_1.DocLinkTag({ - configuration, - tagName: '@link', - linkText: hierarchyItem.displayName, - urlDestination: this._getLinkFilenameForApiItem(hierarchyItem) - }) -- ]); -+ ); - } - } - } -@@ -968,11 +975,8 @@ class MarkdownDocumenter { - // For overloaded methods, add a suffix such as "MyClass.myMethod_2". - let qualifiedName = Utilities_1.Utilities.getSafeFilenameForName(hierarchyItem.displayName); - if (api_extractor_model_1.ApiParameterListMixin.isBaseClassOf(hierarchyItem)) { -- if (hierarchyItem.overloadIndex > 1) { -- // Subtract one for compatibility with earlier releases of API Documenter. -- // (This will get revamped when we fix GitHub issue #1308) -- qualifiedName += `_${hierarchyItem.overloadIndex - 1}`; -- } -+ // https://github.com/microsoft/rushstack/issues/1921 -+ qualifiedName += `_${hierarchyItem.overloadIndex}`; - } - switch (hierarchyItem.kind) { - case api_extractor_model_1.ApiItemKind.Model: -@@ -983,7 +987,8 @@ class MarkdownDocumenter { - baseName = Utilities_1.Utilities.getSafeFilenameForName(node_core_library_1.PackageName.getUnscopedName(hierarchyItem.displayName)); - break; - default: -- baseName += '.' + qualifiedName; -+ // https://github.com/microsoft/rushstack/issues/1921 -+ baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase(); - } - } - return baseName + '.md'; diff --git a/patches/@microsoft+api-documenter+7.28.2.patch b/patches/@microsoft+api-documenter+7.28.2.patch deleted file mode 100644 index 1ceaaf58a..000000000 --- a/patches/@microsoft+api-documenter+7.28.2.patch +++ /dev/null @@ -1,80 +0,0 @@ -diff --git a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -index 716b861..853a6b1 100644 ---- a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -+++ b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js -@@ -893,12 +893,14 @@ class MarkdownDocumenter { - } - _writeBreadcrumb(output, apiItem) { - const configuration = this._tsdocConfiguration; -- output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ -- configuration, -- tagName: '@link', -- linkText: 'Home', -- urlDestination: this._getLinkFilenameForApiItem(this._apiModel) -- })); -+ // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link. -+ // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ -+ // configuration, -+ // tagName: '@link', -+ // linkText: 'Home', -+ // urlDestination: this._getLinkFilenameForApiItem(this._apiModel) -+ // })); -+ let first = true; - for (const hierarchyItem of apiItem.getHierarchy()) { - switch (hierarchyItem.kind) { - case api_extractor_model_1.ApiItemKind.Model: -@@ -908,18 +910,24 @@ class MarkdownDocumenter { - // this may change in the future. - break; - default: -- output.appendNodesInParagraph([ -- new tsdoc_1.DocPlainText({ -- configuration, -- text: ' > ' -- }), -+ if (!first) { -+ // Only print the breadcrumb separator if it's not the first item we're printing. -+ output.appendNodeInParagraph( -+ new tsdoc_1.DocPlainText({ -+ configuration, -+ text: ' > ' -+ }) -+ ); -+ } -+ first = false; -+ output.appendNodeInParagraph( - new tsdoc_1.DocLinkTag({ - configuration, - tagName: '@link', - linkText: hierarchyItem.displayName, - urlDestination: this._getLinkFilenameForApiItem(hierarchyItem) - }) -- ]); -+ ); - } - } - } -@@ -992,11 +1000,8 @@ class MarkdownDocumenter { - // For overloaded methods, add a suffix such as "MyClass.myMethod_2". - let qualifiedName = Utilities_1.Utilities.getSafeFilenameForName(hierarchyItem.displayName); - if (api_extractor_model_1.ApiParameterListMixin.isBaseClassOf(hierarchyItem)) { -- if (hierarchyItem.overloadIndex > 1) { -- // Subtract one for compatibility with earlier releases of API Documenter. -- // (This will get revamped when we fix GitHub issue #1308) -- qualifiedName += `_${hierarchyItem.overloadIndex - 1}`; -- } -+ // https://github.com/microsoft/rushstack/issues/1921 -+ qualifiedName += `_${hierarchyItem.overloadIndex}`; - } - switch (hierarchyItem.kind) { - case api_extractor_model_1.ApiItemKind.Model: -@@ -1007,7 +1012,8 @@ class MarkdownDocumenter { - baseName = Utilities_1.Utilities.getSafeFilenameForName(node_core_library_1.PackageName.getUnscopedName(hierarchyItem.displayName)); - break; - default: -- baseName += '.' + qualifiedName; -+ // https://github.com/microsoft/rushstack/issues/1921 -+ baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase(); - } - } - return baseName + '.md'; diff --git a/patches/@microsoft+api-documenter+7.30.5+001+initial.patch b/patches/@microsoft+api-documenter+7.30.5+001+initial.patch new file mode 100644 index 000000000..9e9218382 --- /dev/null +++ b/patches/@microsoft+api-documenter+7.30.5+001+initial.patch @@ -0,0 +1,161 @@ +diff --git a/node_modules/@microsoft/api-documenter/lib-commonjs/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib-commonjs/documenters/MarkdownDocumenter.js +index 026a528..1ebdc8f 100644 +--- a/node_modules/@microsoft/api-documenter/lib-commonjs/documenters/MarkdownDocumenter.js ++++ b/node_modules/@microsoft/api-documenter/lib-commonjs/documenters/MarkdownDocumenter.js +@@ -914,12 +914,14 @@ class MarkdownDocumenter { + } + _writeBreadcrumb(output, apiItem) { + const configuration = this._tsdocConfiguration; +- output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ +- configuration, +- tagName: '@link', +- linkText: 'Home', +- urlDestination: this._getLinkFilenameForApiItem(this._apiModel) +- })); ++ // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link. ++ // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ ++ // configuration, ++ // tagName: '@link', ++ // linkText: 'Home', ++ // urlDestination: this._getLinkFilenameForApiItem(this._apiModel) ++ // })); ++ let first = true; + for (const hierarchyItem of apiItem.getHierarchy()) { + switch (hierarchyItem.kind) { + case api_extractor_model_1.ApiItemKind.Model: +@@ -929,18 +931,24 @@ class MarkdownDocumenter { + // this may change in the future. + break; + default: +- output.appendNodesInParagraph([ +- new tsdoc_1.DocPlainText({ +- configuration, +- text: ' > ' +- }), ++ if (!first) { ++ // Only print the breadcrumb separator if it's not the first item we're printing. ++ output.appendNodeInParagraph( ++ new tsdoc_1.DocPlainText({ ++ configuration, ++ text: ' > ' ++ }) ++ ); ++ } ++ first = false; ++ output.appendNodeInParagraph( + new tsdoc_1.DocLinkTag({ + configuration, + tagName: '@link', + linkText: hierarchyItem.displayName, + urlDestination: this._getLinkFilenameForApiItem(hierarchyItem) + }) +- ]); ++ ); + } + } + } +@@ -1014,9 +1022,8 @@ class MarkdownDocumenter { + let qualifiedName = Utilities_1.Utilities.getSafeFilenameForName(hierarchyItem.displayName); + if (api_extractor_model_1.ApiParameterListMixin.isBaseClassOf(hierarchyItem)) { + if (hierarchyItem.overloadIndex > 1) { +- // Subtract one for compatibility with earlier releases of API Documenter. +- // (This will get revamped when we fix GitHub issue #1308) +- qualifiedName += `_${hierarchyItem.overloadIndex - 1}`; ++ // https://github.com/microsoft/rushstack/issues/1921 ++ qualifiedName += `_${hierarchyItem.overloadIndex}`; + } + } + switch (hierarchyItem.kind) { +@@ -1028,7 +1035,8 @@ class MarkdownDocumenter { + baseName = Utilities_1.Utilities.getSafeFilenameForName(node_core_library_1.PackageName.getUnscopedName(hierarchyItem.displayName)); + break; + default: +- baseName += '.' + qualifiedName; ++ // https://github.com/microsoft/rushstack/issues/1921 ++ baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase(); + } + } + return baseName + '.md'; +diff --git a/node_modules/@microsoft/api-documenter/lib-esm/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib-esm/documenters/MarkdownDocumenter.js +index f08d6e8..0d28f73 100644 +--- a/node_modules/@microsoft/api-documenter/lib-esm/documenters/MarkdownDocumenter.js ++++ b/node_modules/@microsoft/api-documenter/lib-esm/documenters/MarkdownDocumenter.js +@@ -878,33 +878,41 @@ export class MarkdownDocumenter { + } + _writeBreadcrumb(output, apiItem) { + const configuration = this._tsdocConfiguration; +- output.appendNodeInParagraph(new DocLinkTag({ +- configuration, +- tagName: '@link', +- linkText: 'Home', +- urlDestination: this._getLinkFilenameForApiItem(this._apiModel) +- })); ++ // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link. ++ // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({ ++ // configuration, ++ // tagName: '@link', ++ // linkText: 'Home', ++ // urlDestination: this._getLinkFilenameForApiItem(this._apiModel) ++ // })); ++ let first = true; + for (const hierarchyItem of apiItem.getHierarchy()) { + switch (hierarchyItem.kind) { +- case ApiItemKind.Model: +- case ApiItemKind.EntryPoint: ++ case api_extractor_model_1.ApiItemKind.Model: ++ case api_extractor_model_1.ApiItemKind.EntryPoint: + // We don't show the model as part of the breadcrumb because it is the root-level container. + // We don't show the entry point because today API Extractor doesn't support multiple entry points; + // this may change in the future. + break; + default: +- output.appendNodesInParagraph([ +- new DocPlainText({ +- configuration, +- text: ' > ' +- }), +- new DocLinkTag({ ++ if (!first) { ++ // Only print the breadcrumb separator if it's not the first item we're printing. ++ output.appendNodeInParagraph( ++ new tsdoc_1.DocPlainText({ ++ configuration, ++ text: ' > ' ++ }) ++ ); ++ } ++ first = false; ++ output.appendNodeInParagraph( ++ new tsdoc_1.DocLinkTag({ + configuration, + tagName: '@link', + linkText: hierarchyItem.displayName, + urlDestination: this._getLinkFilenameForApiItem(hierarchyItem) + }) +- ]); ++ ); + } + } + } +@@ -978,9 +986,8 @@ export class MarkdownDocumenter { + let qualifiedName = Utilities.getSafeFilenameForName(hierarchyItem.displayName); + if (ApiParameterListMixin.isBaseClassOf(hierarchyItem)) { + if (hierarchyItem.overloadIndex > 1) { +- // Subtract one for compatibility with earlier releases of API Documenter. +- // (This will get revamped when we fix GitHub issue #1308) +- qualifiedName += `_${hierarchyItem.overloadIndex - 1}`; ++ // https://github.com/microsoft/rushstack/issues/1921 ++ qualifiedName += `_${hierarchyItem.overloadIndex}`; + } + } + switch (hierarchyItem.kind) { +@@ -992,7 +999,8 @@ export class MarkdownDocumenter { + baseName = Utilities.getSafeFilenameForName(PackageName.getUnscopedName(hierarchyItem.displayName)); + break; + default: +- baseName += '.' + qualifiedName; ++ // https://github.com/microsoft/rushstack/issues/1921 ++ baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase(); + } + } + return baseName + '.md'; From 37c95df81d417fcdae303b358974196f821aac1b Mon Sep 17 00:00:00 2001 From: Maribeth Moffatt Date: Tue, 26 May 2026 11:40:53 -0400 Subject: [PATCH 11/12] chore: add legacy docs redirects and some minor fixes (#9929) * chore: add legacy redirects from devsite * chore: rename configure/web to just configure * chore: remove youtube embeds because we are scared of cookies * chore: fix some broken images --- packages/blockly/core/grid.ts | 2 +- packages/blockly/core/options.ts | 6 +- packages/blockly/tests/playground.html | 2 +- .../codelabs/context-menu-option/summary.mdx | 4 +- packages/docs/docs/codelabs/css/blocks.mdx | 2 +- .../docs/docs/codelabs/css/categories.mdx | 2 +- .../docs/docs/codelabs/css/components.mdx | 2 +- packages/docs/docs/codelabs/css/summary.mdx | 2 +- .../add-an-icon-to-your-category.mdx | 2 +- .../change-the-look-of-a-category.mdx | 2 +- .../custom-toolbox/codelab-overview.mdx | 4 +- .../create-a-blockly-workspace.mdx | 4 +- .../customize-block-styles.mdx | 2 +- .../theme-extension-identifier/summary.mdx | 4 +- .../codelab-overview.mdx | 2 +- .../validation-and-warnings/summary.mdx | 4 +- .../docs/guides/app-integration/run-code.mdx | 2 +- .../{web => }/appearance/block-colour.mdx | 10 +- .../{web => }/appearance/colour-formats.mdx | 2 +- .../configure/{web => }/appearance/css.mdx | 8 +- .../configure/{web => }/appearance/themes.mdx | 6 +- .../configure/{web => }/block_comment.mdx | 2 +- .../configure/{web => }/colour-a11y.mdx | 2 +- .../{web => }/configuration_struct.mdx | 14 +-- .../configure/{web => }/context-menus.mdx | 8 +- .../guides/configure/{web => }/copy-paste.mdx | 8 +- .../configure/{web => }/customization.mdx | 2 +- .../dragging/block-drag-strategies.mdx | 4 +- .../{web => }/dragging/draggable.mdx | 4 +- .../configure/{web => }/dragging/dragger.mdx | 2 +- .../guides/configure/{web => }/events.mdx | 0 .../guides/configure/{web => }/fixed-size.mdx | 2 +- .../docs/guides/configure/{web => }/focus.mdx | 6 +- .../docs/guides/configure/{web => }/grid.mdx | 2 +- .../configure/{web => }/keyboard-nav.mdx | 2 +- .../{web => }/keyboard-shortcuts.mdx | 4 +- .../docs/guides/configure/{web => }/media.mdx | 2 +- .../configure/{web => }/metrics_manager.mdx | 0 .../docs/guides/configure/{web => }/move.mdx | 2 +- .../guides/configure/{web => }/resizable.mdx | 2 +- .../configure/{web => }/serialization.mdx | 4 +- .../{web => }/toolboxes/appearance.mdx | 4 +- .../configure/{web => }/toolboxes/buttons.mdx | 0 .../{web => }/toolboxes/category.mdx | 2 +- .../toolboxes/disable-categories.mdx | 2 +- .../configure/{web => }/toolboxes/dynamic.mdx | 0 .../configure/{web => }/toolboxes/flyout.mdx | 2 +- .../configure/{web => }/toolboxes/modify.mdx | 0 .../configure/{web => }/toolboxes/nested.mdx | 0 .../configure/{web => }/toolboxes/preset.mdx | 0 .../{web => }/toolboxes/programmatic.mdx | 0 .../{web => }/toolboxes/separators.mdx | 0 .../configure/{web => }/toolboxes/toolbox.mdx | 6 +- .../configure/{web => }/translations.mdx | 2 +- .../configure/{web => }/workspace_comment.mdx | 6 +- .../docs/guides/configure/{web => }/zoom.mdx | 2 +- .../core/add_localization_token.mdx | 4 +- .../docs/guides/contribute/samples/naming.mdx | 2 +- .../blockly-developer-tools.md | 16 +-- .../define/json-and-js.mdx | 2 +- .../define/modify-definitions.mdx | 4 +- .../define/structure-json.mdx | 2 +- .../fields/customizing-fields/creating.mdx | 6 +- .../creating-custom-icons/save-and-load.mdx | 2 +- .../inputs/connection-checks.mdx | 2 +- .../inputs/connection-previews.mdx | 2 +- .../legacy-blockly-developer-tools.md | 16 ++- .../guides/create-custom-blocks/mutators.mdx | 4 +- .../guides/create-custom-blocks/overview.mdx | 4 +- .../creating-custom-procedure-blocks.mdx | 4 +- .../renderers/concepts/path-object.mdx | 2 +- .../basic-implementation.mdx | 2 +- .../guides/create-custom-blocks/variables.mdx | 6 +- .../docs/docs/guides/design/app-overview.mdx | 2 +- .../docs/docs/guides/design/applications.mdx | 2 +- .../docs/guides/get-started/save-and-load.mdx | 2 +- .../docs/docs/guides/get-started/toolbox.mdx | 2 +- .../guides/get-started/workspace-anatomy.mdx | 14 +-- .../guides/get-started/workspace-creation.mdx | 2 +- .../guides/programming/forking_blockly.mdx | 2 +- .../guides/programming/plugin_overview.mdx | 4 +- packages/docs/docusaurus.config.js | 2 +- packages/docs/sidebars.js | 78 ++++++------- packages/docs/static/_redirects | 107 ++++++++++++++++++ 84 files changed, 283 insertions(+), 186 deletions(-) rename packages/docs/docs/guides/configure/{web => }/appearance/block-colour.mdx (82%) rename packages/docs/docs/guides/configure/{web => }/appearance/colour-formats.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/appearance/css.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/appearance/themes.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/block_comment.mdx (95%) rename packages/docs/docs/guides/configure/{web => }/colour-a11y.mdx (92%) rename packages/docs/docs/guides/configure/{web => }/configuration_struct.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/context-menus.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/copy-paste.mdx (95%) rename packages/docs/docs/guides/configure/{web => }/customization.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/dragging/block-drag-strategies.mdx (92%) rename packages/docs/docs/guides/configure/{web => }/dragging/draggable.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/dragging/dragger.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/events.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/fixed-size.mdx (95%) rename packages/docs/docs/guides/configure/{web => }/focus.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/grid.mdx (96%) rename packages/docs/docs/guides/configure/{web => }/keyboard-nav.mdx (94%) rename packages/docs/docs/guides/configure/{web => }/keyboard-shortcuts.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/media.mdx (92%) rename packages/docs/docs/guides/configure/{web => }/metrics_manager.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/move.mdx (94%) rename packages/docs/docs/guides/configure/{web => }/resizable.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/serialization.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/appearance.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/buttons.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/category.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/disable-categories.mdx (97%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/dynamic.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/flyout.mdx (95%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/modify.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/nested.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/preset.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/programmatic.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/separators.mdx (100%) rename packages/docs/docs/guides/configure/{web => }/toolboxes/toolbox.mdx (83%) rename packages/docs/docs/guides/configure/{web => }/translations.mdx (99%) rename packages/docs/docs/guides/configure/{web => }/workspace_comment.mdx (98%) rename packages/docs/docs/guides/configure/{web => }/zoom.mdx (95%) diff --git a/packages/blockly/core/grid.ts b/packages/blockly/core/grid.ts index 2d88973ad..c60c629d3 100644 --- a/packages/blockly/core/grid.ts +++ b/packages/blockly/core/grid.ts @@ -32,7 +32,7 @@ export class Grid { * @param pattern The grid's SVG pattern, created during injection. * @param options A dictionary of normalized options for the grid. * See grid documentation: - * https://developers.google.com/blockly/guides/configure/web/grid + * https://developers.google.com/blockly/guides/configure/grid */ constructor( private pattern: SVGElement, diff --git a/packages/blockly/core/options.ts b/packages/blockly/core/options.ts index 539fd3f6f..8a593702f 100644 --- a/packages/blockly/core/options.ts +++ b/packages/blockly/core/options.ts @@ -255,7 +255,7 @@ export class Options { /** * Parse the user-specified zoom options, using reasonable defaults where * behaviour is unspecified. See zoom documentation: - * https://developers.google.com/blockly/guides/configure/web/zoom + * https://developers.google.com/blockly/guides/configure/zoom * * @param options Dictionary of options. * @returns Normalized zoom options. @@ -304,7 +304,7 @@ export class Options { /** * Parse the user-specified grid options, using reasonable defaults where * behaviour is unspecified. See grid documentation: - * https://developers.google.com/blockly/guides/configure/web/grid + * https://developers.google.com/blockly/guides/configure/grid * * @param options Dictionary of options. * @returns Normalized grid options. @@ -322,7 +322,7 @@ export class Options { /** * Parse the user-specified theme options, using the classic theme as a - * default. https://developers.google.com/blockly/guides/configure/web/themes + * default. https://developers.google.com/blockly/guides/configure/appearance/themes * * @param options Dictionary of options. * @returns A Blockly Theme. diff --git a/packages/blockly/tests/playground.html b/packages/blockly/tests/playground.html index 642a0991b..3fc55bfb1 100644 --- a/packages/blockly/tests/playground.html +++ b/packages/blockly/tests/playground.html @@ -582,7 +582,7 @@ + configurations. For more information on building toolboxes, see https://developers.google.com/blockly/guides/configure/toolboxes/toolbox --> diff --git a/packages/docs/docs/codelabs/context-menu-option/summary.mdx b/packages/docs/docs/codelabs/context-menu-option/summary.mdx index 70f146c4d..1389ad07e 100644 --- a/packages/docs/docs/codelabs/context-menu-option/summary.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/summary.mdx @@ -11,6 +11,6 @@ In this codelab you have learned how to create and modify context menu options. ### Additional information -- [Context menu documentation](/guides/configure/web/context-menus) +- [Context menu documentation](/guides/configure/context-menus) -- You can also define [block context menus](/guides/configure/web/context-menus#customize-per-block) directly on a block definition, which is equivalent to adding a precondition based on the type of the block. +- You can also define [block context menus](/guides/configure/context-menus#customize-per-block) directly on a block definition, which is equivalent to adding a precondition based on the type of the block. diff --git a/packages/docs/docs/codelabs/css/blocks.mdx b/packages/docs/docs/codelabs/css/blocks.mdx index b1ec168e6..2c29a4db6 100644 --- a/packages/docs/docs/codelabs/css/blocks.mdx +++ b/packages/docs/docs/codelabs/css/blocks.mdx @@ -61,7 +61,7 @@ The last step before writing your colour rules is to decide what colours to use. How these colours are used depends on the renderer. The Thrasos renderer uses the primary colour as the `fill` of the block, the tertiary colour as the `stroke`, and the secondary colour as the `fill` when the block is a -[shadow block](/guides/configure/web/toolboxes/preset#shadow-blocks). +[shadow block](/guides/configure/toolboxes/preset#shadow-blocks). #### Add your rules diff --git a/packages/docs/docs/codelabs/css/categories.mdx b/packages/docs/docs/codelabs/css/categories.mdx index a23958fbd..deaf28a0f 100644 --- a/packages/docs/docs/codelabs/css/categories.mdx +++ b/packages/docs/docs/codelabs/css/categories.mdx @@ -56,7 +56,7 @@ define rules that apply to all categories. }, ``` -For a complete explanation of how `cssConfig` works, see [Custom CSS classes](/guides/configure/web/toolboxes/appearance#custom-css-classes) in the toolbox documentation. +For a complete explanation of how `cssConfig` works, see [Custom CSS classes](/guides/configure/toolboxes/appearance#custom-css-classes) in the toolbox documentation. ### Add your rules diff --git a/packages/docs/docs/codelabs/css/components.mdx b/packages/docs/docs/codelabs/css/components.mdx index 92a35cbf4..990e9fb21 100644 --- a/packages/docs/docs/codelabs/css/components.mdx +++ b/packages/docs/docs/codelabs/css/components.mdx @@ -152,4 +152,4 @@ You might have also noticed that some rules use an `!important` declaration whil - **Inline styles:** These rules are included via a `style` attribute and can only be overridden by an `!important` declaration. As you will see later, the colour of the arrow in a dropdown field is set with an inline style and must be overridden with `!important`. -The easiest way to determine how a rule is set is to highlight the appropriate element in the element inspector and look at the corresponding style information. In a few cases, this isn't possible. For example, an insertion marker is created only when you drag a child near its parent and is deleted when you let go of the parent to highlight the insertion marker's element. In these cases, you will need to [search Blockly's rules](/guides/configure/web/appearance/css#blockly-css-rules). +The easiest way to determine how a rule is set is to highlight the appropriate element in the element inspector and look at the corresponding style information. In a few cases, this isn't possible. For example, an insertion marker is created only when you drag a child near its parent and is deleted when you let go of the parent to highlight the insertion marker's element. In these cases, you will need to [search Blockly's rules](/guides/configure/appearance/css#blockly-css-rules). diff --git a/packages/docs/docs/codelabs/css/summary.mdx b/packages/docs/docs/codelabs/css/summary.mdx index 473400a33..3e20b5d4b 100644 --- a/packages/docs/docs/codelabs/css/summary.mdx +++ b/packages/docs/docs/codelabs/css/summary.mdx @@ -8,4 +8,4 @@ description: Summary of the CSS in Blockly codelab In this codelab, you learned how to use CSS to set the colours of your Blockly editor. -For more information, see [Style with CSS](/guides/configure/web/appearance/css) in the Blockly user guides. +For more information, see [Style with CSS](/guides/configure/appearance/css) in the Blockly user guides. diff --git a/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx b/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx index 35d225de2..2a4b0424c 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/add-an-icon-to-your-category.mdx @@ -33,7 +33,7 @@ to be: ``` All the classes used to create a category can be set similar to how we set the -icon class above. See the [Blockly toolbox documentation](/guides/configure/web/toolboxes/appearance#category-css) for more information. +icon class above. See the [Blockly toolbox documentation](/guides/configure/toolboxes/appearance#category-css) for more information. ### Add some CSS diff --git a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx index ecc0bd94f..15efa0deb 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/change-the-look-of-a-category.mdx @@ -41,7 +41,7 @@ The logic_category style looks like: } ``` -For more information on Blockly styles please visit the [themes documentation](/guides/configure/web/appearance/themes#category-style). +For more information on Blockly styles please visit the [themes documentation](/guides/configure/appearance/themes#category-style). ### Add some CSS diff --git a/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx b/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx index e61f28169..6a6ca97ff 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/codelab-overview.mdx @@ -40,8 +40,8 @@ The code samples are written in ES6 syntax. You can find the code for the [compl - A browser. - A text editor. - Basic knowledge of HTML, CSS, and JavaScript. -- Basic understanding of the [Blockly toolbox](/guides/configure/web/toolboxes/toolbox). +- Basic understanding of the [Blockly toolbox](/guides/configure/toolboxes/toolbox). -Throughout various parts of this codelab we will be talking about [toolbox definitions](/guides/configure/web/toolboxes/category?tab=xml). +Throughout various parts of this codelab we will be talking about [toolbox definitions](/guides/configure/toolboxes/category?tab=xml). The toolbox definition can be written in XML or JSON. We will be using an XML toolbox definition that can be found in the provided code. diff --git a/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx b/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx index 8df69a0ab..8bb02afa6 100644 --- a/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx +++ b/packages/docs/docs/codelabs/getting-started/create-a-blockly-workspace.mdx @@ -27,7 +27,7 @@ The toolbox may be organized into categories, and may contain both single blocks A toolbox is defined as a JavaScript object and passed into the workspace constructor through an options struct. -For more information on this JSON format and toolbox configuration, including category creation, please see our toolbox documentation. +For more information on this JSON format and toolbox configuration, including category creation, please see our toolbox documentation. ### Define the toolbox @@ -92,7 +92,7 @@ Let's look at the options we used to initialize your blockly editor: - `horizontalLayout`: Whether to display the toolbox horizontally or vertically in the workspace. - `toolboxPosition`: Whether to show the toolbox at the top or bottom of the workspace. -The `options` struct gives you significant control over your Blockly instance. You can pass options to set Blockly's theme, modify scrolling behaviour, set the renderer, and more. For more information, head over to Blockly's developer site and check out the [configuration](/guides/configure/web/configuration_struct#the-options-dictionary) section. +The `options` struct gives you significant control over your Blockly instance. You can pass options to set Blockly's theme, modify scrolling behaviour, set the renderer, and more. For more information, head over to Blockly's developer site and check out the [configuration](/guides/configure/configuration_struct#the-options-dictionary) section. ### Check your work diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx index af66725dc..e85f66749 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/customize-block-styles.mdx @@ -8,7 +8,7 @@ description: How to use a theme to set the colours of blocks. A block style currently only holds three different colour properties. They are 'colourPrimary', 'colourSecondary' and 'colourTertiary'. This value can either be defined as a hex value or as a hue. -For more information on block styles visit our themes [documentation](/guides/configure/web/appearance/themes#block-style) +For more information on block styles visit our themes [documentation](/guides/configure/appearance/themes#block-style) Update the Theme definition to have the block styles as below. diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx index 673c0958d..ab21e00c1 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/summary.mdx @@ -11,6 +11,6 @@ In this codelab you have learned how to extend and customize themes for the bloc ### Additional information -- [Themes documentation](/guides/configure/web/appearance/themes) +- [Themes documentation](/guides/configure/appearance/themes) -- You can also customize the font styles. Details are available in the [documentation](/guides/configure/web/appearance/themes#font-styles). +- You can also customize the font styles. Details are available in the [documentation](/guides/configure/appearance/themes#font-styles). diff --git a/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx b/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx index cff867a14..0ef4d83c6 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/codelab-overview.mdx @@ -33,5 +33,5 @@ You can find the code for the [completed custom block](https://github.com/Raspbe - A browser. - A text editor. - Basic knowledge of JavaScript. -- Basic understanding of the [Blockly toolbox](/guides/configure/web/toolboxes/toolbox). +- Basic understanding of the [Blockly toolbox](/guides/configure/toolboxes/toolbox). - Basic understanding of [using JSON to define custom blocks](/guides/create-custom-blocks/define/structure-json). diff --git a/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx b/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx index 1d75c241f..64784d649 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/summary.mdx @@ -22,10 +22,10 @@ You can find the code for the [completed custom block](https://github.com/Raspbe For more information related topics, check out the documentation: -- [Defining the toolbox](/guides/configure/web/toolboxes/toolbox) +- [Defining the toolbox](/guides/configure/toolboxes/toolbox) - [Defining custom blocks](/guides/create-custom-blocks/overview) - [Generating code from blocks](/guides/create-custom-blocks/code-generation/overview) - [Creating extensions](/guides/create-custom-blocks/define/extensions#extensions) -- [Listening for change events](/guides/configure/web/events) +- [Listening for change events](/guides/configure/events) - [Custom validators](/guides/create-custom-blocks/fields/validators) - [Custom block style guide](/guides/design/blocks) diff --git a/packages/docs/docs/guides/app-integration/run-code.mdx b/packages/docs/docs/guides/app-integration/run-code.mdx index a13e75dd1..2c9286bff 100644 --- a/packages/docs/docs/guides/app-integration/run-code.mdx +++ b/packages/docs/docs/guides/app-integration/run-code.mdx @@ -147,5 +147,5 @@ safely execute JavaScript. Other languages require other tools. -[event]: /guides/configure/web/events +[event]: /guides/configure/events [jsinterpreter]: https://github.com/NeilFraser/JS-Interpreter diff --git a/packages/docs/docs/guides/configure/web/appearance/block-colour.mdx b/packages/docs/docs/guides/configure/appearance/block-colour.mdx similarity index 82% rename from packages/docs/docs/guides/configure/web/appearance/block-colour.mdx rename to packages/docs/docs/guides/configure/appearance/block-colour.mdx index 7847f7e9f..b827d08b7 100644 --- a/packages/docs/docs/guides/configure/web/appearance/block-colour.mdx +++ b/packages/docs/docs/guides/configure/appearance/block-colour.mdx @@ -17,20 +17,20 @@ with the colours mirrored by the various toolbar categories in the demos: colour.](/images/standard-block-colors.png) Additional colours on the block are derived from the main colour. For example, -[shadow blocks](/guides/configure/web/toolboxes/preset#shadow-blocks) +[shadow blocks](/guides/configure/toolboxes/preset#shadow-blocks) are a desaturated version of the main colour, and border colours are a darker version. :::tip If you want more control over shadow block or border colours, learn about -[defining a theme](/guides/configure/web/appearance/themes). +[defining a theme](/guides/configure/appearance/themes). ::: ## Set block colour The primary colour of a block can be defined in either JSON or JavaScript. You can pass the hue (preferred), RGB value, or color name; for more information, -see [Colour formats](/guides/configure/web/appearance/colour-formats). +see [Colour formats](/guides/configure/appearance/colour-formats). @@ -54,10 +54,10 @@ Note the British spelling. Failure to set the colour results in a black block. You can also set the block color using the [`Block.setColour(..)`](/reference/blockly.block.setcolour) -function, or by using [themes](/guides/configure/web/appearance/themes) +function, or by using [themes](/guides/configure/appearance/themes) and defining a block style. ## Accessibility For information about how colour affects accessibility, see [Colour and -accessibility](/guides/configure/web/colour-a11y) +accessibility](/guides/configure/colour-a11y) diff --git a/packages/docs/docs/guides/configure/web/appearance/colour-formats.mdx b/packages/docs/docs/guides/configure/appearance/colour-formats.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/appearance/colour-formats.mdx rename to packages/docs/docs/guides/configure/appearance/colour-formats.mdx index bac458655..c04a5b877 100644 --- a/packages/docs/docs/guides/configure/web/appearance/colour-formats.mdx +++ b/packages/docs/docs/guides/configure/appearance/colour-formats.mdx @@ -58,7 +58,7 @@ W3C](https://www.w3.org/TR/css-color-3/#html4). Often, multiple blocks share the same colour, and centralizing the colour definitions simplifies managing the colours and adding new blocks of the correct colour. Block colours and toolbox categories can use [localization -tokens](/guides/configure/web/translations#use-localization-tokens-in-json) +tokens](/guides/configure/translations#use-localization-tokens-in-json) to do exactly that. Blockly includes nine colour constants in the string table, corresponding to the diff --git a/packages/docs/docs/guides/configure/web/appearance/css.mdx b/packages/docs/docs/guides/configure/appearance/css.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/appearance/css.mdx rename to packages/docs/docs/guides/configure/appearance/css.mdx index c50b99a85..77868ef31 100644 --- a/packages/docs/docs/guides/configure/web/appearance/css.mdx +++ b/packages/docs/docs/guides/configure/appearance/css.mdx @@ -20,7 +20,7 @@ You can use CSS to style your application: For a practical introduction to using CSS in blockly, see the [Use CSS in Blockly](/codelabs/css/codelab-overview) :::note -The easiest way to style Blockly is with [themes](/guides/configure/web/appearance/themes). If you need finer-grained control, use CSS. +The easiest way to style Blockly is with [themes](/guides/configure/appearance/themes). If you need finer-grained control, use CSS. ::: ## CSS classes @@ -67,12 +67,12 @@ To add or remove a CSS class from a workspace's injection `
`, call To add a CSS class to a button or a label in a toolbox, use the `web-class` key in your JSON definition of the toolbox. For more information, see [Buttons and -labels](/guides/configure/web/toolboxes/buttons). +labels](/guides/configure/toolboxes/buttons). To override the CSS classes used for the various parts of a category, use the `cssConfig` key in your JSON definition of the category. This allows you to style individual categories. For more information, see [Category -CSS](/guides/configure/web/toolboxes/appearance#category-css). +CSS](/guides/configure/toolboxes/appearance#category-css). #### Blocks @@ -294,7 +294,7 @@ tag. The rules in this tag come from: `Blockly.css.register`](https://github.com/search?q=repo%3ARaspberryPiFoundation%2Fblockly+css.register+path%3Acore&type=code). If you do not want to use these rules, set the [`css` configuration -option](/guides/configure/web/configuration_struct#the-options-dictionary) +option](/guides/configure/configuration_struct#the-options-dictionary) to `false`. In this case, you are responsible for providing an alternate set of CSS rules. diff --git a/packages/docs/docs/guides/configure/web/appearance/themes.mdx b/packages/docs/docs/guides/configure/appearance/themes.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/appearance/themes.mdx rename to packages/docs/docs/guides/configure/appearance/themes.mdx index ccc064367..6f841128d 100644 --- a/packages/docs/docs/guides/configure/web/appearance/themes.mdx +++ b/packages/docs/docs/guides/configure/appearance/themes.mdx @@ -20,13 +20,13 @@ empower developers to create Blockly experiences that are more accessible. For a practical introduction to using themes, see the [Customizing your themes](/codelabs/theme-extension-identifier/codelab-overview) :::note -The easiest way to style Blockly is with themes. If you need finer-grained control, use [CSS](/guides/configure/web/appearance/css). +The easiest way to style Blockly is with themes. If you need finer-grained control, use [CSS](/guides/configure/appearance/css). ::: :::note If you only want to control the main colour of a block, rather than have more fine-grained control over the appearance, you can set the colour in the -[block definition](/guides/configure/web/appearance/block-colour#set-block-colour) +[block definition](/guides/configure/appearance/block-colour#set-block-colour) instead of creating a theme. If you want to change the shape of a block instead of its colour, learn more about [renderers](/guides/create-custom-blocks/renderers/overview). @@ -177,7 +177,7 @@ Learn more about the use cases of start hats on our If you set `startHats: true` directly in a theme object, a hat will be added to all blocks with no previous or output connections. If you want more control over exactly which blocks get a hat, you can instead use the -[block style](/guides/configure/web/appearance/themes/#block-style) property. +[block style](/guides/configure/appearance/themes/#block-style) property. ## Custom Themes diff --git a/packages/docs/docs/guides/configure/web/block_comment.mdx b/packages/docs/docs/guides/configure/block_comment.mdx similarity index 95% rename from packages/docs/docs/guides/configure/web/block_comment.mdx rename to packages/docs/docs/guides/configure/block_comment.mdx index 97e514b05..159fd57b2 100644 --- a/packages/docs/docs/guides/configure/web/block_comment.mdx +++ b/packages/docs/docs/guides/configure/block_comment.mdx @@ -67,4 +67,4 @@ of the block (such as whether it is editable or collapsed) or the setting of the `comments` configuration option. [editable]: /guides/create-custom-blocks/define/block-state#editable-state -[config-option]: /guides/configure/web/configuration_struct#the-options-dictionary +[config-option]: /guides/configure/configuration_struct#the-options-dictionary diff --git a/packages/docs/docs/guides/configure/web/colour-a11y.mdx b/packages/docs/docs/guides/configure/colour-a11y.mdx similarity index 92% rename from packages/docs/docs/guides/configure/web/colour-a11y.mdx rename to packages/docs/docs/guides/configure/colour-a11y.mdx index 033851c6b..5dbea6dd2 100644 --- a/packages/docs/docs/guides/configure/web/colour-a11y.mdx +++ b/packages/docs/docs/guides/configure/colour-a11y.mdx @@ -12,7 +12,7 @@ text on the block, and so not a critical attribute. However, when choosing a block colour palette, colour blindness should be a consideration. Blockly provides [several -themes](/guides/configure/web/appearance/themes#built-in) in an effort +themes](/guides/configure/appearance/themes#built-in) in an effort to accommodate some types of colour vision deficiency. [This page](http://mkweb.bcgsc.ca/colorblind/palettes.mhtml#projecthome) includes example 8, 12, 15, and 24 colour palettes that attempt to maximize distinction diff --git a/packages/docs/docs/guides/configure/web/configuration_struct.mdx b/packages/docs/docs/guides/configure/configuration_struct.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/configuration_struct.mdx rename to packages/docs/docs/guides/configure/configuration_struct.mdx index 28d685447..2fe83855b 100644 --- a/packages/docs/docs/guides/configure/web/configuration_struct.mdx +++ b/packages/docs/docs/guides/configure/configuration_struct.mdx @@ -67,14 +67,14 @@ default value based on whether the provided toolbox has categories or not. | `trashcan` | boolean | Displays or hides the trashcan. Defaults to `true` if the toolbox has categories, `false` otherwise. | | `zoom` | object | Configures zooming behaviour. See [Zoom]. | -[Grid]: /guides/configure/web/grid -[media]: /guides/configure/web/media -[Move]: /guides/configure/web/move +[Grid]: /guides/configure/grid +[media]: /guides/configure/media +[Move]: /guides/configure/move [setIsReadOnly]: /reference/blockly.workspace.setisreadonly [isReadOnly]: /reference/blockly.workspace.isreadonly [renderer]: /guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation [RTL demo]: https://raspberrypifoundation.github.io/blockly-samples/examples/rtl-demo/ -[Themes]: /guides/configure/web/appearance/themes -[defining the toolbox]: /guides/configure/web/toolboxes/toolbox -[Zoom]: /guides/configure/web/zoom -[replacement]: /guides/configure/web/customization#injecting-subclasses +[Themes]: /guides/configure/appearance/themes +[defining the toolbox]: /guides/configure/toolboxes/toolbox +[Zoom]: /guides/configure/zoom +[replacement]: /guides/configure/customization#injecting-subclasses diff --git a/packages/docs/docs/guides/configure/web/context-menus.mdx b/packages/docs/docs/guides/configure/context-menus.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/context-menus.mdx rename to packages/docs/docs/guides/configure/context-menus.mdx index 55e565d7c..e535f1d96 100644 --- a/packages/docs/docs/guides/configure/web/context-menus.mdx +++ b/packages/docs/docs/guides/configure/context-menus.mdx @@ -58,7 +58,7 @@ Blockly defines a standard set of templates for the context menus for workspaces, blocks, and workspace comments. It preloads the templates for workspaces and blocks into the registry. If you want to use the templates for workspace comments, you must [load them into the registry -yourself](/guides/configure/web/workspace_comment#enable-workspace-comments). +yourself](/guides/configure/workspace_comment#enable-workspace-comments). For information on how to add, delete, and modify templates in the registry, see [Customize the registry](#customize-the-registry). @@ -83,7 +83,7 @@ context menu was invoked is stored in the `focusedNode` property as an object that implements [`IFocusableNode`][i-focusable-node]. (`IFocusableNode` is implemented by all components that users can focus on, including those that implement context menus. For more information, see [Focus -system](/guides/configure/web/focus).) +system](/guides/configure/focus).) The `Scope` object is passed to several of the functions in a template. In any function that gets a `Scope` object, you can decide what to do based on the type @@ -470,5 +470,5 @@ steps: [configureContextMenu]: /reference/blockly.workspacesvg.configurecontextmenu [ContextMenuOption]: /reference/blockly.contextmenuregistry.contextmenuoption [LegacyContextMenuOption]: /reference/blockly.contextmenuregistry.legacycontextmenuoption -[coordinate-systems]: /guides/configure/web/metrics_manager#coordinate-systems -[keyboard-navigation-plugin]: /guides/configure/web/keyboard-nav +[coordinate-systems]: /guides/configure/metrics_manager#coordinate-systems +[keyboard-navigation-plugin]: /guides/configure/keyboard-nav diff --git a/packages/docs/docs/guides/configure/web/copy-paste.mdx b/packages/docs/docs/guides/configure/copy-paste.mdx similarity index 95% rename from packages/docs/docs/guides/configure/web/copy-paste.mdx rename to packages/docs/docs/guides/configure/copy-paste.mdx index 792dfb0df..22c3bba88 100644 --- a/packages/docs/docs/guides/configure/web/copy-paste.mdx +++ b/packages/docs/docs/guides/configure/copy-paste.mdx @@ -152,16 +152,16 @@ find the paster associated with a given copy data from its `paster` property. Blockly.clipboard.registry.register('MY_PASTER', new MyPaster()); ``` -[implement-paster]: /guides/configure/web/copy-paste#implement-a-paster +[implement-paster]: /guides/configure/copy-paste#implement-a-paster [ICopyable]: /reference/blockly.icopyable [IDeletable]: /reference/blockly.ideletable [IDraggable]: /reference/blockly.idraggable [ICopyData]: /reference/blockly.icopyable.icopydata [IPaster]: /reference/blockly.ipaster [ISelectable]: /reference/blockly.iselectable -[default-keyboard-shortcuts]: /guides/configure/web/keyboard-shortcuts#default-shortcuts -[context-menu-option]: /guides/configure/web/context-menus -[custom-draggables]: /guides/configure/web/dragging/draggable +[default-keyboard-shortcuts]: /guides/configure/keyboard-shortcuts#default-shortcuts +[context-menu-option]: /guides/configure/context-menus +[custom-draggables]: /guides/configure/dragging/draggable [multiselect-plugin]: https://www.npmjs.com/package/@mit-app-inventor/blockly-plugin-workspace-multiselect [cross-tab-copy-paste-plugin]: https://www.npmjs.com/package/@blockly/plugin-cross-tab-copy-paste [clipboard-namespace]: /reference/blockly.clipboard diff --git a/packages/docs/docs/guides/configure/web/customization.mdx b/packages/docs/docs/guides/configure/customization.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/customization.mdx rename to packages/docs/docs/guides/configure/customization.mdx index 803801006..9f82fbde2 100644 --- a/packages/docs/docs/guides/configure/web/customization.mdx +++ b/packages/docs/docs/guides/configure/customization.mdx @@ -84,7 +84,7 @@ Blockly.registry.register( ### Inject your replacement class \{#injecting-subclasses\} You can also inject replacement classes using the `plugins` [configuration -option](/guides/configure/web/configuration_struct#the-options-dictionary). +option](/guides/configure/configuration_struct#the-options-dictionary). This is an object that uses [registry type names](#replaceable-classes) as property names and replacement classes or registered names as property values. diff --git a/packages/docs/docs/guides/configure/web/dragging/block-drag-strategies.mdx b/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx similarity index 92% rename from packages/docs/docs/guides/configure/web/dragging/block-drag-strategies.mdx rename to packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx index fc9501ea6..3d07344dd 100644 --- a/packages/docs/docs/guides/configure/web/dragging/block-drag-strategies.mdx +++ b/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx @@ -45,8 +45,8 @@ Blockly.Blocks['my_block'] = { }; ``` -[draggable]: /guides/configure/web/dragging/draggable -[draggable-implementation]: /guides/configure/web/dragging/draggable#implementation +[draggable]: /guides/configure/dragging/draggable +[draggable-implementation]: /guides/configure/dragging/draggable#implementation [setDragStrategy]: /reference/blockly.blocksvg.setdragstrategy [IDraggable]: /reference/blockly.idraggable [IDragStrategy]: /reference/blockly.idragstrategy diff --git a/packages/docs/docs/guides/configure/web/dragging/draggable.mdx b/packages/docs/docs/guides/configure/dragging/draggable.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/dragging/draggable.mdx rename to packages/docs/docs/guides/configure/dragging/draggable.mdx index ecad1d959..806860961 100644 --- a/packages/docs/docs/guides/configure/web/dragging/draggable.mdx +++ b/packages/docs/docs/guides/configure/dragging/draggable.mdx @@ -231,7 +231,7 @@ For more information about copying pasting see [Copy paste][copy-paste]. [multiselect-plugin]: https://www.npmjs.com/package/@mit-app-inventor/blockly-plugin-workspace-multiselect {/* This doesn't exist yet */} -[events]: /guides/configure/web/events +[events]: /guides/configure/events [IRenderedElement]: /reference/blockly.irenderedelement [IDraggable]: /reference/blockly.idraggable [IDeletable]: /reference/blockly.ideletable @@ -240,4 +240,4 @@ For more information about copying pasting see [Copy paste][copy-paste]. [svg-group]: https://developer.mozilla.org/en-US/docs/Web/SVG/Element/g [Coordinate]: /reference/blockly.utils.coordinate [drag-target]: /reference/blockly.dragtarget -[copy-paste]: /guides/configure/web/copy-paste +[copy-paste]: /guides/configure/copy-paste diff --git a/packages/docs/docs/guides/configure/web/dragging/dragger.mdx b/packages/docs/docs/guides/configure/dragging/dragger.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/dragging/dragger.mdx rename to packages/docs/docs/guides/configure/dragging/dragger.mdx index a1536a6f7..201b2010a 100644 --- a/packages/docs/docs/guides/configure/web/dragging/dragger.mdx +++ b/packages/docs/docs/guides/configure/dragging/dragger.mdx @@ -168,7 +168,7 @@ const myWorkspace = Blockly.inject('blocklyDiv', { }); ``` -[draggable]: /guides/configure/web/dragging/draggable +[draggable]: /guides/configure/dragging/draggable [drag-target]: /reference/blockly.dragtarget [scroll-options-plugin]: https://www.npmjs.com/package/@blockly/plugin-scroll-options [IDragger]: /reference/blockly.idragger diff --git a/packages/docs/docs/guides/configure/web/events.mdx b/packages/docs/docs/guides/configure/events.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/events.mdx rename to packages/docs/docs/guides/configure/events.mdx diff --git a/packages/docs/docs/guides/configure/web/fixed-size.mdx b/packages/docs/docs/guides/configure/fixed-size.mdx similarity index 95% rename from packages/docs/docs/guides/configure/web/fixed-size.mdx rename to packages/docs/docs/guides/configure/fixed-size.mdx index 27fa44b8a..f8328a405 100644 --- a/packages/docs/docs/guides/configure/web/fixed-size.mdx +++ b/packages/docs/docs/guides/configure/fixed-size.mdx @@ -24,7 +24,7 @@ Add an empty `div` somewhere in the page's body and set its size: ## 3. Inject the workspace -[Define the toolbox](/guides/configure/web/toolboxes/toolbox) structure: +[Define the toolbox](/guides/configure/toolboxes/toolbox) structure: ```js const toolbox = { diff --git a/packages/docs/docs/guides/configure/web/focus.mdx b/packages/docs/docs/guides/configure/focus.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/focus.mdx rename to packages/docs/docs/guides/configure/focus.mdx index f4290cfc1..fcf423f94 100644 --- a/packages/docs/docs/guides/configure/web/focus.mdx +++ b/packages/docs/docs/guides/configure/focus.mdx @@ -121,7 +121,7 @@ Suppose a block with two fields has Blockly focus, as indicated by a highlight arrow: 1. The [keyboard navigation - plugin](/guides/configure/web/keyboard-nav): + plugin](/guides/configure/keyboard-nav): - Receives a key press event. - Asks the navigation system (a part of core Blockly) to move focus to the "next" component. @@ -163,11 +163,11 @@ Here are some other examples: - When a block is deleted, its `dispose` method calls the focus manager to move focus to the block's parent. -- [Keyboard shortcuts](/guides/configure/web/keyboard-shortcuts) use +- [Keyboard shortcuts](/guides/configure/keyboard-shortcuts) use `IFocusableNode` to identify the Blockly component to which the shortcut applies. -- [Context menus](/guides/configure/web/context-menus) use +- [Context menus](/guides/configure/context-menus) use `IFocusableNode` to identify the Blockly component on which the menu was invoked. diff --git a/packages/docs/docs/guides/configure/web/grid.mdx b/packages/docs/docs/guides/configure/grid.mdx similarity index 96% rename from packages/docs/docs/guides/configure/web/grid.mdx rename to packages/docs/docs/guides/configure/grid.mdx index 43aab826a..6c458c319 100644 --- a/packages/docs/docs/guides/configure/web/grid.mdx +++ b/packages/docs/docs/guides/configure/grid.mdx @@ -13,7 +13,7 @@ large area. The grid's settings are defined by an object that is part of Blockly's [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary). +options](/guides/configure/configuration_struct#the-options-dictionary). Here is an example: ```js diff --git a/packages/docs/docs/guides/configure/web/keyboard-nav.mdx b/packages/docs/docs/guides/configure/keyboard-nav.mdx similarity index 94% rename from packages/docs/docs/guides/configure/web/keyboard-nav.mdx rename to packages/docs/docs/guides/configure/keyboard-nav.mdx index 38a843166..78bf321e3 100644 --- a/packages/docs/docs/guides/configure/web/keyboard-nav.mdx +++ b/packages/docs/docs/guides/configure/keyboard-nav.mdx @@ -7,7 +7,7 @@ image: images/blockly_banner.png # Keyboard navigation Blockly provides keyboard navigation through the `@blockly/keyboard-navigation` -plugin. This code uses the [focus system](/guides/configure/web/focus) +plugin. This code uses the [focus system](/guides/configure/focus) and will eventually be integrated into Blockly core. You can [download the plugin from diff --git a/packages/docs/docs/guides/configure/web/keyboard-shortcuts.mdx b/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/keyboard-shortcuts.mdx rename to packages/docs/docs/guides/configure/keyboard-shortcuts.mdx index 39a53aa9a..7fa26431d 100644 --- a/packages/docs/docs/guides/configure/web/keyboard-shortcuts.mdx +++ b/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx @@ -44,7 +44,7 @@ implements [`IFocusableNode`](/reference/blockly.ifocusablenode). This interface is implemented by all Blockly components that the user can focus on, including workspaces, blocks, fields, comments, and your own custom components; -for more information, see [Focus system](/guides/configure/web/focus). +for more information, see [Focus system](/guides/configure/focus). For example, a `preconditionFn` might use `focusedNode` to ensure that a shortcut only applies to blocks. @@ -274,7 +274,7 @@ The shortcuts are defined in the `registerXxxx` functions. ## Keyboard navigation shortcuts -The [keyboard navigation plugin](/guides/configure/web/keyboard-nav) +The [keyboard navigation plugin](/guides/configure/keyboard-nav) contains shortcuts that allow users to navigate Blockly with the keyboard, such as by using arrow keys. Keyboard navigation is essential for users who cannot use a mouse, such as those with motor or visual impairments. It is also useful diff --git a/packages/docs/docs/guides/configure/web/media.mdx b/packages/docs/docs/guides/configure/media.mdx similarity index 92% rename from packages/docs/docs/guides/configure/web/media.mdx rename to packages/docs/docs/guides/configure/media.mdx index 8d6268219..c2171b247 100644 --- a/packages/docs/docs/guides/configure/web/media.mdx +++ b/packages/docs/docs/guides/configure/media.mdx @@ -18,7 +18,7 @@ or if you want your application to only make HTTP requests to your domain: place them in your own media folder. 1. Replace any assets you want to customize. 1. Set the `media` property in the [configuration - options](/guides/configure/web/configuration_struct#the-options-dictionary) + options](/guides/configure/configuration_struct#the-options-dictionary) to the URL of your media folder. This can be an absolute URL or a path relative to the current file. 1. Deploy your media folder and all of its assets along with the rest of your diff --git a/packages/docs/docs/guides/configure/web/metrics_manager.mdx b/packages/docs/docs/guides/configure/metrics_manager.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/metrics_manager.mdx rename to packages/docs/docs/guides/configure/metrics_manager.mdx diff --git a/packages/docs/docs/guides/configure/web/move.mdx b/packages/docs/docs/guides/configure/move.mdx similarity index 94% rename from packages/docs/docs/guides/configure/web/move.mdx rename to packages/docs/docs/guides/configure/move.mdx index bd31edf76..05fd9b8d2 100644 --- a/packages/docs/docs/guides/configure/web/move.mdx +++ b/packages/docs/docs/guides/configure/move.mdx @@ -11,7 +11,7 @@ scrollbars, the mouse, or the mouse wheel. The move settings are defined by an object that is part of Blockly's [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary). +options](/guides/configure/configuration_struct#the-options-dictionary). Here is an example: ```js diff --git a/packages/docs/docs/guides/configure/web/resizable.mdx b/packages/docs/docs/guides/configure/resizable.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/resizable.mdx rename to packages/docs/docs/guides/configure/resizable.mdx index ce48f152b..a81bf1b94 100644 --- a/packages/docs/docs/guides/configure/web/resizable.mdx +++ b/packages/docs/docs/guides/configure/resizable.mdx @@ -28,7 +28,7 @@ of a table cell that fills the bottom of the screen. ## 2. Inject the workspace Injecting Blockly is the same as the process described in -[injecting fixed-sized Blockly](/guides/configure/web/fixed-size). +[injecting fixed-sized Blockly](/guides/configure/fixed-size). Add the code, the `blocklyDiv` element, a toolbox, and an injection call. Blockly should now be running on the page, just not located where it should be diff --git a/packages/docs/docs/guides/configure/web/serialization.mdx b/packages/docs/docs/guides/configure/serialization.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/serialization.mdx rename to packages/docs/docs/guides/configure/serialization.mdx index 08a02e921..1b2ce1419 100644 --- a/packages/docs/docs/guides/configure/web/serialization.mdx +++ b/packages/docs/docs/guides/configure/serialization.mdx @@ -78,7 +78,7 @@ prevent duplicating state within a save. When `Blockly.serialization.workspaces.load` is called, serializers are given state to deserialize in order of _priority_. This is explained further in the -[Serializers](/guides/configure/web/serialization#serializer-hooks) +[Serializers](/guides/configure/serialization#serializer-hooks) section, and its purpose is to allow serializers to depend on state from other systems. @@ -170,7 +170,7 @@ When you register a serializer you must provide several things: - A function to `clear` the state. - A function to `load` the state. - A `priority`, which is used to determine the [deserialization - order](/guides/configure/web/serialization#deserialization-order). + order](/guides/configure/serialization#deserialization-order). You can base the priority of your serializer on the [built-in priorities](/reference/blockly.serialization.priorities) diff --git a/packages/docs/docs/guides/configure/web/toolboxes/appearance.mdx b/packages/docs/docs/guides/configure/toolboxes/appearance.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/toolboxes/appearance.mdx rename to packages/docs/docs/guides/configure/toolboxes/appearance.mdx index 7e089bb62..2a74249a3 100644 --- a/packages/docs/docs/guides/configure/web/toolboxes/appearance.mdx +++ b/packages/docs/docs/guides/configure/toolboxes/appearance.mdx @@ -138,7 +138,7 @@ class to assign the label color: ## Themes -[Themes](/guides/configure/web/appearance/themes) allow you to specify all of the +[Themes](/guides/configure/appearance/themes) allow you to specify all of the colours of your workspace at once, including the colours of your categories. If you need finer-grained control, use CSS. @@ -200,4 +200,4 @@ spelling. Note that we also support using localizable [colour -references](/guides/configure/web/appearance/colour-formats#colour-references). +references](/guides/configure/appearance/colour-formats#colour-references). diff --git a/packages/docs/docs/guides/configure/web/toolboxes/buttons.mdx b/packages/docs/docs/guides/configure/toolboxes/buttons.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/buttons.mdx rename to packages/docs/docs/guides/configure/toolboxes/buttons.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/category.mdx b/packages/docs/docs/guides/configure/toolboxes/category.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/toolboxes/category.mdx rename to packages/docs/docs/guides/configure/toolboxes/category.mdx index 87977baca..22453cea8 100644 --- a/packages/docs/docs/guides/configure/web/toolboxes/category.mdx +++ b/packages/docs/docs/guides/configure/toolboxes/category.mdx @@ -18,7 +18,7 @@ blocks.](/images/toolbox-categories.png) To create a category toolbox, pass JSON or XML describing the toolbox to the `toolbox` property of the [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary). +options](/guides/configure/configuration_struct#the-options-dictionary). diff --git a/packages/docs/docs/guides/configure/web/toolboxes/disable-categories.mdx b/packages/docs/docs/guides/configure/toolboxes/disable-categories.mdx similarity index 97% rename from packages/docs/docs/guides/configure/web/toolboxes/disable-categories.mdx rename to packages/docs/docs/guides/configure/toolboxes/disable-categories.mdx index 870fafdde..60b1a829c 100644 --- a/packages/docs/docs/guides/configure/web/toolboxes/disable-categories.mdx +++ b/packages/docs/docs/guides/configure/toolboxes/disable-categories.mdx @@ -62,7 +62,7 @@ category.show(); ## Expand categories This only applies to categories which contain other [nested -categories](/guides/configure/web/toolboxes/nested). +categories](/guides/configure/toolboxes/nested). An expanded category will show you its sub categories. By default, nested categories are collapsed, and need to be clicked to be expanded. diff --git a/packages/docs/docs/guides/configure/web/toolboxes/dynamic.mdx b/packages/docs/docs/guides/configure/toolboxes/dynamic.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/dynamic.mdx rename to packages/docs/docs/guides/configure/toolboxes/dynamic.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/flyout.mdx b/packages/docs/docs/guides/configure/toolboxes/flyout.mdx similarity index 95% rename from packages/docs/docs/guides/configure/web/toolboxes/flyout.mdx rename to packages/docs/docs/guides/configure/toolboxes/flyout.mdx index 09f264730..00ac40f33 100644 --- a/packages/docs/docs/guides/configure/web/toolboxes/flyout.mdx +++ b/packages/docs/docs/guides/configure/toolboxes/flyout.mdx @@ -16,7 +16,7 @@ blocks.](/images/toolbox-minimal.png) To create a flyout toolbox, pass JSON or XML describing the toolbox to the `toolbox` property of the [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary). +options](/guides/configure/configuration_struct#the-options-dictionary). diff --git a/packages/docs/docs/guides/configure/web/toolboxes/modify.mdx b/packages/docs/docs/guides/configure/toolboxes/modify.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/modify.mdx rename to packages/docs/docs/guides/configure/toolboxes/modify.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/nested.mdx b/packages/docs/docs/guides/configure/toolboxes/nested.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/nested.mdx rename to packages/docs/docs/guides/configure/toolboxes/nested.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/preset.mdx b/packages/docs/docs/guides/configure/toolboxes/preset.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/preset.mdx rename to packages/docs/docs/guides/configure/toolboxes/preset.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/programmatic.mdx b/packages/docs/docs/guides/configure/toolboxes/programmatic.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/programmatic.mdx rename to packages/docs/docs/guides/configure/toolboxes/programmatic.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/separators.mdx b/packages/docs/docs/guides/configure/toolboxes/separators.mdx similarity index 100% rename from packages/docs/docs/guides/configure/web/toolboxes/separators.mdx rename to packages/docs/docs/guides/configure/toolboxes/separators.mdx diff --git a/packages/docs/docs/guides/configure/web/toolboxes/toolbox.mdx b/packages/docs/docs/guides/configure/toolboxes/toolbox.mdx similarity index 83% rename from packages/docs/docs/guides/configure/web/toolboxes/toolbox.mdx rename to packages/docs/docs/guides/configure/toolboxes/toolbox.mdx index 15530f825..4cd75cc88 100644 --- a/packages/docs/docs/guides/configure/web/toolboxes/toolbox.mdx +++ b/packages/docs/docs/guides/configure/toolboxes/toolbox.mdx @@ -9,9 +9,9 @@ image: images/blockly_banner.png The toolbox is the place where users get blocks. Usually it is displayed on one side of the workspace. -A [flyout toolbox](/guides/configure/web/toolboxes/flyout) has a single +A [flyout toolbox](/guides/configure/toolboxes/flyout) has a single set of blocks that are displayed at all times. A [category -toolbox](/guides/configure/web/toolboxes/category) has multiple sets of +toolbox](/guides/configure/toolboxes/category) has multiple sets of blocks that are arranged into different categories. Toolboxes can be defined using JSON (as of the [September 2020 @@ -21,7 +21,7 @@ The JSON format is preferred. This section mainly focuses on how to specify the _structure_ of your toolbox (i.e. what categories it has, and what blocks they contain). If you want more details about how to change the _appearance_ of your toolbox, see [Category -appearance](/guides/configure/web/toolboxes/appearance), the +appearance](/guides/configure/toolboxes/appearance), the [Customizing a Blockly toolbox codelab](/codelabs/custom-toolbox/codelab-overview), and the [2021 Toolbox APIs diff --git a/packages/docs/docs/guides/configure/web/translations.mdx b/packages/docs/docs/guides/configure/translations.mdx similarity index 99% rename from packages/docs/docs/guides/configure/web/translations.mdx rename to packages/docs/docs/guides/configure/translations.mdx index c1af5436c..f38e3e6df 100644 --- a/packages/docs/docs/guides/configure/web/translations.mdx +++ b/packages/docs/docs/guides/configure/translations.mdx @@ -390,4 +390,4 @@ And in the XML definition of a toolbox in the following attributes of - `colour` For more information about using token references as colour values, see [Colour -references](/guides/configure/web/appearance/colour-formats#colour-references). +references](/guides/configure/appearance/colour-formats#colour-references). diff --git a/packages/docs/docs/guides/configure/web/workspace_comment.mdx b/packages/docs/docs/guides/configure/workspace_comment.mdx similarity index 98% rename from packages/docs/docs/guides/configure/web/workspace_comment.mdx rename to packages/docs/docs/guides/configure/workspace_comment.mdx index 89add5bd5..ea09de9b4 100644 --- a/packages/docs/docs/guides/configure/web/workspace_comment.mdx +++ b/packages/docs/docs/guides/configure/workspace_comment.mdx @@ -190,11 +190,11 @@ Blockly.comments.CommentView.defaultCommentSize = new Blockly.utils.Size( ); ``` -[context-menus]: /guides/configure/web/context-menus +[context-menus]: /guides/configure/context-menus [flyout]: /guides/get-started/workspace-anatomy#flyout-toolbox -[themes]: /guides/configure/web/appearance/themes +[themes]: /guides/configure/appearance/themes [svg-image-element]: https://developer.mozilla.org/en-US/docs/Web/SVG/Element/image -[media]: /guides/configure/web/media +[media]: /guides/configure/media [workspace-comment-image]: /images/workspace-comments/workspace-comment.png [coloured-workspace-comment-image]: /images/workspace-comments/coloured-comment.png [workspace-comment-outline-image]: /images/workspace-comments/workspace-comment-outline.png diff --git a/packages/docs/docs/guides/configure/web/zoom.mdx b/packages/docs/docs/guides/configure/zoom.mdx similarity index 95% rename from packages/docs/docs/guides/configure/web/zoom.mdx rename to packages/docs/docs/guides/configure/zoom.mdx index b4b4b5261..0f6820ba4 100644 --- a/packages/docs/docs/guides/configure/web/zoom.mdx +++ b/packages/docs/docs/guides/configure/zoom.mdx @@ -11,7 +11,7 @@ or statically by the developer. The zoom settings are defined by an object that is part of Blockly's [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary). +options](/guides/configure/configuration_struct#the-options-dictionary). Here is an example: ```js diff --git a/packages/docs/docs/guides/contribute/core/add_localization_token.mdx b/packages/docs/docs/guides/contribute/core/add_localization_token.mdx index bbc636918..9de4551e8 100644 --- a/packages/docs/docs/guides/contribute/core/add_localization_token.mdx +++ b/packages/docs/docs/guides/contribute/core/add_localization_token.mdx @@ -131,5 +131,5 @@ Blockly.Msg.LOGIC_HUE = '210'; ``` [translatewiki]: /guides/contribute/core/translating -[localization]: /guides/configure/web/translations -[block-colour]: /guides/configure/web/appearance/block-colour#set-block-colour +[localization]: /guides/configure/translations +[block-colour]: /guides/configure/appearance/block-colour#set-block-colour diff --git a/packages/docs/docs/guides/contribute/samples/naming.mdx b/packages/docs/docs/guides/contribute/samples/naming.mdx index 386e916c3..90dafbdf9 100644 --- a/packages/docs/docs/guides/contribute/samples/naming.mdx +++ b/packages/docs/docs/guides/contribute/samples/naming.mdx @@ -37,7 +37,7 @@ Blockly workspaces on the page. ### Theme A theme plugin publishes a single Blockly -[theme](/guides/configure/web/appearance/themes). +[theme](/guides/configure/appearance/themes). Loading a theme plugin defines a new theme that can then be used in all Blockly workspaces on the page. diff --git a/packages/docs/docs/guides/create-custom-blocks/blockly-developer-tools.md b/packages/docs/docs/guides/create-custom-blocks/blockly-developer-tools.md index f6a1bf780..f319db01a 100644 --- a/packages/docs/docs/guides/create-custom-blocks/blockly-developer-tools.md +++ b/packages/docs/docs/guides/create-custom-blocks/blockly-developer-tools.md @@ -133,9 +133,7 @@ headers are present in the file where you include this code. This video walks through the steps of defining a block in detail. The UI is out date, but the block features it highlights are still more or less accurate. - - +[Watch the video on YouTube](https://www.youtube.com/watch?v=s2_xaEvcVI0). ## Block library @@ -152,18 +150,12 @@ following these steps: 1. In the legacy Block Factory, click the `Export Block Library` button in the toolbar. This will download a file with all of your block definitions. - ![Screenshot of the legacy Block Factory with the "Export Block Library" - - button - highlighted](/images/block-factory/block_factory_legacy_export.png) + ![Screenshot of the legacy Block Factory with the "Export Block Library" button highlighted](/images/block-factory/block_factory_legacy_export.png) 1. In the new Block Factory, click the "Load block" button in the toolbar. 1. Select the "Import from Block Factory" option in the menu. - ![Screenshot of the Block Factory showing the "Load block" and "Import" - - buttons - highlighted](/images/block-factory/block_factory_import.png) + ![Screenshot of the Block Factory showing the "Load block" and "Import" buttons highlighted](/images/block-factory/block_factory_import.png) 1. Upload the file you downloaded in Step 1. 1. Your block definitions should be automatically converted to the new format @@ -181,7 +173,7 @@ following these steps: [block-code-generator]: /guides/create-custom-blocks/code-generation/overview#block-code-generators [inputs]: /guides/get-started/workspace-anatomy#inputs [fields]: /guides/get-started/workspace-anatomy#fields -[toolbox-preset]: /guides/configure/web/toolboxes/preset +[toolbox-preset]: /guides/configure/toolboxes/preset [mutators]: /guides/create-custom-blocks/mutators [loading-blockly]: /guides/get-started/get-the-code#get-the-code-1 [code-generation]: /guides/create-custom-blocks/code-generation/overview#language-code-generators diff --git a/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx b/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx index ab3532d3c..318ce0713 100644 --- a/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx @@ -12,7 +12,7 @@ import TabItem from '@theme/TabItem'; Blockly has two ways of defining blocks: JSON objects, which use key-value pairs, and JavaScript functions, which call Blockly's API. The JSON format is preferred because it [simplifies -localization](/guides/configure/web/translations#json-message-interpolation) +localization](/guides/configure/translations#json-message-interpolation) and is easier to read and write. However, it cannot be used to directly define advanced features such as mutators or validators. These must be written in JavaScript, usually as diff --git a/packages/docs/docs/guides/create-custom-blocks/define/modify-definitions.mdx b/packages/docs/docs/guides/create-custom-blocks/define/modify-definitions.mdx index bfbff17de..4bc8240d5 100644 --- a/packages/docs/docs/guides/create-custom-blocks/define/modify-definitions.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/define/modify-definitions.mdx @@ -64,7 +64,7 @@ magically replace just one line. There are several problems with this: function to copy -- it's generated at run time. - It requires you to define your block using JavaScript, which may [cause problems with - localization](/guides/configure/web/translations#json-message-interpolation). + localization](/guides/configure/translations#json-message-interpolation). ### Overwrite the results of init @@ -92,7 +92,7 @@ Unfortunately, this is less useful that it seems. For example: field validators and may break event handlers. It may also be extremely difficult to do for localized blocks because different locales may result in blocks with [different types and orders of inputs and - fields](/guides/configure/web/translations#json-message-interpolation). + fields](/guides/configure/translations#json-message-interpolation). ### Overwrite a key-value pair in a JSON definition diff --git a/packages/docs/docs/guides/create-custom-blocks/define/structure-json.mdx b/packages/docs/docs/guides/create-custom-blocks/define/structure-json.mdx index a7127a267..471a9d256 100644 --- a/packages/docs/docs/guides/create-custom-blocks/define/structure-json.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/define/structure-json.mdx @@ -297,7 +297,7 @@ inputs. The ability to change the order of the interpolation tokens in a message makes localization easier. For more information, see [JSON message -interpolation](/guides/configure/web/translations#json-message-interpolation). +interpolation](/guides/configure/translations#json-message-interpolation). ## Text handling diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx index e79c4409c..e8575084a 100644 --- a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx @@ -105,7 +105,7 @@ Blockly.fieldRegistry.register('field_generic', GenericField); You also need to define your `fromJson` function. Your implementation should first dereference any [references to localization -tokens](/guides/configure/web/translations#use-localization-tokens-in-json) +tokens](/guides/configure/translations#use-localization-tokens-in-json) using [`replaceMessageReferences`](/reference/blockly.utils.parsing.replacemessagereferences), and then pass the values to the constructor. @@ -731,7 +731,7 @@ Messing with a field's cursor is fragile. ## Serialization -[Serialization](/guides/configure/web/serialization) is about saving the +[Serialization](/guides/configure/serialization) is about saving the state of your field so that it can be reloaded into the workspace later. The state of your workspace always includes the field's value, but it could also @@ -897,5 +897,5 @@ Before version 12.0.0, the `CURSOR` property determined the cursor. Its value was a valid CSS cursor string. ::: -[serializer]: /guides/configure/web/serialization#serializer-hooks +[serializer]: /guides/configure/serialization#serializer-hooks [field-generator]: /guides/create-custom-blocks/code-generation/overview#block-code-generators diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx index b1b678b0a..712d59ee0 100644 --- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx @@ -105,4 +105,4 @@ Blockly.icons.registry.register(new Blockly.icons.IconType('my_icon'), myIcon); [loadState]: /reference/blockly.iserializable.loadstate [IconType]: /reference/blockly.icons.icontype [getType]: /reference/blockly.iicon.gettype -[serializer]: /guides/configure/web/serialization#serializer-hooks +[serializer]: /guides/configure/serialization#serializer-hooks diff --git a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx index bb00a210f..4411c79e9 100644 --- a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx @@ -237,6 +237,6 @@ the [limitations](#limitations) of this one, you can create a custom connection checker. [connection-type]: /guides/create-custom-blocks/define/block-anatomy#connections -[event-system]: /guides/configure/web/events +[event-system]: /guides/configure/events [BlockMove]: /reference/blockly.events.blockmove [custom-connection-checker]: /guides/create-custom-blocks/inputs/connection_checker diff --git a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx index 9578d68fb..d3cbce824 100644 --- a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx @@ -211,4 +211,4 @@ For more information about registration, see [IConnectionPreviewer]: /reference/blockly.iconnectionpreviewer [insertion-marker]: /guides/get-started/workspace-anatomy#insertion-marker [custom-renderer]: /guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation -[inject-subclasses]: /guides/configure/web/customization#injecting-subclasses +[inject-subclasses]: /guides/configure/customization#injecting-subclasses diff --git a/packages/docs/docs/guides/create-custom-blocks/legacy-blockly-developer-tools.md b/packages/docs/docs/guides/create-custom-blocks/legacy-blockly-developer-tools.md index 5939668d5..95059e305 100644 --- a/packages/docs/docs/guides/create-custom-blocks/legacy-blockly-developer-tools.md +++ b/packages/docs/docs/guides/create-custom-blocks/legacy-blockly-developer-tools.md @@ -36,9 +36,7 @@ can easily create, modify, and save custom blocks. This video walks through the steps of defining a block in detail. The UI is out date, but the block features it highlights are still accurate. - - +[Watch the video on YouTube](https://www.youtube.com/watch?v=s2_xaEvcVI0). ### Managing the library @@ -116,7 +114,7 @@ starting workspace with the "Toolbox" and "Workspace" buttons. ### Building a toolbox This tab helps build the XML for a Toolbox. The material assumes -familiarity with features of a [Toolbox](/guides/configure/web/toolboxes/toolbox). +familiarity with features of a [Toolbox](/guides/configure/toolboxes/toolbox). If you already have XML for a toolbox that you want to edit here, you can load it by clicking "Load to Edit". @@ -167,7 +165,7 @@ to the toolbox. If you have blocks defined in JSON that aren't in your library, you can import them using the "Import Custom Blocks" button. Some blocks should be used together or include defaults. This is done with -[groups and shadows](/guides/configure/web/toolboxes/preset). Any +[groups and shadows](/guides/configure/toolboxes/preset). Any blocks that are connected in the editor will be added to the toolbox as a group. Blocks that are attached to another block can also be changed to shadow blocks by selecting the child block and clicking the "Make Shadow" button. @@ -179,7 +177,7 @@ blocks. If you include a variable or function block in their toolbox, include a "Variables" or "Functions" category in your toolbox to allow users to fully utilize the block. Learn more about ["Variables" or "Functions" -categories](/guides/configure/web/toolboxes/dynamic#built-in-dynamic-categories). +categories](/guides/configure/toolboxes/dynamic#built-in-dynamic-categories). ### Configuring a workspace @@ -189,10 +187,10 @@ tab and select "Workspace". #### Choose Workspace Options Set different values for [configuration -options](/guides/configure/web/configuration_struct#the-options-dictionary) +options](/guides/configure/configuration_struct#the-options-dictionary) and see the result in the preview area. Enabling -[grid](/guides/configure/web/grid) or -[zoom](/guides/configure/web/zoom) reveals more options to configure. +[grid](/guides/configure/grid) or +[zoom](/guides/configure/zoom) reveals more options to configure. Also, switching to using categories usually requires a more complex workspace; a trashcan and scrollbars are added automatically when you add your first category. diff --git a/packages/docs/docs/guides/create-custom-blocks/mutators.mdx b/packages/docs/docs/guides/create-custom-blocks/mutators.mdx index 9683692a2..7fbd8d3c0 100644 --- a/packages/docs/docs/guides/create-custom-blocks/mutators.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/mutators.mdx @@ -30,7 +30,7 @@ block with its dropdown set to `divisible by`. It has two value inputs.](/images/is-divisible-by.png) See the [serialization -page](/guides/configure/web/serialization#when-to-save-extra-state) for +page](/guides/configure/serialization#when-to-save-extra-state) for more information about when you need a mutator and when you don't. Mutators also provide a built-in UI for users to change the shapes of blocks if @@ -321,4 +321,4 @@ var helper = function () { ``` [shareable-procedures]: https://www.npmjs.com/package/@blockly/block-shareable-procedures -[serializer]: /guides/configure/web/serialization#serializer-hooks +[serializer]: /guides/configure/serialization#serializer-hooks diff --git a/packages/docs/docs/guides/create-custom-blocks/overview.mdx b/packages/docs/docs/guides/create-custom-blocks/overview.mdx index 4805f613c..137132f9e 100644 --- a/packages/docs/docs/guides/create-custom-blocks/overview.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/overview.mdx @@ -130,5 +130,5 @@ toolbox: For more information, see [Define a flyout -toolbox](/guides/configure/web/toolboxes/flyout) or [Define a category -toolbox](/guides/configure/web/toolboxes/category). +toolbox](/guides/configure/toolboxes/flyout) or [Define a category +toolbox](/guides/configure/toolboxes/category). diff --git a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx index f48be19b9..249ae41c5 100644 --- a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx @@ -240,8 +240,8 @@ completely external to Blockly, etc. Blockly’s built-in dynamic procedure category is specific to Blockly’s built-in procedure blocks. So to be able to access your blocks, you will need to define your own [custom dynamic -category](/guides/configure/web/toolboxes/dynamic), and [add it -to your toolbox](/guides/configure/web/toolboxes/dynamic). +category](/guides/configure/toolboxes/dynamic), and [add it +to your toolbox](/guides/configure/toolboxes/dynamic). ```js const proceduresFlyoutCallback = function (workspace) { diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx index 3769dd01a..8e4e7f137 100644 --- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx @@ -27,7 +27,7 @@ It also handles: - Applying other styling to the SVG elements. [PathObject]: /reference/blockly.blockrendering.pathobject -[theme]: /guides/configure/web/appearance/themes#block-style +[theme]: /guides/configure/appearance/themes#block-style [built-in-renderers]: /guides/create-custom-blocks/renderers/overview#built-in-renderers [drawer]: /guides/create-custom-blocks/renderers/concepts/drawer [geras-paths-image]: /images/rendering/renderers/geras-paths.png diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx index 035c7aaae..b78babdf5 100644 --- a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx @@ -100,5 +100,5 @@ const workspace = Blockly.inject(blocklyDiv, { [makeRenderInfo]: /reference/blockly.blockrendering.renderer.makerenderinfo_ [makePathObject]: /reference/blockly.blockrendering.renderer.makepathobject [makeDrawer]: /reference/blockly.blockrendering.renderer.makedrawer_ -[inject-config]: /guides/configure/web/configuration_struct +[inject-config]: /guides/configure/configuration_struct [custom-renderer-codelab]: /codelabs/custom-renderer/codelab-overview diff --git a/packages/docs/docs/guides/create-custom-blocks/variables.mdx b/packages/docs/docs/guides/create-custom-blocks/variables.mdx index 8b669cf7c..24b10ae00 100644 --- a/packages/docs/docs/guides/create-custom-blocks/variables.mdx +++ b/packages/docs/docs/guides/create-custom-blocks/variables.mdx @@ -205,7 +205,7 @@ while providing a `variableTypes` array will cause an error to be thrown. By default there is no visual indicator to tell the user which type is being used. One easy way to differentiate variable types is by -[colour](/guides/configure/web/appearance/block-colour). +[colour](/guides/configure/appearance/block-colour). :::note The `variableTypes` key is optional on a field_variable. If it is @@ -218,7 +218,7 @@ all variables of any type use `"variableTypes": null`. To make this new type of variable useful to your users, you need to add a way to create and use the new variables. -Create a new [dynamic category](/guides/configure/web/toolboxes/dynamic) +Create a new [dynamic category](/guides/configure/toolboxes/dynamic) for variables if you do not already have one. ![An open category named "Variables" containing a "Create variable" @@ -233,7 +233,7 @@ blocks, and getter blocks.](/images/variables-category-filled.png) ### Create Variable Button Next, your user needs a way to create variables. The simplest way is with a -"Create Variable" [button](/guides/configure/web/toolboxes/buttons). +"Create Variable" [button](/guides/configure/toolboxes/buttons). When creating the button, make the callback call diff --git a/packages/docs/docs/guides/design/app-overview.mdx b/packages/docs/docs/guides/design/app-overview.mdx index 174fc4572..c90021c2d 100644 --- a/packages/docs/docs/guides/design/app-overview.mdx +++ b/packages/docs/docs/guides/design/app-overview.mdx @@ -180,6 +180,6 @@ codelab](/codelabs/getting-started/codelab-overview). And if you're ready to write your application: -- [Build your editor](/guides/configure/web/configuration_struct) +- [Build your editor](/guides/configure/configuration_struct) - [Build your blocks](/guides/create-custom-blocks/overview) - [Build your application](/guides/app-integration/run-code) diff --git a/packages/docs/docs/guides/design/applications.mdx b/packages/docs/docs/guides/design/applications.mdx index 37c497407..9c2ad19cc 100644 --- a/packages/docs/docs/guides/design/applications.mdx +++ b/packages/docs/docs/guides/design/applications.mdx @@ -124,7 +124,7 @@ be added by either overriding the renderer constant `ADD_START_HATS` to `true` constants](/codelabs/custom-renderer/override-constants)). or by adding a theme and setting the hat option on the block style. For more information for setting hats on blocks as part of themes, see [Block -style](/guides/configure/web/appearance/themes/#block-style) in the themes +style](/guides/configure/appearance/themes/#block-style) in the themes documentation. ![The same "on mouse click" blocks with hats, which form a hump on top of the diff --git a/packages/docs/docs/guides/get-started/save-and-load.mdx b/packages/docs/docs/guides/get-started/save-and-load.mdx index 6d917ad3e..fc0c2257f 100644 --- a/packages/docs/docs/guides/get-started/save-and-load.mdx +++ b/packages/docs/docs/guides/get-started/save-and-load.mdx @@ -42,4 +42,4 @@ Blockly.serialization.workspaces.load(state, myWorkspace); This creates all of your saved blocks, variables, and other elements in the workspace. -[serialization]: /guides/configure/web/serialization +[serialization]: /guides/configure/serialization diff --git a/packages/docs/docs/guides/get-started/toolbox.mdx b/packages/docs/docs/guides/get-started/toolbox.mdx index 0b1873a96..7e3f77833 100644 --- a/packages/docs/docs/guides/get-started/toolbox.mdx +++ b/packages/docs/docs/guides/get-started/toolbox.mdx @@ -54,5 +54,5 @@ For more information about injection, see [Workspace creation][workspace-creation]. [visual-glossary-toolbox]: /guides/get-started/workspace-anatomy#toolbox -[toolbox-overview]: /guides/configure/web/toolboxes/toolbox +[toolbox-overview]: /guides/configure/toolboxes/toolbox [workspace-creation]: /guides/get-started/workspace-creation diff --git a/packages/docs/docs/guides/get-started/workspace-anatomy.mdx b/packages/docs/docs/guides/get-started/workspace-anatomy.mdx index c0e693e1c..16703e1cc 100644 --- a/packages/docs/docs/guides/get-started/workspace-anatomy.mdx +++ b/packages/docs/docs/guides/get-started/workspace-anatomy.mdx @@ -6,13 +6,13 @@ image: images/blockly_banner.png import Image from '@site/src/components/Image'; -[workspace]: /guides/configure/web/configuration_struct -[category-toolbox]: /guides/configure/web/toolboxes/category -[flyout-toolbox]: /guides/configure/web/toolboxes/flyout -[shadow-block]: /guides/configure/web/toolboxes/preset#shadow-blocks -[toolbox]: /guides/configure/web/toolboxes/toolbox -[zoom-controls]: /guides/configure/web/zoom -[context-menu]: /guides/configure/web/context-menus +[workspace]: /guides/configure/configuration_struct +[category-toolbox]: /guides/configure/toolboxes/category +[flyout-toolbox]: /guides/configure/toolboxes/flyout +[shadow-block]: /guides/configure/toolboxes/preset#shadow-blocks +[toolbox]: /guides/configure/toolboxes/toolbox +[zoom-controls]: /guides/configure/zoom +[context-menu]: /guides/configure/context-menus [block]: /guides/create-custom-blocks/overview [input]: /guides/create-custom-blocks/define/block-anatomy#inputs [connection]: /guides/create-custom-blocks/define/block-anatomy#connections diff --git a/packages/docs/docs/guides/get-started/workspace-creation.mdx b/packages/docs/docs/guides/get-started/workspace-creation.mdx index b33acb1e5..b19b6b21b 100644 --- a/packages/docs/docs/guides/get-started/workspace-creation.mdx +++ b/packages/docs/docs/guides/get-started/workspace-creation.mdx @@ -58,6 +58,6 @@ For more information about configuration options, see [Configuration options][config-options]. [visual-glossary]: /guides/get-started/workspace-anatomy -[config-options]: /guides/configure/web/configuration_struct#the-options-dictionary +[config-options]: /guides/configure/configuration_struct#the-options-dictionary [fixed-demo]: https://raspberrypifoundation.github.io/blockly-samples/examples/fixed-demo/index.html [resizable-demo]: https://raspberrypifoundation.github.io/blockly-samples/examples/resizable-demo/index.html diff --git a/packages/docs/docs/guides/programming/forking_blockly.mdx b/packages/docs/docs/guides/programming/forking_blockly.mdx index 6afb9eba4..ee19ee37a 100644 --- a/packages/docs/docs/guides/programming/forking_blockly.mdx +++ b/packages/docs/docs/guides/programming/forking_blockly.mdx @@ -16,7 +16,7 @@ plugins and custom classes instead of by forking. For more information, see [Plugins](/guides/programming/plugin_overview) and [Advanced -customization](/guides/configure/web/customization). +customization](/guides/configure/customization). ## Alternatives diff --git a/packages/docs/docs/guides/programming/plugin_overview.mdx b/packages/docs/docs/guides/programming/plugin_overview.mdx index 6885af3cf..92ee2758b 100644 --- a/packages/docs/docs/guides/programming/plugin_overview.mdx +++ b/packages/docs/docs/guides/programming/plugin_overview.mdx @@ -16,9 +16,9 @@ custom renderer. Plugins are generally packaged and distributed through npm. :::note The [`BlocklyOptions` -object](/guides/configure/web/configuration_struct#the-options-dictionary) +object](/guides/configure/configuration_struct#the-options-dictionary) has a `plugins` property for injecting classes that [customize Blockly -behavior](/guides/configure/web/customization). While these classes may +behavior](/guides/configure/customization). While these classes may be implemented as plugins, this is not required and they are otherwise unrelated. ::: diff --git a/packages/docs/docusaurus.config.js b/packages/docs/docusaurus.config.js index badc91451..f7b3b19d0 100644 --- a/packages/docs/docusaurus.config.js +++ b/packages/docs/docusaurus.config.js @@ -93,7 +93,7 @@ const config = { }, { label: 'Build your editor', - to: 'guides/configure/web/configuration_struct', + to: 'guides/configure/configuration_struct', }, { label: 'Build your blocks', diff --git a/packages/docs/sidebars.js b/packages/docs/sidebars.js index da347257a..455ddde8f 100644 --- a/packages/docs/sidebars.js +++ b/packages/docs/sidebars.js @@ -570,27 +570,27 @@ const sidebars = { { type: 'doc', label: 'Create a workspace', - id: 'guides/configure/web/configuration_struct', + id: 'guides/configure/configuration_struct', }, { type: 'doc', label: 'Grid option', - id: 'guides/configure/web/grid', + id: 'guides/configure/grid', }, { type: 'doc', label: 'Media folder option', - id: 'guides/configure/web/media', + id: 'guides/configure/media', }, { type: 'doc', label: 'Move option', - id: 'guides/configure/web/move', + id: 'guides/configure/move', }, { type: 'doc', label: 'Zoom option', - id: 'guides/configure/web/zoom', + id: 'guides/configure/zoom', }, ], }, @@ -601,17 +601,17 @@ const sidebars = { { type: 'doc', label: 'Fixed-size workspace', - id: 'guides/configure/web/fixed-size', + id: 'guides/configure/fixed-size', }, { type: 'doc', label: 'Resizable workspace', - id: 'guides/configure/web/resizable', + id: 'guides/configure/resizable', }, { type: 'doc', label: 'Metrics Manager', - id: 'guides/configure/web/metrics_manager', + id: 'guides/configure/metrics_manager', }, ], }, @@ -624,7 +624,7 @@ const sidebars = { { type: 'doc', label: 'Overview', - id: 'guides/configure/web/toolboxes/toolbox', + id: 'guides/configure/toolboxes/toolbox', }, { type: 'category', @@ -633,7 +633,7 @@ const sidebars = { { type: 'doc', label: 'Define a flyout toolbox', - id: 'guides/configure/web/toolboxes/flyout', + id: 'guides/configure/toolboxes/flyout', }, ], }, @@ -644,54 +644,54 @@ const sidebars = { { type: 'doc', label: 'Define a category toolbox', - id: 'guides/configure/web/toolboxes/category', + id: 'guides/configure/toolboxes/category', }, { type: 'doc', label: 'Nested categories', - id: 'guides/configure/web/toolboxes/nested', + id: 'guides/configure/toolboxes/nested', }, { type: 'doc', label: 'Dynamic categories', - id: 'guides/configure/web/toolboxes/dynamic', + id: 'guides/configure/toolboxes/dynamic', }, { type: 'doc', label: 'Disable, hide, or expand categories', - id: 'guides/configure/web/toolboxes/disable-categories', + id: 'guides/configure/toolboxes/disable-categories', }, { type: 'doc', label: 'Category appearance', - id: 'guides/configure/web/toolboxes/appearance', + id: 'guides/configure/toolboxes/appearance', }, { type: 'doc', label: 'Programmatic access', - id: 'guides/configure/web/toolboxes/programmatic', + id: 'guides/configure/toolboxes/programmatic', }, ], }, { type: 'doc', label: 'Preset blocks', - id: 'guides/configure/web/toolboxes/preset', + id: 'guides/configure/toolboxes/preset', }, { type: 'doc', label: 'Separators', - id: 'guides/configure/web/toolboxes/separators', + id: 'guides/configure/toolboxes/separators', }, { type: 'doc', label: 'Buttons and labels', - id: 'guides/configure/web/toolboxes/buttons', + id: 'guides/configure/toolboxes/buttons', }, { type: 'doc', label: 'Modify toolboxes', - id: 'guides/configure/web/toolboxes/modify', + id: 'guides/configure/toolboxes/modify', }, ], }, @@ -702,34 +702,34 @@ const sidebars = { { type: 'doc', label: 'Themes', - id: 'guides/configure/web/appearance/themes', + id: 'guides/configure/appearance/themes', }, { type: 'doc', label: 'Colour formats', - id: 'guides/configure/web/appearance/colour-formats', + id: 'guides/configure/appearance/colour-formats', }, { type: 'doc', label: 'Block colours', - id: 'guides/configure/web/appearance/block-colour', + id: 'guides/configure/appearance/block-colour', }, { type: 'doc', label: 'Style with CSS', - id: 'guides/configure/web/appearance/css', + id: 'guides/configure/appearance/css', }, ], }, { type: 'doc', label: 'Save and load', - id: 'guides/configure/web/serialization', + id: 'guides/configure/serialization', }, { type: 'doc', label: 'Events', - id: 'guides/configure/web/events', + id: 'guides/configure/events', }, { type: 'category', @@ -738,17 +738,17 @@ const sidebars = { { type: 'doc', label: 'Keyboard shortcuts', - id: 'guides/configure/web/keyboard-shortcuts', + id: 'guides/configure/keyboard-shortcuts', }, { type: 'doc', label: 'Copy and paste', - id: 'guides/configure/web/copy-paste', + id: 'guides/configure/copy-paste', }, { type: 'doc', label: 'Context menus', - id: 'guides/configure/web/context-menus', + id: 'guides/configure/context-menus', }, ], }, @@ -759,17 +759,17 @@ const sidebars = { { type: 'doc', label: 'Custom draggables', - id: 'guides/configure/web/dragging/draggable', + id: 'guides/configure/dragging/draggable', }, { type: 'doc', label: 'Custom block drag strategies', - id: 'guides/configure/web/dragging/block-drag-strategies', + id: 'guides/configure/dragging/block-drag-strategies', }, { type: 'doc', label: 'Custom draggers', - id: 'guides/configure/web/dragging/dragger', + id: 'guides/configure/dragging/dragger', }, ], }, @@ -780,29 +780,29 @@ const sidebars = { { type: 'doc', label: 'Workspace comments', - id: 'guides/configure/web/workspace_comment', + id: 'guides/configure/workspace_comment', }, { type: 'doc', label: 'Block comments', - id: 'guides/configure/web/block_comment', + id: 'guides/configure/block_comment', }, ], }, { type: 'doc', label: 'Localization', - id: 'guides/configure/web/translations', + id: 'guides/configure/translations', }, { type: 'doc', label: 'Focus system', - id: 'guides/configure/web/focus', + id: 'guides/configure/focus', }, { type: 'doc', label: 'Advanced customization', - id: 'guides/configure/web/customization', + id: 'guides/configure/customization', }, { type: 'category', @@ -811,12 +811,12 @@ const sidebars = { { type: 'doc', label: 'Keyboard navigation', - id: 'guides/configure/web/keyboard-nav', + id: 'guides/configure/keyboard-nav', }, { type: 'doc', label: 'Colour and accessibility', - id: 'guides/configure/web/colour-a11y', + id: 'guides/configure/colour-a11y', }, ], }, diff --git a/packages/docs/static/_redirects b/packages/docs/static/_redirects index 50fd0514c..4451afc17 100644 --- a/packages/docs/static/_redirects +++ b/packages/docs/static/_redirects @@ -13,3 +13,110 @@ # Strip .md/.mdx extensions on canonical /reference/* paths /reference/*.md /reference/:splat/ 302 /reference/*.mdx /reference/:splat/ 302 + +# Remove field docs for angle, colour, and multiline +/guides/create-custom-blocks/fields/built-in-fields/angle https://www.npmjs.com/package/@blockly/field-angle 301 +/guides/create-custom-blocks/fields/built-in-fields/colour https://www.npmjs.com/package/@blockly/field-colour 301 +/guides/create-custom-blocks/fields/built-in-fields/multiline-text-input https://www.npmjs.com/package/@blockly/field-multilineinput 301 + +# Add Getting started section +/guides/overview /guides/get-started/what-is-blockly/ 301 +/guides/get-started/web /guides/get-started/get-the-code/ 301 + +# Reorganize docs on code generation +/guides/configure/web/code-generators /guides/create-custom-blocks/code-generation/overview/ 301 +/guides/create-custom-blocks/caching-arguments /guides/create-custom-blocks/code-generation/caching-arguments/ 301 +/guides/create-custom-blocks/operator-precedence /guides/create-custom-blocks/code-generation/operator-precedence/ 301 +/guides/create-custom-blocks/generating-code /guides/create-custom-blocks/code-generation/overview/#block-code-generators 301 + +# Move connection checking information +/guides/create-custom-blocks/type-checks /guides/create-custom-blocks/inputs/connection-checks/ 301 + +# Reorganize "Modify Blockly" and "Plugins" sections (2022) +/guides/modify/contributing /guides/contribute/ 301 + +# Contributing Get Started section +/guides/modify/contribute/commits /guides/contribute/get-started/commits/ 301 +/guides/modify/development_setup /guides/contribute/get-started/development_tools/ 301 +/guides/modify/contribute/issue_labels /guides/contribute/get-started/issue_labels/ 301 +/guides/modify/contribute/pr_review_process /guides/contribute/get-started/pr_review_process/ 301 +/guides/modify/contribute/write_a_good_issue /guides/contribute/get-started/write_a_good_issue/ 301 +/guides/modify/contribute/write_a_good_pr /guides/contribute/get-started/write_a_good_pr/ 301 +/guides/modify/web/playground /guides/contribute/get-started/playground/ 301 + +# Contributing to Samples section +/guides/modify/contribute/add_a_plugin /guides/contribute/samples/add_a_plugin/ 301 +/guides/plugins/debugging /guides/contribute/samples/debugging/ 301 +/guides/plugins/naming /guides/contribute/samples/naming/ 301 +/guides/plugins/overview /guides/programming/plugin_overview/ 301 +/guides/modify/contribute/samples_repository_structure /guides/contribute/samples/repository_structure/ 301 +/guides/modify/contribute/write_a_codelab /guides/contribute/core/write_a_codelab/ 301 + +# Contributing to Core section +/guides/modify/web/style-guide /guides/contribute/core/style_guide/ 301 +/guides/modify/web/unit-testing /guides/contribute/core/unit_testing/ 301 +/guides/modify/web/* /guides/contribute/core/ 301 + +# Advanced Customization section (under Configure) +/guides/plugins/interfaces/overview /guides/configure/customization/ 301 +/guides/plugins/interfaces/connection_checker /guides/create-custom-blocks/inputs/connection_checker/ 301 +/guides/plugins/interfaces/metrics_manager /guides/configure/metrics_manager/ 301 +/guides/plugins/interfaces/* /guides/configure/customization/ 301 +/guides/modify/forking_blockly /guides/programming/forking_blockly/ 301 +/guides/plugins/using_blockly_apis /guides/programming/using_blockly_apis/ 301 + +# Default pages for directories +/guides/ /guides/get-started/what-is-blockly/ 301 +/reference/ /reference/blockly/ 301 +/reference/overview /reference/blockly/ 301 + +# Begin - Site refactoring - 2025 + +# Design considerations +/guides/create-custom-blocks/block-paradigms /guides/design/applications/ 301 +/guides/create-custom-blocks/style-guide /guides/design/blocks/ 301 +/guides/app-integration/best-practices /guides/design/education/ 301 + +# Move Advanced Customizations to Programming considerations/elsewhere +/guides/configure/advanced/using_blockly_apis /guides/programming/using_blockly_apis/ 301 +/guides/configure/advanced/forking_blockly /guides/programming/forking_blockly/ 301 +/guides/configure/advanced/unforking_blockly /guides/programming/unforking_blockly/ 301 +/guides/configure/advanced/interfaces/overview /guides/configure/customization/ 301 +/guides/configure/advanced/interfaces/connection_checker /guides/create-custom-blocks/inputs/connection_checker/ 301 +/guides/configure/advanced/interfaces/metrics_manager /guides/configure/metrics_manager/ 301 + +# Split up Toolbox +/guides/configure/web/toolbox /guides/configure/toolboxes/toolbox/ 301 + +# Colours +/guides/create-custom-blocks/block-colour /guides/configure/appearance/block-colour/ 301 + +# Localization +/guides/create-custom-blocks/localize-blocks /guides/configure/translations/ 301 + +# Custom blocks +/guides/configure/web/custom-blocks /guides/create-custom-blocks/overview/ 301 +/guides/create-custom-blocks/extensions /guides/create-custom-blocks/define/extensions/ 301 + +# Code generation +/guides/create-custom-blocks/code-generation/inner-blocks /guides/create-custom-blocks/code-generation/block-code/#get-code-from-inner-blocks 301 +/guides/create-custom-blocks/code-generation/statements/basic-implementation /guides/create-custom-blocks/code-generation/block-code/#inner-statement-blocks 301 +/guides/create-custom-blocks/code-generation/statements/caching-arguments /guides/create-custom-blocks/code-generation/caching-arguments/ 301 +/guides/create-custom-blocks/code-generation/values/basic-implementation /guides/create-custom-blocks/code-generation/block-code/#inner-value-blocks 301 +/guides/create-custom-blocks/code-generation/values/operator-precedence /guides/create-custom-blocks/code-generation/operator-precedence/ 301 +/guides/create-custom-blocks/code-generation/values/caching-arguments /guides/create-custom-blocks/code-generation/caching-arguments/ 301 + +# Icons +/guides/create-custom-blocks/define-blocks /guides/create-custom-blocks/define/block-definitions/ 301 + +# Shape +/guides/configure/web/appearance/overview /guides/create-custom-blocks/renderers/overview/ 301 +/guides/configure/web/appearance/renderers /guides/create-custom-blocks/renderers/overview/ 301 + +# Move configure docs from /web/ subdirectory +/guides/configure/web/* /guides/configure/:splat/ 301 + +# Plugins +/guides/contribute/samples/plugin_overview /guides/programming/plugin_overview/ 301 + +# End - Site refactoring - 2025 From 6d8dc2ce922df7ce7b19d7a70737593a4774ad93 Mon Sep 17 00:00:00 2001 From: Maribeth Moffatt Date: Tue, 26 May 2026 17:27:25 -0400 Subject: [PATCH 12/12] chore: closure-compiler is killing me --- package-lock.json | 68 ++++++++++++++++++++++++++++++----- packages/blockly/package.json | 2 +- 2 files changed, 60 insertions(+), 10 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9f0bf995f..587cca6e1 100644 --- a/package-lock.json +++ b/package-lock.json @@ -16033,12 +16033,14 @@ } }, "node_modules/google-closure-compiler": { - "version": "20260512.0.0", + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler/-/google-closure-compiler-20260520.0.0.tgz", + "integrity": "sha512-JcDh2ViwOr5j50S+8DgORE6Ftl62FL+3VavJ5z5hw+8I/2bZoYOZkB9zzz8iw7F53ks/0cG5ZhSH9vKIb8B/mg==", "dev": true, "license": "Apache-2.0", "dependencies": { "chalk": "^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0 <5.6.1 || ^5.6.2 >5.6.1", - "google-closure-compiler-java": "^20260512.0.0", + "google-closure-compiler-java": "^20260520.0.0", "minimist": "^1.0.0", "vinyl": "^3.0.1", "vinyl-sourcemaps-apply": "^0.2.0" @@ -16050,19 +16052,52 @@ "node": ">=18" }, "optionalDependencies": { - "google-closure-compiler-linux": "^20260512.0.0", - "google-closure-compiler-linux-arm64": "^20260512.0.0", - "google-closure-compiler-macos": "^20260512.0.0", - "google-closure-compiler-windows": "^20260512.0.0" + "google-closure-compiler-linux": "^20260520.0.0", + "google-closure-compiler-linux-arm64": "^20260520.0.0", + "google-closure-compiler-macos": "^20260520.0.0", + "google-closure-compiler-windows": "^20260520.0.0" } }, "node_modules/google-closure-compiler-java": { - "version": "20260512.0.0", + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler-java/-/google-closure-compiler-java-20260520.0.0.tgz", + "integrity": "sha512-XVeS/Lwgq401zHoq35S9a4t3OWN+zo1hYo2GNqgWZDOAtgO73Pd6uL+ihs02ePDFhmD2Aj9jtSJVkmDRrUm6Ig==", "dev": true, "license": "Apache-2.0" }, + "node_modules/google-closure-compiler-linux": { + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler-linux/-/google-closure-compiler-linux-20260520.0.0.tgz", + "integrity": "sha512-U3IJmf5XXQvUlWwmrR4vBT7USpbj/6DhUtv/prPpc0o4F20cfrlZddgQTvI8hzls8DOUxV5DCV1rBUmbTaHk5Q==", + "cpu": [ + "x32", + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/google-closure-compiler-linux-arm64": { + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler-linux-arm64/-/google-closure-compiler-linux-arm64-20260520.0.0.tgz", + "integrity": "sha512-TcqHJzAWNz9XNxUZ3ML1Pitqt5pmk2SclD1pp/zszOw49GMAOwGY86+xHKzNq2OHP3uwEVWfIvtC3L3AaXD6Cg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ] + }, "node_modules/google-closure-compiler-macos": { - "version": "20260512.0.0", + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler-macos/-/google-closure-compiler-macos-20260520.0.0.tgz", + "integrity": "sha512-mkRyGOPUZc+g6stNRHUe/YQblwxzz6OraO/QVGA7m8aimhd5T4i5GSeBUTcrK82LykuqbMaHh5P2op1Tm9NXYA==", "cpu": [ "arm64" ], @@ -16073,6 +16108,21 @@ "darwin" ] }, + "node_modules/google-closure-compiler-windows": { + "version": "20260520.0.0", + "resolved": "https://registry.npmjs.org/google-closure-compiler-windows/-/google-closure-compiler-windows-20260520.0.0.tgz", + "integrity": "sha512-T/9SrLQZeP2Q3i5R3WkSI20y2hYENWTB0XVKGr6C+Yc3r0rpbqei6R/baJvEk4W2SxahGt7veZ6JP2DJexRPjQ==", + "cpu": [ + "x32", + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "win32" + ] + }, "node_modules/gopd": { "version": "1.2.0", "license": "MIT", @@ -29020,7 +29070,7 @@ "eslint-plugin-prettier": "^5.5.5", "glob": "^13.0.6", "globals": "^17.6.0", - "google-closure-compiler": "^20260512.0.0", + "google-closure-compiler": "^20260520.0.0", "gulp": "^5.0.1", "gulp-concat": "^2.6.1", "gulp-gzip": "^1.4.2", diff --git a/packages/blockly/package.json b/packages/blockly/package.json index 611f95986..80390a52e 100644 --- a/packages/blockly/package.json +++ b/packages/blockly/package.json @@ -123,7 +123,7 @@ "eslint-plugin-prettier": "^5.5.5", "glob": "^13.0.6", "globals": "^17.6.0", - "google-closure-compiler": "^20260512.0.0", + "google-closure-compiler": "^20260520.0.0", "gulp": "^5.0.1", "gulp-concat": "^2.6.1", "gulp-gzip": "^1.4.2",