Модули для работы с OpenCL и OpenGL


#67

Я провёл несколько значительных изменений в процессе упаковки OpenCLABC.

  1. Справка OpenCLABC переведена в вид html:
    Справка OpenCLABC.html (61,1 КБ)
    Если б случайно не наткнулся на MarkDig - я, наверное, ещё б не скоро начал)) Маркдаун таки тащит! Особенно в такой оптимизированной и настраиваемой реализации.

    Исходники страниц этой справки тут:
    https://github.com/SunSerega/POCGL/tree/master/Packing/Spec/CL%20ABC
    Ну а исходники упаковщика справок - в предыдущей папке.

    Насчёт чистки грамотности - я в первую очередь жду @Kotov (хотя если кто хочет - можете прислать пулл или, хотя бы, сказать где что неграмотно).
    А вот насчёт дизайна - вопрос ко всем, что можно улучшить? Я вижу что выглядит как то сухо, но делать красиво - в целом не очень умею.

  2. Остальные русские тексты тоже вытащены из .pas файла, в отдельные файлы. В основном это касается описаний методов и классов, но я хочу туда же и тексты исключений отправить. Эти файлы можно найти тут:
    https://github.com/SunSerega/POCGL/tree/master/Packing/Doc/OpenCLABC
    Файлы, начинающиеся с цифры 0 - это всякие внутренности. Сами тексты в остальных файлах.

@Admin, ещё будет время перед принятием пула (и я тогда напомню тоже), но раньше - лучше:

Если хотите к чему то придраться в формулировках - делайте это до принятия пула. Сейчас, когда все русские тексты находятся в отдельных файлах - должно быть особо просто пройтись по всему.

Менять то, что попадает в готовый билд, без возможности для меня вовремя вставить свою ревизию - это очень некрасиво.


#68

@Sun_Serega, форматирование кода страдает:

Стоит пройтись по всем примерам кода и подправить форматирование.


#69

Все примеры аккуратно отформатированы ручками и проверены.

Если имелись в виду лишние пробелы - попробуй убрать их и понять на сколько уродливо и нечитабельно получается. Лучше уж так.


#70

Термины, которыЕ часто путают новички


#71

Мда, тексты страниц прошёлся проверил, а на названия в итоге и не смотрел))

Но, я имел в виду больше что то типа “кернел”, то есть не ошибки в записи (в том числе грамматические), а то что лично вам не нравится.


#72

Я сейчас бегло просмотрел справку - мне всё нравится по большому счёту. Всё грамотно и основательно. Возможно, где-то не хватает пары запятых, но это сущие мелочи.

“Объект типа Kernel” - это очень правильно.

А в чём делали справку и как размечали код?


#73

Страницы, как уже сказал - делал в маркдауне, а в HTML преобразовывал библиотекой MarkDig.

Основа (то есть 2 прямоугольника и передвигаемая перегородка между ними) - это чистый HTML + js + css. Вот 3 соответствующих файла.
(HTML код сохранён в .md файле, но синтаксис маркдауна разрешает вставлять HTML код напрямую)

Ну и всё вместе собирает этот .pas файл, к нему же подключён и MarkDig.


#74

И

совсем не получается (скриншот с Sublime Text).


#75

Странные у вас понятия о читабельности. Теперь ещё и без подсветки, то есть однозначно хуже. Вообще можно было в Ctrl+Shift+C поменять чтоб без подсветки не оставаться… Хотя в идеале вообще из IDE паскаля скринить.

В оригинале ударение было на выражения, которые передаёт в SyncInvoke. А в этом варианте чтоб увидеть где каждое из них заканчивается - надо вглядываться и считать скобки. Это плохо.


#76

Если Вы только из-за отсутствия на скриншоте подсветки решаете, что читабельность приведенного мною кода с подсветкой будет хуже Вашего, то:

Да, согласен, но у меня её нет, а устанавливать ради разового скриншота интереса нет.

Новички будут смотреть на Ваш код и ему подражать, если они также станут писать с кучей лишних пробелов, то:

Подумайте надо ли Вам обучать плохому форматированию кода новичков или нет (ведь, на них, в частности, направлены Ваши модули).


#77

А как форматировали код Pascal программы? Подсветка ключевых слов?


#79

Форматировал код - ручками. То есть если вставить код в <pre><code>код</code></pre> - пробелы не убивает. И маркдаун уже сам создаёт оба этих блока (но для инлайн кода, то есть (`код`) - блок pre не создаётся, он там не нужен).

А подсветка - это всего лишь немного магического регекс-говнокода. Вот этот код.

Сразу над ним - код, заставляющий работать спойлеры. К примеру вот кусок со страницы Очередь >> Создание очередей:

:::spoiler { summary="1. Из буфера/kernel-а" hidden=true }

... (тут содержимое скрываемого блока)

:::

А под кодом подсветки особых слов - то что я пару часов назад добавил, подсветка скобок.


#80

Дождался-таки)


#81

В целом всё наконец достаточно стабильно работает, так что создал пулл:

Кому не лень - продитесь по справкам, проверьте на орфографию и т.п.