Блоки текста и подсветка синтаксиса

Материал из K3-Macro

Рекомендации по оформлению страниц в проекте.

Idea.png

Примеры кода можно выделять подсветкой синтаксиса для удобства чтения. Для этого следует использовать тег и заключить строки кода в конструкцию <syntaxhighlight lang="python" line> ...</syntaxhighlight> Более подробную информацию о подсветке синтаксиса См. wiki/Extension:SyntaxHighlight

Для создания блоков текста доступны шаблоны: Примечание, Идея, Внимание, Предупреждение, Помощь, onlyk3, macro, python

Чтобы сформировать, например, Примечание в режиме правки достаточно ввести двойные фигурные скобки и написать в выборе шаблона его имя - Примечание.

Information48.png

Шаблон Примечание


Здесь набрать ваш текст.


В режиме Правка кода ввести {{примечание| Здесь набрать ваш текст }}

Если блок создаёте в режиме Правка кода, то в конце важно не забыть поставить двойные фигурные скобки }}


Idea.png

Шаблон Идея

Warning.png

Внимание!

Шаблон внимание

Cancel 48.png

Шаблон предупреждение

Help 48.png

Шаблон Помощь

В шаблон onlyk3 предназначен для описаний применимых только в макроязыке k3 и отсутствующих в python

OnlyInK3 processed.png

Применимо только в программах на макроязыке к3. И не используется в модулях на python

Что бы отобразить текст макро или python рекомендуется использовать шаблоны macro и python.

Button macro fast processed.png

Пример на макроязыке к3:


<syntaxhighlight lang="c" line>
Здесь пишем код
...
...
</syntaxhighlight>
Пример отображения текста

 
...
else
{
	// putmsg("InitScratch")
	ScrMod=InitScratch();
	i=0;
	loop2:
	i=i+1;
	if i<=nun
	{
		err=AddScratch(ScrMod,str(UnMat[i]),"Choke",TypeCh[i]);
		err=AddScratch(ScrMod,str(UnMat[i]),"VBe",TypeE[i]);
		goto loop2;
	}
}

writescratch(ScrMod,AttrScrName,k3ObjUID);
termscratch(ScrMod);


Button2 py processed.png

Пример на языке python:


Что бы подсветить строку или диапазон строк следует добавить инструкцию вида highlight="1,5-7"
Сменить начальный номер start="123"
Подробнее читайте руководство См. wiki/Extension:SyntaxHighlight

<syntaxhighlight lang="python" line highlight="1,5-7" start="123">
Здесь пишем код
...
...
</syntaxhighlight>

Пример отображения текста



    for _bt in  basedtypes:
        _bmin = bmin
        for _ in range(20):
            id_ = int(k3.npgetbyprops(_bt,goodsprop,matprop,lbox))
            if id_ < 1:
                break
            result_length, isdlg = _validateLenGuides(_bxtype = _bt, idguides = id_, lbox = lbox, isdlg = isdlg)
            result_available,isdlg_a = _validate_available(_bxtype = _bt, idguides = id_, lbox = lbox, isdlg_a = isdlg_a)
            if all((result_length, result_available)):
                break
            _bmin += 50
            lbox -= _bmin
        if id_ > 0:
            break