# Редактирование файлов справки синтаксис-помощника 1С Шаги редактирования 1. Поместите файл `shcntx_ru.hbk` в папку с кодом 2. Запустите `p1_*.py` и `p2_*.py` для извлечения html из hbk-файла 3. Используйте `e5_*.py` для форматирования html в более читаемый вид 4. Для вставки примера кода можно использовать `e4_*.py` (код записан в константу) 5. Уменьшите html файл обратно после редактирования `e6_*.py` 6. Запакуйте всё обратно с помощью `p3_*.py` и `p4_*.py` и замените оригинальный файл [Код был сгенерирован с помощью ИИ](https://github.com/me-shaon/GLWTPL/blob/master/translations/NSFW_LICENSE_ru-RU)

#!/usr/bin/env python3 """ e1_analyze.py — Анализирует извлечённые потоки: сжатие, тип данных """ import os import re import zlib STREAMS_DIR = "hbk_streams" for fname in sorted(os.listdir(STREAMS_DIR)): if fname.startswith("_") or fname.endswith(".meta"): continue path = os.path.join(STREAMS_DIR, fname) with open(path, "rb") as f: raw = f.read() print(f"\n{'=' * 60}") print(f" {fname} ({len(raw):,} байт)") print(f" head: {raw[:32].hex(' ')}") # Пробуем zlib try: dec = zlib.decompress(raw) print(f" → zlib OK: {len(dec):,} байт распаковано") print(f" head: {dec[:64]}") out = os.path.join(STREAMS_DIR, fname + ".deflated") with open(out, "wb") as f: f.write(dec) except zlib.error: print(f" → не zlib") # Ищем строки strings = re.findall(rb"[\x20-\x7e]{8,}", raw[:4096]) if strings: print(f" ASCII строки (первые 5):") for s in strings[:5]: print(f" {s.decode('ascii')}") utf = re.findall(rb"(?:[\x20-\x7e]\x00){4,}", raw[:4096]) if utf: print(f" UTF-16LE строки:") for s in utf[:5]: print(f" {s.decode('utf-16-le')}")

#!/usr/bin/env python3 """ e2_explore.py — Обзор содержимого FileStorage """ import os CONTENT_DIR = os.path.join("hbk_content", "FileStorage") html_files = [] other_files = [] for root, dirs, files in os.walk(CONTENT_DIR): for fname in files: fpath = os.path.join(root, fname) relpath = os.path.relpath(fpath, CONTENT_DIR) size = os.path.getsize(fpath) if fname.endswith(".html"): html_files.append((relpath, size)) else: other_files.append((relpath, size)) print(f"HTML-файлов: {len(html_files)}") print(f"Других файлов: {len(other_files)}") print(f"\nПримеры HTML:") for path, size in sorted(html_files)[:20]: print(f" {path} ({size:,} Б)") if other_files: print(f"\nДругие файлы:") for path, size in sorted(other_files)[:20]: print(f" {path} ({size:,} Б)") # Показать содержимое первого HTML if html_files: first = os.path.join(CONTENT_DIR, html_files[0][0]) print(f"\n{'=' * 60}") print(f"Содержимое: {html_files[0][0]}") print("=" * 60) with open(first, "r", encoding="utf-8", errors="replace") as f: print(f.read()[:2000])

#!/usr/bin/env python3 """ e3_find_example.py — Найти файлы с примерами кода, чтобы узнать разметку """ import os CONTENT_DIR = os.path.join("hbk_content", "FileStorage") keywords = [ b"V8SH_example", b"V8SH_code", b'class="code"', b"<pre", b"Example", "Пример".encode("utf-8"), ] for root, dirs, files in os.walk(CONTENT_DIR): for fname in files: if not fname.endswith(".html"): continue fpath = os.path.join(root, fname) with open(fpath, "rb") as f: data = f.read() for kw in keywords: if kw in data: rel = os.path.relpath(fpath, CONTENT_DIR) # Показать контекст вокруг ключевого слова idx = data.find(kw) snippet = data[max(0, idx - 100) : idx + 300] print(f"\n{'=' * 60}") print(f"Файл: {rel}") print(f"Ключ: {kw}") print(snippet.decode("utf-8", errors="replace")) break # один пример с файла достаточно

