meerk40t 0.9.7910__py2.py3-none-any.whl → 0.9.7940__py2.py3-none-any.whl

meerk40t/gui/help_assets/help_assets.py

@@ -259,6 +259,356 @@ russian_wordlist_howto = """
 
 Для полного набора директив форматирования см.: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
 """
+spanish_wordlist_howto = """
+Las Listas de Palabras le permiten crear elementos de texto en su diseño que contienen texto de marcador de posición que se reemplaza en el momento de la grabación desde esta Lista de Palabras. Así puede grabar varios elementos con diferentes textos sin tener que cambiar su diseño cada vez.
+
+Un marcador de posición consiste en un nombre dentro de llaves, por ejemplo '{NOMBRE}'. Utilice el nombre en el Editor de Listas de Palabras para asociarlo con el marcador de posición y este será reemplazado por el texto que ingrese en el Contenido de la Lista de Palabras asociada.
+
+Por ejemplo, imagine que quiere crear un conjunto de etiquetas de reserva de asientos para una cena, cada una con el nombre de una persona diferente. Habiendo creado el contorno de la etiqueta, por ejemplo un rectángulo, use la herramienta de texto para crear un elemento de texto que contenga lo siguiente:
+'Este asiento está reservado para {NOMBRE}'
+
+Luego use el editor de Listas de Palabras para crear una o más entradas como sigue:
+    |-----------|------|-------|
+    |   Nombre  | Tipo | Índice|
+    |-----------|------|-------|
+    | nombre    | Texto|   0   |
+    |-----------|------|-------|
+Después haga clic en la fila 'nombre' y agregue varios elementos al panel de Contenidos, por ejemplo:
+    Pablo
+    David
+    Andy
+Ahora, cuando ejecute la grabación, obtendrá etiquetas individuales con diferentes nombres, por ejemplo 'Este asiento está reservado para Andy'.
+
+Puede usar tantos nombres de marcadores de posición como desee en los campos de texto de su diseño.
+
+El valor 'Índice' en la tabla de la Lista de Palabras indica qué entrada de la lista de contenidos se usará a continuación, cero significa la primera entrada. El índice se incrementa automáticamente en uno al final de cada grabación.
+
+Pero suponga que por eficiencia ahora quiere grabar dos etiquetas de reserva de asientos al mismo tiempo, cada una con un nombre diferente de la misma lista. En este caso, si la primera etiqueta usa '{NOMBRE#+0}' y la segunda '{NOMBRE#+1}' (note el signo más). '{NOMBRE}' o '{NOMBRE#+0}' usa la entrada actual (apuntada por el valor de Índice), '{NOMBRE#+1}' usa la siguiente entrada después de la actual, etc.
+
+Con el uso anterior, puede usar estos valores tantas veces como desee en su diseño. Para avanzar el índice debe hacer clic en los botones Anterior / Siguiente en la barra de herramientas.
+
+Como alternativa a ingresar manualmente los valores de la lista de palabras usando este editor, puede usar un archivo CSV estándar separado por comas. Los nombres de los marcadores de posición se definen en la línea de encabezado estándar del CSV (la primera línea del archivo CSV), y el contenido se toma de todas las líneas siguientes. La forma más fácil de crear un archivo CSV es usando una hoja de cálculo, por ejemplo Excel, aunque para sitios de comercio electrónico su sitio web podría crear automáticamente el archivo CSV a partir de los pedidos realizados en línea por los clientes.
+
+Las entradas cargadas desde un archivo CSV se muestran como Tipo CSV, y puede establecer los valores de Índice para todas las entradas CSV al mismo tiempo.
+
+Nota: Si su CSV no tiene una línea de encabezado, las columnas se llamarán 'column_1', 'column_2', etc.
+
+La lista de palabras también contiene algunas entradas especiales (que pueden ser especialmente útiles para diseños de calibración):
+    * 'version'   - Versión de Meerk40t
+    * 'date'      - Fecha de inicio de la grabación
+    * 'time'      - Hora de inicio de la grabación
+    * 'op_device' - Dispositivo en el que está grabando
+    * 'op_speed'  - Velocidad de la operación actual
+    * 'op_power'  - PPI de la operación actual
+    * 'op_dpi'    - DPI de la operación actual (raster)
+    * 'op_passes' - Pasadas de la operación actual
+
+Los marcadores de posición para 'date' y 'time' también pueden contener directivas de formato que le permiten formatearlos según sus convenciones locales, por ejemplo:
+    {date@%d.%m.%Y} - 31.12.2022
+    {time@%H:%M} - 23:59
+
+Para un conjunto completo de directivas de formato, consulte: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+chinese_wordlist_howto = """
+单词列表允许您在设计中创建包含占位符文本的文本元素，这些占位符文本将在烧录时由该单词列表中的内容替换。这样，您可以在不每次更改设计的情况下烧录多个带有不同文本的项目。
+
+占位符由大括号中的名称组成，例如“{FIRSTNAME}”。您可以在单词列表编辑器中使用该名称将其与占位符关联，占位符将被您在相关单词列表内容中输入的文本替换。
+
+例如，假设您想为晚宴创建一组座位预留标签，每个标签上都有不同的名字。创建好标签轮廓（例如一个矩形）后，使用文本绘图工具创建一个包含如下内容的文本元素：
+“此座位保留给{FIRSTNAME}”
+
+然后，您可以使用单词列表编辑器创建一个或多个如下条目：
+    |-----------|------|-------|
+    |   名称    | 类型 | 索引 |
+    |-----------|------|-------|
+    | firstname | 文本 |  0   |
+    |-----------|------|-------|
+然后点击“firstname”行，在内容面板中添加多个项目，例如：
+    保罗
+    大卫
+    安迪
+现在，当您执行烧录时，您将获得带有不同名字的单独座位标签，例如“此座位保留给安迪”。
+
+您可以在设计的文本字段中使用任意数量的不同占位符名称。
+
+单词列表表中的“索引”值指示下一个将使用内容列表中的哪个条目，零表示第一个条目。每次烧录结束时，索引会自动加一。
+
+但假设为了提高效率，您现在想同时烧录两个座位预留标签，每个标签都来自同一个列表但名字不同。在这种情况下，如果第一个标签使用“{NAME#+0}”，第二个使用“{NAME#+1}”（注意加号）。 “{NAME}”或“{NAME#+0}”使用当前条目（由索引值指向）， “{NAME#+1}”使用当前条目之后的下一个条目，依此类推。
+
+通过上述用法，您可以在设计中多次使用这些值。要推进索引，您需要点击工具栏上的上一个/下一个按钮。
+
+除了使用此单词列表编辑器手动输入单词列表值外，您还可以使用标准逗号分隔的CSV文件。占位符名称在标准CSV头行（CSV文件的第一行）中定义，内容则取自所有后续行。创建CSV文件的最简单方法是使用电子表格（如Excel），当然对于电商网站，您的网站也可以根据客户在线下单自动创建CSV文件。
+
+从CSV文件加载的条目显示为类型CSV，您可以同时为所有CSV条目设置索引值。
+
+注意：如果您的CSV没有头行，列将被命名为“column_1”、“column_2”等。
+
+单词列表还包含一些特殊条目（对于校准设计可能特别有用）：
+    * 'version'   - Meerk40t版本
+    * 'date'      - 烧录开始日期
+    * 'time'      - 烧录开始时间
+    * 'op_device' - 您正在烧录的设备
+    * 'op_speed'  - 当前操作的速度
+    * 'op_power'  - 当前操作的PPI
+    * 'op_dpi'    - 当前（光栅）操作的DPI
+    * 'op_passes' - 当前操作的遍数
+
+“date”和“time”的占位符还可以包含格式指令，允许您根据本地习惯对其进行格式化，例如：
+    {date@%Y.%m.%d} - 2022.12.31
+    {time@%H:%M} - 23:59
+
+完整的格式指令请参见：https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+hungarian_wordlist_howto = """
+A Szólisták lehetővé teszik, hogy a tervezésben olyan szövegelemeket hozzon létre, amelyek helyőrző szöveget tartalmaznak, és ezeket a szólistából származó tartalommal cseréli ki az égetés során. Így több elemet is égethet különböző szövegekkel anélkül, hogy minden alkalommal módosítania kellene a tervet.
+
+A helyőrző egy név, amely kapcsos zárójelek között van, például '{KERESZTNÉV}'. A Szólista szerkesztőben ezt a nevet használja a helyőrzőhöz való társításhoz, és a helyőrzőt az Ön által a kapcsolódó Szólista tartalmába beírt szöveg váltja fel.
+
+Például, ha vacsorához szeretne ülésfoglaló címkéket készíteni, mindegyiken más-más névvel, akkor hozzon létre egy névcímke körvonalat (például egy téglalapot), majd a Szöveg eszközzel hozzon létre egy szövegelemet, amely a következőt tartalmazza:
+'Ez a hely {KERESZTNÉV} számára van fenntartva'
+
+Ezután a Szólista szerkesztővel hozzon létre egy vagy több bejegyzést az alábbiak szerint:
+    |-----------|------|-------|
+    |   Név     | Típus| Index |
+    |-----------|------|-------|
+    | keresztnev| Szöveg|  0   |
+    |-----------|------|-------|
+Ezután kattintson a 'keresztnev' sorra, és adjon hozzá több elemet a Tartalom panelhez, például:
+    Pál
+    Dávid
+    András
+Most, amikor végrehajtja az égetést, egyedi helycímkéket kap, amelyek különböző neveket tartalmaznak, például 'Ez a hely András számára van fenntartva'.
+
+A tervezés szövegmezőiben annyi különböző helyőrző nevet használhat, amennyit csak szeretne.
+
+A Szólista táblázat 'Index' értéke azt jelzi, hogy a Tartalom listából melyik bejegyzést használja legközelebb, a nulla az első bejegyzést jelenti. Az index minden égetés végén automatikusan eggyel növekszik.
+
+Ha azonban hatékonyság szempontjából most két ülésfoglaló címkét szeretne egyszerre égetni, mindegyik más-más névvel ugyanabból a listából, akkor az első címke '{NÉV#+0}', a második pedig '{NÉV#+1}' (figyelje a plusz jelet). A '{NÉV}' vagy '{NÉV#+0}' a jelenlegi bejegyzést használja (amelyre az Index érték mutat), a '{NÉV#+1}' a jelenlegi utáni következő bejegyzést stb.
+
+A fenti használattal ezeket az értékeket annyiszor használhatja a tervezésben, ahányszor csak szeretné. Az index előrehaladásához kattintson az Előző/Következő gombokra az eszköztáron.
+
+A szólista értékeit nemcsak manuálisan viheti be a Szólista szerkesztővel, hanem használhat szabványos, vesszővel elválasztott CSV-fájlt is. A helyőrző neveket a szabványos CSV-fejléc sorban (a CSV-fájl első sora) határozza meg, a tartalmat pedig az összes következő sorból veszi. A CSV-fájl létrehozásának legegyszerűbb módja egy táblázatkezelő, például az Excel használata, de például webáruházak esetén a weboldal automatikusan létrehozhatja a CSV-fájlt az online leadott rendelésekből.
+
+A CSV-fájlból betöltött bejegyzések típusa CSV-ként jelenik meg, és az összes CSV-bejegyzés indexértékét egyszerre beállíthatja.
+
+Megjegyzés: Ha a CSV-fájlban nincs fejlécsor, az oszlopokat 'column_1', 'column_2' stb. néven nevezi el.
+
+A szólista néhány speciális bejegyzést is tartalmaz (amelyek különösen hasznosak lehetnek kalibrációs tervekhez):
+    * 'version'   - Meerk40t verzió
+    * 'date'      - Az égetés kezdési dátuma
+    * 'time'      - Az égetés kezdési ideje
+    * 'op_device' - Az eszköz, amelyen éget
+    * 'op_speed'  - Az aktuális művelet sebessége
+    * 'op_power'  - Az aktuális művelet PPI-je
+    * 'op_dpi'    - Az aktuális (raszteres) művelet DPI-je
+    * 'op_passes' - Az aktuális művelet átfutásai
+
+A 'date' és 'time' helyőrzők formázási utasításokat is tartalmazhatnak, amelyek lehetővé teszik, hogy azokat a helyi szokásoknak megfelelően formázza, például:
+    {date@%Y.%m.%d} - 2022.12.31
+    {time@%H:%M} - 23:59
+
+A formátumutasítások teljes készletéhez lásd: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+portuguese_wordlist_howto = """
+As Listas de Palavras permitem criar elementos de texto no seu design que contêm texto de espaço reservado, substituído no momento da gravação pelo conteúdo desta Lista de Palavras. Assim, pode gravar vários itens com textos diferentes sem ter de alterar o design de cada vez.
+
+Um espaço reservado consiste num nome entre chavetas, por exemplo '{NOME}'. Utilize o nome no Editor de Listas de Palavras para o associar ao espaço reservado e este será substituído pelo texto que inserir no Conteúdo da Lista de Palavras associada.
+
+Por exemplo, imagine que quer criar um conjunto de etiquetas de reserva de lugares para um jantar, cada uma com o nome de uma pessoa diferente. Depois de criar o contorno da etiqueta, por exemplo um retângulo, utilize a ferramenta de texto para criar um elemento de texto com o seguinte conteúdo:
+'Este lugar está reservado para {NOME}'
+
+Depois, utilize o editor de Listas de Palavras para criar uma ou mais entradas como segue:
+    |-----------|------|-------|
+    |   Nome    | Tipo | Índice|
+    |-----------|------|-------|
+    | nome      | Texto|   0   |
+    |-----------|------|-------|
+Depois clique na linha 'nome' e adicione vários itens ao painel de Conteúdo, por exemplo:
+    Paulo
+    David
+    Andy
+Agora, ao executar a gravação, obterá etiquetas individuais com nomes diferentes, por exemplo 'Este lugar está reservado para Andy'.
+
+Pode usar tantos nomes de espaços reservados quantos quiser nos campos de texto do seu design.
+
+O valor 'Índice' na tabela da Lista de Palavras indica qual entrada da lista de conteúdos será usada a seguir, sendo zero a primeira entrada. O índice é automaticamente incrementado em um no final de cada gravação.
+
+Mas suponha que, por eficiência, agora quer gravar duas etiquetas de reserva de lugares ao mesmo tempo, cada uma com um nome diferente da mesma lista. Neste caso, se a primeira etiqueta usar '{NOME#+0}' e a segunda '{NOME#+1}' (note o sinal de mais). '{NOME}' ou '{NOME#+0}' usa a entrada atual (apontada pelo valor do Índice), '{NOME#+1}' usa a próxima entrada após a atual, etc.
+
+Com o uso acima, pode usar estes valores quantas vezes quiser no seu design. Para avançar o índice, deve clicar nos botões Anterior / Seguinte na barra de ferramentas.
+
+Como alternativa à introdução manual dos valores da lista de palavras usando este editor, pode usar um ficheiro CSV padrão separado por vírgulas. Os nomes dos espaços reservados são definidos na linha de cabeçalho padrão do CSV (a primeira linha do ficheiro CSV), e o conteúdo é retirado de todas as linhas seguintes. A forma mais fácil de criar um ficheiro CSV é usando uma folha de cálculo, por exemplo o Excel, mas para sites de comércio eletrónico o seu site pode criar automaticamente o ficheiro CSV a partir das encomendas feitas online pelos clientes.
+
+As entradas carregadas de um ficheiro CSV são apresentadas como Tipo CSV, e pode definir os valores de Índice para todas as entradas CSV ao mesmo tempo.
+
+Nota: Se o seu CSV não tiver uma linha de cabeçalho, as colunas serão nomeadas 'column_1', 'column_2', etc.
+
+A lista de palavras também contém algumas entradas especiais (que podem ser especialmente úteis para designs de calibração):
+    * 'version'   - Versão do Meerk40t
+    * 'date'      - Data de início da gravação
+    * 'time'      - Hora de início da gravação
+    * 'op_device' - Dispositivo em que está a gravar
+    * 'op_speed'  - Velocidade da operação atual
+    * 'op_power'  - PPI da operação atual
+    * 'op_dpi'    - DPI da operação atual (raster)
+    * 'op_passes' - Passagens da operação atual
+
+Os espaços reservados para 'date' e 'time' também podem conter diretivas de formatação que permitem formatá-los de acordo com as suas convenções locais, por exemplo:
+    {date@%d.%m.%Y} - 31.12.2022
+    {time@%H:%M} - 23:59
+
+Para um conjunto completo de diretivas de formato, consulte: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+portuguese_brazilian_wordlist_howto = """
+As Listas de Palavras permitem criar elementos de texto no seu design que contêm texto de espaço reservado, substituído no momento da gravação pelo conteúdo desta Lista de Palavras. Assim, pode gravar vários itens com textos diferentes sem ter de alterar o design de cada vez.
+
+Um espaço reservado consiste num nome entre chaves, por exemplo '{NOME}'. Utilize o nome no Editor de Listas de Palavras para o associar ao espaço reservado e este será substituído pelo texto que inserir no Conteúdo da Lista de Palavras associada.
+
+Por exemplo, imagine que quer criar um conjunto de etiquetas de reserva de lugares para um jantar, cada uma com o nome de uma pessoa diferente. Depois de criar o contorno da etiqueta, por exemplo um retângulo, utilize a ferramenta de texto para criar um elemento de texto com o seguinte conteúdo:
+'Este lugar está reservado para {NOME}'
+
+Depois, utilize o editor de Listas de Palavras para criar uma ou mais entradas como segue:
+    |-----------|------|-------|
+    |   Nome    | Tipo | Índice|
+    |-----------|------|-------|
+    | nome      | Texto|   0   |
+    |-----------|------|-------|
+Depois clique na linha 'nome' e adicione vários itens ao painel de Conteúdo, por exemplo:
+    Paulo
+    David
+    Andy
+Agora, ao executar a gravação, obterá etiquetas individuais com nomes diferentes, por exemplo 'Este lugar está reservado para Andy'.
+
+Pode usar tantos nomes de espaços reservados quantos quiser nos campos de texto do seu design.
+
+O valor 'Índice' na tabela da Lista de Palavras indica qual entrada da lista de conteúdos será usada a seguir, sendo zero a primeira entrada. O índice é automaticamente incrementado em um no final de cada gravação.
+
+Mas suponha que, por eficiência, agora quer gravar duas etiquetas de reserva de lugares ao mesmo tempo, cada uma com um nome diferente da mesma lista. Neste caso, se a primeira etiqueta usar '{NOME#+0}' e a segunda '{NOME#+1}' (note o sinal de mais). '{NOME}' ou '{NOME#+0}' usa a entrada atual (apontada pelo valor do Índice), '{NOME#+1}' usa a próxima entrada após a atual, etc.
+
+Com o uso acima, pode usar estes valores quantas vezes quiser no seu design. Para avançar o índice, deve clicar nos botões Anterior / Seguinte na barra de ferramentas.
+
+Como alternativa à introdução manual dos valores da lista de palavras usando este editor, pode usar um ficheiro CSV padrão separado por vírgulas. Os nomes dos espaços reservados são definidos na linha de cabeçalho padrão do CSV (a primeira linha do ficheiro CSV), e o conteúdo é retirado de todas as linhas seguintes. A forma mais fácil de criar um ficheiro CSV é usando uma folha de cálculo, por exemplo o Excel, mas para sites de comércio eletrónico o seu site pode criar automaticamente o ficheiro CSV a partir das encomendas feitas online pelos clientes.
+
+As entradas carregadas de um ficheiro CSV são apresentadas como Tipo CSV, e pode definir os valores de Índice para todas as entradas CSV ao mesmo tempo.
+
+Nota: Se o seu CSV não tiver uma linha de cabeçalho, as colunas serão nomeadas 'column_1', 'column_2', etc.
+
+A lista de palavras também contém algumas entradas especiais (que podem ser especialmente úteis para designs de calibração):
+    * 'version'   - Versão do Meerk40t
+    * 'date'      - Data de início da gravação
+    * 'time'      - Hora de início da gravação
+    * 'op_device' - Dispositivo em que está a gravar
+    * 'op_speed'  - Velocidade da operação atual
+    * 'op_power'  - PPI da operação atual
+    * 'op_dpi'    - DPI da operação atual (raster)
+    * 'op_passes' - Passagens da operação atual
+
+Os espaços reservados para 'date' e 'time' também podem conter diretivas de formatação que permitem formatá-los de acordo com as suas convenções locais, por exemplo:
+    {date@%d.%m.%Y} - 31.12.2022
+    {time@%H:%M} - 23:59
+
+Para um conjunto completo de diretivas de formato, consulte: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
+japanese_wordlist_howto = """
+ワードリストを使用すると、デザイン内のテキスト要素にプレースホルダーテキストを含めることができ、焼成時にこのワードリストから内容に置き換えられます。これにより、毎回デザインを変更することなく、異なるテキストを持つ複数のアイテムを焼成できます。
+
+プレースホルダーは中括弧内の名前で構成されます。例: '{FIRSTNAME}'。ワードリストエディタでこの名前を使用してプレースホルダーと関連付けると、関連付けられたワードリストの内容に入力したテキストでプレースホルダーが置き換えられます。
+
+この機能の使用例として、ディナーパーティーの席予約タグを作成したいとします。各タグには異なる人の名前が入っています。名札の輪郭（例：長方形）を作成した後、テキスト描画ツールを使用して次の内容を含むテキスト要素を作成します：
+「この席は{FIRSTNAME}のために予約されています」
+
+次に、このワードリストエディタを使用して、次のようなエントリを1つ以上作成します：
+    |-----------|------|-------|
+    |   名前    | 種類 | インデックス |
+    |-----------|------|-------|
+    | firstname | テキスト | 0   |
+    |-----------|------|-------|
+次に「firstname」行をクリックし、内容ペインにいくつかの項目を追加します。例：
+    ポール
+    デイビッド
+    アンディ
+これで焼成を実行すると、「この席はアンディのために予約されています」のように、異なる名前が入った個別の席札が得られます。
+
+デザインのテキストフィールドには、好きなだけ多くの異なるプレースホルダー名を使用できます。
+
+ワードリストテーブルの「インデックス」値は、次に使用される内容リストのエントリを示します。ゼロは最初のエントリを意味します。インデックスは各焼成の最後に自動的に1つ増加します。
+
+効率のために、同じリストから異なる名前を持つ2つの席予約タグを同時に焼成したい場合、最初のタグは「{NAME#+0}」、2番目は「{NAME#+1}」（プラス記号に注意）を使用します。「{NAME}」または「{NAME#+0}」は現在のエントリ（インデックス値が指すもの）を使用し、「{NAME#+1}」は現在の次のエントリを使用します。
+
+上記の使い方で、これらの値はデザイン内で何度でも使用できます。インデックスを進めるには、ツールバーの前/次ボタンをクリックします。
+
+このワードリストエディタを使用して手動で値を入力する代わりに、標準のカンマ区切りCSVファイルを使用することもできます。プレースホルダー名は標準のCSVヘッダー行（CSVファイルの最初の行）で定義され、内容はすべての後続行から取得されます。CSVファイルを作成する最も簡単な方法は、Excelなどのスプレッドシートを使用することです。ECサイトの場合、ウェブサイトが顧客の注文から自動的にCSVファイルを作成することもできます。
+
+CSVファイルから読み込まれたエントリはタイプCSVとして表示され、すべてのCSVエントリのインデックス値を同時に設定できます。
+
+注意：CSVにヘッダー行がない場合、列は「column_1」、「column_2」などと名付けられます。
+
+ワードリストには、いくつかの特別なエントリも含まれています（キャリブレーションデザインに特に便利です）：
+    * 'version'   - Meerk40tバージョン
+    * 'date'      - 焼成開始日
+    * 'time'      - 焼成開始時刻
+    * 'op_device' - 使用しているデバイス
+    * 'op_speed'  - 現在の操作の速度
+    * 'op_power'  - 現在の操作のPPI
+    * 'op_dpi'    - 現在（ラスター）操作のDPI
+    * 'op_passes' - 現在の操作のパス数
+
+「date」と「time」のプレースホルダーには、ローカルの規則に従ってフォーマットできる書式指定子を含めることもできます。例：
+    {date@%Y.%m.%d} - 2022.12.31
+    {time@%H:%M} - 23:59
+
+書式指定子の完全なセットについては、https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior を参照してください。
+"""
+dutch_wordlist_howto = """
+Met Woordenlijsten kunt u textelementen in uw ontwerp maken die tijdelijke tekst bevatten die bij het branden wordt vervangen door deze Woordenlijst. U kunt dan meerdere items met verschillende tekst branden zonder uw ontwerp telkens te hoeven wijzigen.
+
+Een tijdelijke aanduiding bestaat uit een naam tussen accolades, bijvoorbeeld '{VOORNAAM}'. U gebruikt de naam in de Woordenlijst-editor om deze te koppelen aan de tijdelijke aanduiding en de tijdelijke aanduiding wordt vervangen door de tekst die u invoert in de bijbehorende Woordenlijst-inhoud.
+
+Als voorbeeld van hoe deze functionaliteit wordt gebruikt, stel dat u een set zitplaatsreserveringslabels voor een diner wilt maken, elk met een andere naam. Nadat u het snijpad voor de naamlabelomtrek hebt gemaakt, bijvoorbeeld een rechthoek, gebruikt u het tekstgereedschap om een textelement te maken met de volgende inhoud:
+'Deze stoel is gereserveerd voor {VOORNAAM}'
+
+Gebruik vervolgens deze Woordenlijst-editor om een of meer items als volgt te maken:
+    |-----------|------|-------|
+    |   Naam    | Type | Index |
+    |-----------|------|-------|
+    | voornaam  | Tekst|   0   |
+    |-----------|------|-------|
+Klik vervolgens op de rij 'voornaam' en voeg meerdere items toe aan het inhoudspaneel, bijvoorbeeld:
+    Paul
+    David
+    Andy
+Wanneer u nu het branden uitvoert, krijgt u individuele plaatslabels met verschillende namen, bijvoorbeeld 'Deze stoel is gereserveerd voor Andy'.
+
+U kunt zoveel verschillende tijdelijke aanduidingsnamen gebruiken als u wilt in tekstvelden in uw ontwerp.
+
+De 'Index'-waarde in de Woordenlijsttabel geeft aan welk item in de inhoudslijst de volgende keer wordt gebruikt, waarbij nul het eerste item betekent. De index wordt automatisch met één verhoogd aan het einde van elke brand.
+
+Stel dat u nu om efficiëntie twee zitplaatsreserveringslabels tegelijk wilt branden, elk met een andere naam uit dezelfde lijst. In dit geval, als het eerste label '{NAAM#+0}' gebruikt en het tweede '{NAAM#+1}' (let op het plusteken). '{NAAM}' of '{NAAM#+0}' gebruikt het huidige item (aangegeven door de Index-waarde), '{NAAM#+1}' gebruikt het volgende item na het huidige, enzovoort.
+
+Met het bovenstaande gebruik kunt u deze waarden zo vaak gebruiken als u wilt in uw ontwerp. Om de index te verhogen, moet u op de Vorige / Volgende knoppen in de werkbalk klikken.
+
+Als alternatief voor het handmatig invoeren van de waarden van de woordenlijst met deze editor, kunt u een standaard door komma's gescheiden CSV-bestand gebruiken. De tijdelijke aanduidingsnamen worden gedefinieerd in de standaard CSV-kopregel (de eerste regel in het CSV-bestand), en de inhoud wordt vervolgens uit alle volgende regels gehaald. De eenvoudigste manier om een CSV-bestand te maken is met een spreadsheet, bijvoorbeeld Excel, maar voor webwinkels kan uw website het CSV-bestand automatisch aanmaken op basis van online geplaatste bestellingen van klanten.
+
+Items die uit een CSV-bestand zijn geladen, worden weergegeven als Type CSV, en u kunt de Index-waarden voor alle CSV-items tegelijk instellen.
+
+Opmerking: als uw CSV geen kopregel heeft, worden de kolommen 'column_1', 'column_2', enz. genoemd.
+
+De woordenlijst bevat ook enkele speciale items (die vooral handig kunnen zijn voor kalibratieontwerpen):
+    * 'version'   - Meerk40t-versie
+    * 'date'      - Datum waarop het branden is gestart
+    * 'time'      - Tijd waarop het branden is gestart
+    * 'op_device' - Apparaat waarop u brandt
+    * 'op_speed'  - Snelheid van de huidige bewerking
+    * 'op_power'  - PPI van de huidige bewerking
+    * 'op_dpi'    - DPI van de huidige (raster) bewerking
+    * 'op_passes' - Aantal passes van de huidige bewerking
+
+De tijdelijke aanduidingen voor 'date' en 'time' kunnen ook opmaakopdrachten bevatten waarmee u ze kunt opmaken volgens uw lokale conventies, bijvoorbeeld:
+    {date@%d.%m.%Y} - 31.12.2022
+    {time@%H:%M} - 23:59
+
+Voor een volledige set opmaakopdrachten, zie: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
+"""
 
 english_material_howto = """
 The Material Library Manager allows to create, maintain, use and manage operations that are customized to provide a desired effect with a given material (hence the name Material Library).
@@ -285,58 +635,67 @@ russian_material_howto = """
 Параметры, которые вы хотите использовать, например, для резки акрила, очень отличаются от тех, которые вы хотите использовать для гравировки изображения на сланце.
 Вы можете поделиться такими настройками материала с сообществом MeerK40t и можете извлечь пользу из вкладов других, загружая и используя их настройки.
 """
+spanish_material_howto = """
+El Gestor de la Biblioteca de Materiales permite crear, mantener, usar y gestionar operaciones que están personalizadas para proporcionar un efecto deseado con un material dado (de ahí el nombre Biblioteca de Materiales).
+Los parámetros que desea utilizar, por ejemplo, para cortar acrílico son muy diferentes de los que desea utilizar para grabar una imagen en pizarra.
+Puede compartir dicha configuración de material con la comunidad de MeerK40t y beneficiarse de las contribuciones de otros cargando y utilizando sus configuraciones.
+"""
+chinese_material_howto = """
+材料库管理器允许您创建、维护、使用和管理针对特定材料定制的操作（因此称为材料库）。
+例如，用于切割亚克力的参数与用于在石板上雕刻图像的参数非常不同。
+您可以与MeerK40t社区分享此类材料设置，也可以通过加载和使用他人的设置来受益于他人的贡献。
+"""
+hungarian_material_howto = """
+Az Anyagkönyvtár kezelő lehetővé teszi, hogy létrehozzon, karbantartson, használjon és kezeljen olyan műveleteket, amelyek egy adott anyaghoz igazított hatást biztosítanak (innen az Anyagkönyvtár elnevezés).
+Az akril vágásához használt paraméterek például nagyon eltérnek azoktól, amelyeket pala gravírozásához használna.
+Az ilyen anyagbeállításokat megoszthatja a MeerK40t közösséggel, és mások hozzájárulásaiból is profitálhat, ha betölti és használja az ő beállításaikat.
+"""
+portuguese_material_howto = """
+O Gerenciador de Biblioteca de Materiais permite criar, manter, usar e gerenciar operações que são personalizadas para fornecer um efeito desejado com um determinado material (daí o nome Biblioteca de Materiais).
+Os parâmetros que você deseja usar, por exemplo, para cortar acrílico, são muito diferentes dos que você deseja usar para gravar uma imagem em ardósia.
+Você pode compartilhar essa configuração de material com a comunidade MeerK40t e pode se beneficiar das contribuições de outros carregando e usando suas configurações.
+"""
+portuguese_brazilian_material_howto = """
+O Gerenciador de Biblioteca de Materiais permite criar, manter, usar e gerenciar operações que são personalizadas para fornecer um efeito desejado com um determinado material (daí o nome Biblioteca de Materiais).
+Os parâmetros que você deseja usar, por exemplo, para cortar acrílico, são muito diferentes dos que você deseja usar para gravar uma imagem em ardósia.
+Você pode compartilhar essa configuração de material com a comunidade MeerK40t e pode se beneficiar das contribuições de outros carregando e usando suas configurações.
+"""
+japanese_material_howto = """
+マテリアルライブラリマネージャーは、特定の材料で望ましい効果を得るためにカスタマイズされた操作を作成、維持、使用、管理することができます（そのため「マテリアルライブラリ」と呼ばれます）。
+例えば、アクリルをカットするために使用するパラメータは、スレートに画像を彫刻するために使用するパラメータとは大きく異なります。
+このようなマテリアル設定をMeerK40tコミュニティと共有したり、他の人の設定を読み込んで利用することで、その貢献から恩恵を受けることができます。
+"""
+dutch_material_howto = """
+De Materialenbibliotheekbeheerder stelt u in staat om bewerkingen te maken, te onderhouden, te gebruiken en te beheren die zijn aangepast om een gewenst effect te bereiken met een bepaald materiaal (vandaar de naam Materialenbibliotheek).
+De parameters die u bijvoorbeeld wilt gebruiken voor het snijden van acryl zijn heel anders dan die voor het graveren van een afbeelding op leisteen.
+U kunt dergelijke materiaalsinstellingen delen met de MeerK40t-gemeenschap en profiteren van de bijdragen van anderen door hun instellingen te laden en te gebruiken.
+"""
 
 
 def asset(context, asset):
-    language = context.language
-    lang = "english"
-    # Language #00 : en - English
-    if language == 0:  # ("en", "English", wx.LANGUAGE_ENGLISH)
-        lang = "english"
-    # Language #01 : it - italiano
-    if language == 1:  # ("it", "italiano", wx.LANGUAGE_ITALIAN),
-        lang = "italian"
-    # Language #02 : fr - français
-    if language == 2:  # ("fr", "français", wx.LANGUAGE_FRENCH),
-        lang = "french"
-    # Language #03 : de - Deutsch
-    if language == 3:  # ("de", "Deutsch", wx.LANGUAGE_GERMAN),
-        lang = "german"
-    # Language #04 : es - español
-    if language == 4:  # ("es", "español", wx.LANGUAGE_SPANISH),
-        lang = "spanish"
-    # Language #05 : zh - 中文
-    if language == 5:  # ("zh", "中文", wx.LANGUAGE_CHINESE),
-        lang = "chinese"
-    # Language #06 : hu - Magyar
-    if language == 6:  # ("hu", "Magyar", wx.LANGUAGE_HUNGARIAN),
-        lang = "hungarian"
-    # Language #07 : pt_PT - português
-    if language == 7:  # ("pt_PT", "português", wx.LANGUAGE_PORTUGUESE),
-        lang = "portuguese"
-    # Language #08 : pt_BR - português brasileiro
-    if (
-        language == 8
-    ):  # ("pt_BR", "português brasileiro", wx.LANGUAGE_PORTUGUESE_BRAZILIAN),
-        lang = "portuguese_brazilian"
-    # Language #09 : ja - 日本
-    if language == 9:  # ("ja", "日本", wx.LANGUAGE_JAPANESE),
-        lang = "japanese"
-    # Language #10 : nl - Nederlands
-    if language == 10:  # ("nl", "Nederlands", wx.LANGUAGE_DUTCH),
-        lang = "dutch"
-    # Language #11 : ru - русский
-    if language == 11:  # ("ru", "русский", wx.LANGUAGE_RUSSIAN),
-        lang = "russian"
-
+    language_map = {
+        0: "english",
+        1: "italian",
+        2: "french",
+        3: "german",
+        4: "spanish",
+        5: "chinese",
+        6: "hungarian",
+        7: "portuguese",
+        8: "portuguese_brazilian",
+        9: "japanese",
+        10: "dutch",
+        11: "russian",
+    }
+    lang = language_map.get(getattr(context, "language", 0), "english")
     text = ""
     try:
         text = globals()[f"{lang}_{asset}"]
     except KeyError:
         try:
-            text = globals()["english_" + asset]
+            text = globals()[f"english_{asset}"]
         except KeyError:
             pass
-    if text and text[0] == "\n":
+    if text and text.startswith("\n"):
         return text[1:]
     return text

meerk40t/gui/plugin.py

@@ -111,6 +111,18 @@ and a wxpython version <= 4.1.1."""
                 "page": "Gui",
                 "section": "General",
             },
+            {
+                "attr": "remember_main_pos",
+                "object": kernel.root,
+                "default": True,
+                "type": bool,
+                "label": _("Remember main window position"),
+                "tip": _(
+                    "Should MeerK40t remember its last position on the screen?"
+                ),
+                "page": "Gui",
+                "section": "General",
+            },
             {
                 "attr": "windows_save",
                 "object": kernel.root,

meerk40t/gui/tips.py

@@ -466,11 +466,30 @@ class TipPanel(wx.Panel):
         if successful:
             # Store the result to the local cache file
             if len(content):
-                try:
-                    with open(self.local_file, mode="w") as f:
-                        f.write(content)
-                except (OSError, RuntimeError, PermissionError, FileNotFoundError):
-                    pass
+                successful = False
+                # Try to write the content to the local file.
+                for codepage in ["utf-8", "cp1252"]:
+                    try:
+                        with open(self.local_file, mode="w", encoding=codepage) as f:
+                            f.write(content)
+                        successful = True
+                        break
+                    except (
+                        UnicodeDecodeError,
+                        OSError,
+                        RuntimeError,
+                        PermissionError,
+                        FileNotFoundError,
+                    ):
+                        pass
+                if not successful:
+                    # If we still failed, try with surrogateescape
+                    # This is a workaround for some unicode issues.
+                    try:
+                        with open(self.local_file, mode="w") as f:
+                            f.write(content)
+                    except (OSError, RuntimeError, PermissionError, FileNotFoundError):
+                        pass
 
     def load_tips_from_local_cache(self):
         def comparable_version(version):
@@ -506,42 +525,60 @@ class TipPanel(wx.Panel):
         myversion = comparable_version(self.context.kernel.version)
 
         try:
-            with open(self.local_file, mode="r") as f:
-                ver = ""
-                tip = ""
-                cmd = ""
-                img = ""
-                lastline_was_tip = False
-                for line in f:
-                    cline = line.strip()
-                    if cline.startswith("#") or len(cline) == 0:
-                        continue
-                    if cline.startswith("tip="):
-                        lastline_was_tip = True
-                        # Store previous
-                        add_tip(tip, cmd, img, ver, myversion)
-                        ver = ""
-                        tip = cline[len("tip=") :]
-                        cmd = ""
-                        img = ""
-                    elif cline.startswith("version="):
-                        lastline_was_tip = False
-                        ver = cline[len("version=") :]
-                    elif cline.startswith("cmd="):
-                        lastline_was_tip = False
-                        cmd = cline[len("cmd=") :]
-                    elif cline.startswith("image="):
-                        lastline_was_tip = False
-                        img = cline[len("image=") :]
-                    elif cline.startswith("img="):
-                        lastline_was_tip = False
-                        img = cline[len("img=") :]
-                    else:
-                        if lastline_was_tip:
-                            tip += "\n" + cline
-
-                # Something pending?
-                add_tip(tip, cmd, img, ver, myversion)
+            content = ""
+            codepages = ["utf-8", "cp1252"]
+            for codepage in codepages:
+                try:
+                    with open(self.local_file, mode="r", encoding=codepage) as f:
+                        content = f.read()
+                    break
+                except UnicodeDecodeError:
+                    content = ""
+            if not content:
+                with open(
+                    self.local_file,
+                    mode="r",
+                    encoding="utf-8",
+                    errors="surrogateescape",
+                ) as f:
+                    content = f.read()
+
+            lines = content.splitlines()
+            ver = ""
+            tip = ""
+            cmd = ""
+            img = ""
+            lastline_was_tip = False
+            for line in lines:
+                cline = line.strip()
+                if cline.startswith("#") or len(cline) == 0:
+                    continue
+                if cline.startswith("tip="):
+                    lastline_was_tip = True
+                    # Store previous
+                    add_tip(tip, cmd, img, ver, myversion)
+                    ver = ""
+                    tip = cline[len("tip=") :]
+                    cmd = ""
+                    img = ""
+                elif cline.startswith("version="):
+                    lastline_was_tip = False
+                    ver = cline[len("version=") :]
+                elif cline.startswith("cmd="):
+                    lastline_was_tip = False
+                    cmd = cline[len("cmd=") :]
+                elif cline.startswith("image="):
+                    lastline_was_tip = False
+                    img = cline[len("image=") :]
+                elif cline.startswith("img="):
+                    lastline_was_tip = False
+                    img = cline[len("img=") :]
+                else:
+                    if lastline_was_tip:
+                        tip += "\n" + cline
+
+            # Something pending?
+            add_tip(tip, cmd, img, ver, myversion)
 
         except (OSError, RuntimeError, PermissionError, FileNotFoundError):
             return