From 559bf21da93919cb2d20cba744099d3a28838d25 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=A6=E5=BD=92=E4=BA=91=E5=B8=86?= <1138663075@qq.com> Date: Wed, 7 May 2025 21:18:53 +0800 Subject: [PATCH] =?UTF-8?q?docs(arduino=5Favr):=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E5=B8=AE=E5=8A=A9=E6=96=87=E6=A1=A3=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../default_src/arduino_avr/blocks/control.js | 24 +++++++++---------- .../default_src/arduino_avr/blocks/inout.js | 20 ++++++++-------- .../default_src/arduino_avr/blocks/lists.js | 9 +++---- boards/default_src/arduino_avr/blocks/math.js | 20 ++++++++-------- .../default_src/arduino_avr/blocks/scoop.js | 4 ++-- boards/default_src/arduino_avr/blocks/text.js | 10 ++++---- 6 files changed, 44 insertions(+), 43 deletions(-) diff --git a/boards/default_src/arduino_avr/blocks/control.js b/boards/default_src/arduino_avr/blocks/control.js index 5ba9208f..d8102747 100644 --- a/boards/default_src/arduino_avr/blocks/control.js +++ b/boards/default_src/arduino_avr/blocks/control.js @@ -9,7 +9,7 @@ export const base_setup = { this.appendStatementInput("DO").appendField(""); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_SETUP); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id2" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id2" ); } }; @@ -26,7 +26,7 @@ export const controls_delay = { this.setInputsInline(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_DELAY); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id9" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id9" ); }, UNIT: [ @@ -58,7 +58,7 @@ export const controls_for = { this.setNextStatement(true); this.setInputsInline(true); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id2" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#for" ); var thisBlock = this; this.setTooltip(function () { @@ -90,7 +90,7 @@ export const controls_whileUntil = { this.setPreviousStatement(true); this.setNextStatement(true); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#while" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#while" ); var thisBlock = this; this.setTooltip(function () { @@ -193,7 +193,7 @@ export const controls_if = { this.setPreviousStatement(true); this.setNextStatement(true); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#if" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#if" ); this.setMutator( new Blockly.icons.MutatorIcon( @@ -535,7 +535,7 @@ export const controls_switch_case = { this.setPreviousStatement(true); this.setNextStatement(true); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#switch" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#switch" ); this.setMutator( new Blockly.icons.MutatorIcon(["controls_case", "controls_default"], this) @@ -743,7 +743,7 @@ export const controls_mstimer2 = { this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_MSTIMER2); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#MsTimer2" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#mstimer2" ); } }; @@ -757,7 +757,7 @@ export const controls_mstimer2_start = { this.setPreviousStatement(true); this.setNextStatement(true); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id45" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id36" ); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_MSTIMER2_START); } @@ -773,7 +773,7 @@ export const controls_mstimer2_stop = { this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_MSTIMER2_STOP); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id48" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id38" ); } }; @@ -808,7 +808,7 @@ export const controls_interrupts = { this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_CONTROL_ALLOW_INTERRUPT); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id51" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id43" ); } }; @@ -822,7 +822,7 @@ export const controls_nointerrupts = { this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_CONTROL_NOINTERRUPTS); this.setHelpUrl( - "https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#id55" + "https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id46" ); } }; @@ -844,7 +844,7 @@ export const simple_timer = { .appendField(Blockly.Msg.CONTROLS_REPEAT_INPUT_DO); this.setColour(120); this.setTooltip(); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#id40"); }, NUMBER: [ ["1", "1"], diff --git a/boards/default_src/arduino_avr/blocks/inout.js b/boards/default_src/arduino_avr/blocks/inout.js index c215ad6f..e35006f7 100644 --- a/boards/default_src/arduino_avr/blocks/inout.js +++ b/boards/default_src/arduino_avr/blocks/inout.js @@ -49,7 +49,7 @@ export const inout_digital_write2 = { this.setNextStatement(true, null); this.setInputsInline(true); this.setTooltip(Blockly.Msg.LANG_INOUT_DIGITAL_WRITE_TOOLTIP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id2"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id2"); } }; @@ -61,7 +61,7 @@ export const inout_digital_read = { .appendField(new Blockly.FieldDropdown(Profile.default.digital), "PIN"); this.setOutput(true, [Boolean, Number]); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_DIGITAL_READ); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id7"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id6"); } }; @@ -74,7 +74,7 @@ export const inout_digital_read2 = { this.setInputsInline(true); this.setOutput(true, [Boolean, Number]); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_DIGITAL_READ); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id19"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id6"); } }; @@ -91,7 +91,7 @@ export const inout_analog_write = { this.setPreviousStatement(true, null); this.setNextStatement(true, null); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_ANALOG_WRITE); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id13"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id16"); } }; @@ -104,7 +104,7 @@ export const inout_analog_read = { this.setInputsInline(true); this.setOutput(true, Number); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_ANALOG_READ); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id13"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id11"); } }; @@ -166,7 +166,7 @@ export const controls_attachInterrupt = { this.setPreviousStatement(true); this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_ATTACHINTERRUPT); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id25"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id20"); } }; @@ -180,7 +180,7 @@ export const controls_detachInterrupt = { this.setNextStatement(true); this.setInputsInline(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_DETACHINTERRUPT); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id30"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id24"); } }; @@ -231,7 +231,7 @@ export const inout_pulseIn = { ]), "STAT"); this.setOutput(true, Number); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_pulseIn); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id33"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id27"); } }; @@ -253,7 +253,7 @@ export const inout_pulseIn2 = { this.setInputsInline(true); this.setOutput(true, Number); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_pulseIn2); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#id33"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#id27"); } }; @@ -281,7 +281,7 @@ export const inout_shiftout = { this.setPreviousStatement(true, null); this.setNextStatement(true, null); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_INOUT_shiftout); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/02.Input-Output.html#shiftout"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/01Input-Output.html#shiftout"); } }; diff --git a/boards/default_src/arduino_avr/blocks/lists.js b/boards/default_src/arduino_avr/blocks/lists.js index c97bca3a..5af7e5ac 100644 --- a/boards/default_src/arduino_avr/blocks/lists.js +++ b/boards/default_src/arduino_avr/blocks/lists.js @@ -448,6 +448,7 @@ export const lists_length = { .appendField(new Blockly.FieldTextInput('mylist'), 'VAR'); this.setTooltip(Blockly.Msg.LISTS_LENGTH_TOOLTIP); this.setOutput(true, Number); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/06Lists.html#mylist"); } }; @@ -472,7 +473,7 @@ export const create_array2_with_text = { .appendField(Blockly.Msg.MIXLY_ESP32_SET); this.setPreviousStatement(true, null); this.setNextStatement(true, null); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/06Lists.html#array"); } }; @@ -514,7 +515,7 @@ export const get_array2_value = { .appendField('(' + Blockly.Msg.MIXLY_DEPRECATED + ')'); this.setInputsInline(true); this.setOutput(true, null); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/06Lists.html#arraymn"); this.setWarningText(Blockly.Msg.MIXLY_DEPRECATED_WARNING_TEXT); } }; @@ -535,7 +536,7 @@ export const lists2SetValueByIndex = { this.setPreviousStatement(true, null); this.setNextStatement(true, null); this.setInputsInline(true); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/06Lists.html#mn"); this.setTooltip(Blockly.Msg.LANG_LISTS_SET_VALUE_BY_INDEX_TOOLTIP); } }; @@ -553,7 +554,7 @@ export const lists2GetValueByIndex = { .appendField(Blockly.Msg.DATAFRAME_COLUMN); this.setInputsInline(true); this.setOutput(true, null); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/06Lists.html#arraymn"); this.setTooltip(Blockly.Msg.LANG_LISTS_GET_VALUE_BY_INDEX_TOOLTIP); } }; diff --git a/boards/default_src/arduino_avr/blocks/math.js b/boards/default_src/arduino_avr/blocks/math.js index 69bb66d7..4bd89098 100644 --- a/boards/default_src/arduino_avr/blocks/math.js +++ b/boards/default_src/arduino_avr/blocks/math.js @@ -19,7 +19,7 @@ export const math_number = { Blockly.FieldTextInput.math_number_validator), 'NUM'); this.setOutput(true, Number); this.setTooltip(Blockly.Msg.MATH_NUMBER_TOOLTIP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#id2"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#id2"); } }; @@ -34,7 +34,7 @@ export const math_arithmetic = { this.setOutput(true, Number); this.appendValueInput('A') .setCheck(null); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#id4"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#id4"); this.appendValueInput('B') .setCheck(null) .appendField(new Blockly.FieldDropdown(math_arithmetic.OPERATORS), 'OP'); @@ -75,7 +75,7 @@ export const math_bit = { .appendField(new Blockly.FieldDropdown(math_bit.OPERATORS), 'OP'); this.setInputsInline(true); this.setTooltip(""); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#id8"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#id8"); }, OPERATORS: [ ['&', '&'], @@ -100,7 +100,7 @@ export const math_trig = { .appendField(new Blockly.FieldDropdown(math_trig.OPERATORS), 'OP'); // Assign 'this' to a variable for use in the tooltip closure below. var thisBlock = this; - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#id17"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#id21"); this.setTooltip(function () { var mode = thisBlock.getFieldValue('OP'); var TOOLTIPS = { @@ -139,7 +139,7 @@ export const math_to_int = { .setCheck(Number) .appendField(new Blockly.FieldDropdown(math_to_int.OPERATORS), 'OP'); this.setOutput(true, Number); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#id18"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#id35"); var thisBlock = this; this.setTooltip(function () { var mode = thisBlock.getFieldValue('OP'); @@ -226,7 +226,7 @@ export const math_max_min = { .setAlign(Blockly.inputs.Align.RIGHT) .appendField(')'); this.setInputsInline(true); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#min-max"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#min-max"); this.setOutput(true, Number); var thisBlock = this; this.setTooltip(function () { @@ -255,7 +255,7 @@ export const math_random_seed = { this.setPreviousStatement(true); this.setNextStatement(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_MATH_RANDOM_SEED); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#randomseed"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#randomseed"); } }; @@ -276,7 +276,7 @@ export const math_random_int = { .appendField(Blockly.Msg.LANG_MATH_RANDOM_INT_INPUT_TO); this.setInputsInline(true); this.setTooltip(Blockly.Msg.MATH_RANDOM_INT_TOOLTIP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#random"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#random"); } }; @@ -299,7 +299,7 @@ export const math_constrain = { .appendField(Blockly.Msg.LANG_MATH_CONSTRAIN_INPUT_HIGH); this.setInputsInline(true); this.setTooltip(Blockly.Msg.MATH_CONSTRAIN_TOOLTIP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#constrain"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#constrain"); } }; @@ -330,7 +330,7 @@ export const base_map = { this.setInputsInline(true); this.setOutput(true); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_MATH_MAP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/04.Mathematics.html#map"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/03Mathematics.html#map"); } }; diff --git a/boards/default_src/arduino_avr/blocks/scoop.js b/boards/default_src/arduino_avr/blocks/scoop.js index 55e48ed9..1446d1d3 100644 --- a/boards/default_src/arduino_avr/blocks/scoop.js +++ b/boards/default_src/arduino_avr/blocks/scoop.js @@ -15,7 +15,7 @@ export const SCoopTask = { .setCheck(null); this.setColour(SCOOP_HUE); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_SCOOP); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#scoop-task"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#scoop-task"); }, NUMBER: [ ["1", "1"], @@ -37,7 +37,7 @@ export const SCoop_yield = { this.setPreviousStatement(false, null); this.setNextStatement(false, null); this.setTooltip(Blockly.Msg.MIXLY_TOOLTIP_SCOOP_YIELD); - this.setHelpUrl("https://mixly.readthedocs.io/zh_CN/latest/arduino/03.Control.html#scoop-task"); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/02Control.html#scoop-task"); } }; diff --git a/boards/default_src/arduino_avr/blocks/text.js b/boards/default_src/arduino_avr/blocks/text.js index 23e8a484..1d9dfdeb 100644 --- a/boards/default_src/arduino_avr/blocks/text.js +++ b/boards/default_src/arduino_avr/blocks/text.js @@ -271,7 +271,7 @@ export const substring = { this.setOutput(true, null); this.setColour(TEXTS_HUE); this.setTooltip(Blockly.Msg.SUBSTRING_HELP); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/05Text.html#id13"); } }; @@ -291,7 +291,7 @@ export const letter_conversion = { this.setNextStatement(true, null); this.setColour(TEXTS_HUE); this.setTooltip(Blockly.Msg.LETTER_CONVERSION_HELP); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/05Text.html#id19"); } }; @@ -312,7 +312,7 @@ export const data_replacement = { this.setNextStatement(true, null); this.setColour(TEXTS_HUE); this.setTooltip(Blockly.Msg.DATA_REPLACEMENT_HELP); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/05Text.html#id23"); } }; @@ -328,7 +328,7 @@ export const eliminate = { this.setNextStatement(true, null); this.setColour(TEXTS_HUE); this.setTooltip(Blockly.Msg.ELIMINATE_HELP); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/05Text.html#id27"); } }; @@ -349,7 +349,7 @@ export const first_and_last = { this.setOutput(true, null); this.setColour(TEXTS_HUE); this.setTooltip(Blockly.Msg.FIRST_AND_LAST_HELP); - this.setHelpUrl(""); + this.setHelpUrl("https://mixly.readthedocs.io/zh-cn/latest/Arduino/AVR/05Text.html#id31"); } };