#!/usr/bin/env python3 """ e4_code_format.py — Генератор HTML-таблицы с подсветкой кода 1С в стиле встроенной справки 1С:Предприятие Результат копируется в буфер обмена и сохраняется в файл. """ # ═══════════════════════════════════════════════════════════════ # ВВЕДИТЕ КОД 1С ЗДЕСЬ: # ═══════════════════════════════════════════════════════════════ CODE_1C = """\ // Пример чтения JSON &НаСервере Процедура ЗагрузкаНаСервере(Путь) Чтение = Новый ЧтениеJSON; Чтение.ОткрытьФайл(Путь); Данные = ПрочитатьJSON(Чтение); Чтение.Закрыть(); Количество = 0; Для Каждого Товар Из Данные Цикл Ссылка = Справочники.ЗагрузкаТоваров.НайтиПоКоду(Товар.id); Элемент = ?(Ссылка.Пустая(), Справочники.ЗагрузкаТоваров.СоздатьЭлемент(), Ссылка.ПолучитьОбъект()); Элемент.Код = Товар.article; Элемент.Наименование = Товар.name; Элемент.Цена = Товар.price; Элемент.Цвет = Товар.color; Элемент.Записать(); Количество = Количество + 1; КонецЦикла; Сообщить("Загружено " + Количество); КонецПроцедуры &НаКлиенте Асинх Процедура Загрузка(Команда) Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие); Диалог.Фильтр = "ДжейсонСтетхэм (*.json) | *.json"; Если Ждать Диалог.ВыбратьАсинх() Тогда ЗагрузкаНаСервере(Диалог.ПолноеИмяФайла); КонецЕсли; КонецПроцедуры """ # ═══════════════════════════════════════════════════════════════ # Словари ключевых слов # ═══════════════════════════════════════════════════════════════ KEYWORDS = { # Русские "Если", "Тогда", "ИначеЕсли", "Иначе", "КонецЕсли", "Для", "Каждого", "Из", "По", "Цикл", "КонецЦикла", "Пока", "Процедура", "КонецПроцедуры", "Функция", "КонецФункции", "Перем", "Возврат", "Продолжить", "Прервать", "И", "Или", "Не", "Попытка", "Исключение", "КонецПопытки", "ВызватьИсключение", "Новый", "Выполнить", "Знач", "Экспорт", "Истина", "Ложь", "Неопределено", "NULL", # Английские "If", "Then", "ElsIf", "Else", "EndIf", "For", "Each", "In", "To", "Do", "EndDo", "While", "Procedure", "EndProcedure", "Function", "EndFunction", "Var", "Return", "Continue", "Break", "And", "Or", "Not", "Try", "Except", "EndTry", "Raise", "New", "Execute", "Val", "Export", "True", "False", "Undefined", } CONTEXT_DIRECTIVES = { "&НаКлиенте", "&НаСервере", "&НаКлиентеНаСервере", "&НаСервереБезКонтекста", "&AtClient", "&AtServer", "&AtClientAtServer", "&AtServerNoContext", } COLORS = { "keyword": "#ff0000", "string": "#000000", "comment": "#008000", "operator": "#ff0000", "identifier": "#0000ff", "number": "#000000", "directive": "#ff0000", "context": "#884422", } OPERATORS = set("=+-*/<>().,;[]%?") # ═══════════════════════════════════════════════════════════════ # Лексер # ═══════════════════════════════════════════════════════════════ def tokenize(code): tokens = [] i = 0 n = len(code) while i < n: ch = code[i] # Перенос строки if ch == "\r": tokens.append(("newline", "\n")) i += 2 if i + 1 < n and code[i + 1] == "\n" else 1 continue if ch == "\n": tokens.append(("newline", "\n")) i += 1 continue # Пробелы if ch in " \t": j = i while j < n and code[j] in " \t": j += 1 tokens.append(("space", code[i:j])) i = j continue # Комментарий // if ch == "/" and i + 1 < n and code[i + 1] == "/": j = i while j < n and code[j] != "\n": j += 1 tokens.append(("comment", code[i:j])) i = j continue # Строка "..." if ch == '"': j = i + 1 while j < n: if code[j] == '"': if j + 1 < n and code[j + 1] == '"': j += 2 else: j += 1 break else: j += 1 tokens.append(("string", code[i:j])) i = j continue # Число if ch.isdigit(): j = i while j < n and (code[j].isdigit() or code[j] == "."): j += 1 tokens.append(("number", code[i:j])) i = j continue # Операторы if ch in OPERATORS: if ch == "<" and i + 1 < n and code[i + 1] == ">": tokens.append(("operator", "<>")) i += 2 continue if ch in "<>" and i + 1 < n and code[i + 1] == "=": tokens.append(("operator", code[i : i + 2])) i += 2 continue tokens.append(("operator", ch)) i += 1 continue # Контекстная директива &НаКлиенте if ch == "&": j = i while j < n and ( code[j].isalnum() or code[j] in {"_", "&"} or ord(code[j]) > 127 ): j += 1 word = code[i:j] if word in CONTEXT_DIRECTIVES: tokens.append(("context", word)) else: tokens.append(("identifier", word)) i = j continue # Директива # if ch == "#": j = i while j < n and code[j] not in "\r\n": j += 1 tokens.append(("directive", code[i:j])) i = j continue # Идентификатор / ключевое слово if ch.isalpha() or ch == "_" or ord(ch) > 127: j = i while j < n and (code[j].isalnum() or code[j] == "_" or ord(code[j]) > 127): j += 1 word = code[i:j] tokens.append(("keyword" if word in KEYWORDS else "identifier", word)) i = j continue tokens.append(("other", ch)) i += 1 return tokens # ═══════════════════════════════════════════════════════════════ # Генератор HTML # ═══════════════════════════════════════════════════════════════ def escape(text): return text.replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;") def nbsp(text): return text.replace(" ", "&nbsp;") def token_html(typ, text): if typ == "newline": return "<br>" if typ == "space": return nbsp(escape(text)) e = nbsp(escape(text)) color = COLORS.get(typ) return f'<font color="{color}">{e}</font>' if color else e def generate(code): tokens = tokenize(code) inner = "".join(token_html(t, v) for t, v in tokens) return ( f'<p class="V8SH_chapter">Пример:</p>' f'<table width="100%" bgcolor="#f7f7f7">' f"<tbody><tr><td>" f'<font face="Courier New"> {inner}</font><br>' f"</td></tr></tbody></table>" ) # ═══════════════════════════════════════════════════════════════ # Запуск # ═══════════════════════════════════════════════════════════════ if __name__ == "__main__": code = CODE_1C.strip() result = generate(code) # Сохраняем результат with open("result_code.html", "w", encoding="utf-8") as f: f.write(result) # Сохраняем предпросмотр preview = ( '<!DOCTYPE html><html><head><meta charset="utf-8">' "<title>Предпросмотр</title></head><body>" f"<h3>Предпросмотр:</h3>{result}" f'<h3>HTML:</h3><textarea style="width:100%;height:300px">' f"{escape(result)}</textarea></body></html>" ) with open("preview_code.html", "w", encoding="utf-8") as f: f.write(preview) # Копируем в буфер обмена try: import subprocess subprocess.run("clip", input=result.encode("utf-8"), check=True, shell=True) print("HTML скопирован в буфер обмена!") except Exception: pass print(f"Сохранено: result_code.html") print(f"Предпросмотр: preview_code.html") print(f"\nHTML ({len(result)} символов):") print(result[:200] + "...")

#!/usr/bin/env python3 """ e5_format_html.py — Форматирователь HTML: разбивает на строки по тегам, БЕЗ добавления отступов. Просто каждый тег на новой строке. Использование: python e5_format_html.py input.html → выводит в stdout python e5_format_html.py input.html output.html → сохраняет в файл python e5_format_html.py --dir ./folder → все .html в папке (на месте) """ import os import re import sys # Теги, после открывающего/закрывающего которых ставим перенос BLOCK_TAGS = { "html", "head", "body", "div", "p", "h1", "h2", "h3", "h4", "h5", "h6", "ul", "ol", "li", "table", "tbody", "thead", "tfoot", "tr", "td", "th", "form", "fieldset", "section", "article", "nav", "aside", "header", "footer", "main", "details", "summary", "blockquote", "pre", "script", "style", "link", "meta", "title", } # Теги, содержимое которых не трогаем PRESERVE_TAGS = {"pre", "textarea", "script", "style"} def format_html(html): # Защищаем содержимое pre/textarea/script/style preserved = [] def save_block(m): preserved.append(m.group(0)) return f"\x00BLOCK{len(preserved) - 1}\x00" html = re.sub( r"(<(?:pre|textarea|script|style)\b[^>]*>)(.*?)(</(?:pre|textarea|script|style)>)", save_block, html, flags=re.DOTALL | re.IGNORECASE, ) # Убираем существующие переносы и лишние пробелы html = re.sub(r"[\r\n\t]+", " ", html) html = re.sub(r" {2,}", " ", html) # Перенос ПЕРЕД открывающими блочными тегами tags_pattern = "|".join(BLOCK_TAGS) html = re.sub( rf"(?<=>)\s*(<(?:{tags_pattern})\b)", r"\n\1", html, flags=re.IGNORECASE ) # Перенос ПОСЛЕ закрывающих блочных тегов html = re.sub(rf"(</(?:{tags_pattern})>)\s*", r"\1\n", html, flags=re.IGNORECASE) # Перенос ПОСЛЕ самозакрывающихся тегов (meta, link, br, hr, img) html = re.sub(r"(<(?:meta|link)\b[^>]*>)\s*", r"\1\n", html, flags=re.IGNORECASE) # Перенос ПОСЛЕ <br> и <hr> (но br внутри кода не трогаем — они в preserved) html = re.sub(r"(<[Hh][Rr]\s*/?>)\s*", r"\1\n", html) # Убираем пустые строки (больше 2 переносов подряд) html = re.sub(r"\n{3,}", "\n\n", html) # Убираем пробелы в начале строк (но НЕ добавляем отступы) lines = html.split("\n") lines = [line.strip() for line in lines] html = "\n".join(lines) # Убираем пустые строки в начале и конце html = html.strip() # Восстанавливаем защищённые блоки for i, block in enumerate(preserved): html = html.replace(f"\x00BLOCK{i}\x00", block) return html if __name__ == "__main__": if len(sys.argv) < 2: print("Использование:") print(" python html_format.py input.html [output.html]") print(" python html_format.py --dir ./folder") sys.exit(1) if sys.argv[1] == "--dir": folder = sys.argv[2] if len(sys.argv) > 2 else "." count = 0 for root, _, files in os.walk(folder): for fname in files: if not fname.lower().endswith(".html"): continue fpath = os.path.join(root, fname) with open(fpath, "r", encoding="utf-8-sig") as f: original = f.read() result = format_html(original) with open(fpath, "w", encoding="utf-8-sig") as f: f.write(result) count += 1 print(f" {os.path.relpath(fpath, folder)}") print(f"\nОтформатировано: {count} файлов") else: input_file = sys.argv[1] with open(input_file, "r", encoding="utf-8-sig") as f: html = f.read() result = format_html(html) if len(sys.argv) > 2: with open(sys.argv[2], "w", encoding="utf-8-sig") as f: f.write(result) print(f"Сохранено: {sys.argv[2]}") else: print(result)

#!/usr/bin/env python3 """ e6_minify_html.py — Минимизатор HTML: убирает отступы, переносы, лишние пробелы. Превращает HTML в одну строку. Использование: python e6_minify_html.py input.html → выводит в stdout python e6_minify_html.py input.html output.html → сохраняет в файл python e6_minify_html.py --dir ./folder → все .html в папке (на месте) """ import os import re import sys def minify_html(html): # Защищаем содержимое <pre>, <textarea>, <script>, <style> preserved = [] def save_block(m): preserved.append(m.group(0)) return f"\x00BLOCK{len(preserved) - 1}\x00" html = re.sub( r"(<(?:pre|textarea|script|style)\b[^>]*>)(.*?)(</(?:pre|textarea|script|style)>)", save_block, html, flags=re.DOTALL | re.IGNORECASE, ) # Убираем HTML-комментарии html = re.sub(r"<!--.*?-->", "", html, flags=re.DOTALL) # Убираем переносы строк и табы → один пробел html = re.sub(r"[\r\n\t]+", " ", html) # Множественные пробелы → один html = re.sub(r" {2,}", " ", html) # Пробелы вокруг тегов html = re.sub(r">\s+<", "><", html) html = re.sub(r">\s+", ">", html) html = re.sub(r"\s+<", "<", html) # Восстанавливаем защищённые блоки for i, block in enumerate(preserved): html = html.replace(f"\x00BLOCK{i}\x00", block) return html.strip() if __name__ == "__main__": if len(sys.argv) < 2: print("Использование:") print(" python html_minify.py input.html [output.html]") print(" python html_minify.py --dir ./folder") sys.exit(1) if sys.argv[1] == "--dir": folder = sys.argv[2] if len(sys.argv) > 2 else "." count = 0 for root, _, files in os.walk(folder): for fname in files: if not fname.lower().endswith(".html"): continue fpath = os.path.join(root, fname) with open(fpath, "r", encoding="utf-8-sig") as f: original = f.read() result = minify_html(original) if len(result) < len(original): with open(fpath, "w", encoding="utf-8-sig") as f: f.write(result) saved = len(original) - len(result) count += 1 print(f" {os.path.relpath(fpath, folder)} -{saved} байт") print(f"\nМинимизировано: {count} файлов") else: input_file = sys.argv[1] with open(input_file, "r", encoding="utf-8-sig") as f: html = f.read() result = minify_html(html) if len(sys.argv) > 2: with open(sys.argv[2], "w", encoding="utf-8-sig") as f: f.write(result) print(f"{len(html)} → {len(result)} байт") else: print(result)

#!/usr/bin/env python3 """ p1_unpack.py — Извлечение потоков из контейнера 1С v8 (.hbk) """ import json import os import struct import sys BLOCK_HDR = 31 # размер блочного адреса NO_NEXT = 0x7FFFFFFF # нет следующей страницы # ─── Чтение блочного адреса ────────────────────────────────────────── def parse_block_hdr(data, offset): """ Разбирает блочный адрес: \\r\\nDOCSIZE PAGESIZE NEXTPAGE \\r\\n Возвращает (doc_size, page_size, next_page) или None. """ if offset < 0 or offset + BLOCK_HDR > len(data): return None if ( data[offset : offset + 2] != b"\r\n" or data[offset + 29 : offset + 31] != b"\r\n" ): return None try: txt = data[offset + 2 : offset + 29].decode("ascii").strip().split() if len(txt) != 3: return None return int(txt[0], 16), int(txt[1], 16), int(txt[2], 16) except Exception: return None def read_block(data, offset): """ Читает ПОЛНОЕ содержимое блока (может быть цепочка страниц). Возвращает bytes. """ first = parse_block_hdr(data, offset) if first is None: return None doc_size = first[0] # реальный размер данных buf = bytearray() cur = offset visited = set() while cur != NO_NEXT and cur not in visited: visited.add(cur) hdr = parse_block_hdr(data, cur) if hdr is None: break _, page_size, next_page = hdr start = cur + BLOCK_HDR buf.extend(data[start : start + page_size]) cur = next_page return bytes(buf[:doc_size]) # ─── Разбор метаданных потока ──────────────────────────────────────── def parse_meta(raw): """ Метаданные потока: creation FILETIME (8 байт) modified FILETIME (8 байт) attrs uint32 (4 байта) name UTF-16LE с нулевым терминатором """ if not raw or len(raw) < 20: return None, raw name = raw[20:].decode("utf-16-le").rstrip("\x00") return name, raw # ─── Основная функция ──────────────────────────────────────────────── def extract(filepath, out_dir="hbk_streams"): with open(filepath, "rb") as f: data = f.read() magic, page_sz, version, _ = struct.unpack_from("<IIII", data, 0) print(f"Файл : {filepath} ({len(data):,} байт)") print(f"Magic : 0x{magic:08X}") print(f"PageSize : 0x{page_sz:X}") print(f"Version : 0x{version:X}") # ─── TOC ───────────────────────────────────────────────────────── toc_raw = read_block(data, 16) # TOC идёт сразу после 16-байтного заголовка if toc_raw is None: sys.exit("ОШИБКА: не удалось прочитать TOC") n_entries = len(toc_raw) // 12 print(f"TOC : {len(toc_raw)} байт → {n_entries} записей\n") os.makedirs(out_dir, exist_ok=True) manifest = [] for i in range(n_entries): h_addr, d_addr, _ = struct.unpack_from("<III", toc_raw, i * 12) if h_addr == 0 and d_addr == 0: break # метаданные meta_raw = read_block(data, h_addr) name, _ = parse_meta(meta_raw) if not name: name = f"stream_{i}" # данные content = read_block(data, d_addr) c_len = len(content) if content else 0 print(f" [{i}] {name}") print(f" header @ 0x{h_addr:X} data @ 0x{d_addr:X}") print(f" content : {c_len:,} байт") if content: print(f" head hex: {content[:32].hex(' ')}") # ─── сохраняем ────────────────────────────────────────────── safe = name.replace("/", "_").replace("\\", "_") with open(os.path.join(out_dir, f"{safe}.meta"), "wb") as f: f.write(meta_raw) if content: with open(os.path.join(out_dir, safe), "wb") as f: f.write(content) manifest.append( { "index": i, "name": name, "header_addr": h_addr, "data_addr": d_addr, "content_size": c_len, "meta_size": len(meta_raw) if meta_raw else 0, } ) with open(os.path.join(out_dir, "_manifest.json"), "w", encoding="utf-8") as f: json.dump(manifest, f, indent=2, ensure_ascii=False) print(f"\n{'=' * 50}") print(f"Извлечено потоков: {len(manifest)}") print(f"Каталог: {out_dir}/") return manifest if __name__ == "__main__": fp = sys.argv[1] if len(sys.argv) > 1 else "shcntx_ru.hbk" extract(fp)