ssg что это такое

Ssg что это такое

Йен Траут — президент
Роджер Китинг — старший вице-президент
Грегор Вайли — вице-президент
Стив Форд — креативный директор

Индустрия компьютерных и видеоигр

Strategic Studies Group — австралийская компания-разработчик компьютерных игр, которая специализируется на создании стратегических варгеймов. Они авторы серии Decisive Battles of World War II, которая включает игры The Ardennes Offensive, Korsun Pocket, Across the Dnepr, Battles in Normandy и Battles in Italy.

Компания была основана в 1983 году Йеном Траутом и ушедшим из Reach for the Stars. До середины 90-х годов SSG также занималась издательством игр и издавала не только свои игры, но и игры созданные сторонними разработчиками.

В 1980-х годах компания выпускала популярные стратегические игры для Apple II, Commodore 64 и IBM PC. Наиболее известные игры: MacArthur’s War, Reach for the Stars, Carriers at War, Rommel, Europe Ablaze, Gold of the Americas, и Decisive Battles of the American Civil War (в трех томах). Некоторые из этих игр были выпущены для 16 битных платформ, включая Atari ST, и Warlords, но в 2003 году по обоюдному дружескому решению создатель Warlords Стив Фоукнер ушел из SSG и создал собственную компанию Infinite Interactive, для разработки последующих игр серии Warlords.

Ardennes Offensive • Korsun Pocket • Across the Dnepr • Battles in Normandy • Battles in Italy

Battlefront • Decisive Battles of American Civil War • Europe Ablaze • Fire King • Gold of the Americas • Halls of Montezuma • MacArthur’s War • Panzer Battles • Reach for the Stars • Reach for the Stars (2000) • Rommel • Russia: The Great War in the East

Полезное

Смотреть что такое «SSG» в других словарях:

SSG-82 — Тип: снайперская винтовка Страна … Википедия

SSG — Saltar a navegación, búsqueda SSG puede referirse a: Second Study Group, un grupo de criptoanalistas que trabajaron en el estudio del Manuscrito Voynich; Aeropuerto de Malabo (Guinea Ecuatorial), en su código IATA Obtenido de SSG Categorías:… … Wikipedia Español

SSG — is a three letter acronym that may stand for: *SuperSmart Grid, long distance HVDC lines that would provide the infrastructure for transmitting renewable electricity from North Africa to markets in Europe *Särskilda Skyddsgruppen, a special… … Wikipedia

SSG — or SSgt abbrev. Staff Sergeant * * * SSG abbr. staff sergeant. * * * … Universalium

SSG — or SSgt abbrev. Staff Sergeant … English World dictionary

SSG 69 — Steyr SSG 69 Allgemeine Information Einsatzland: Österreich (Österreichisches Bundesheer) … Deutsch Wikipedia

Ssg 82 — The Scharfschutzengewehr 82 (SSG 82) or Sharpshooter s Rifle, 82 is a rifle chambered in the 5.45×39 Soviet cartridge built in East Germany at the end of the Cold War. Very little is known about this weapon and very few examples have been… … Wikipedia

SSG 08 — Steyr Mannlicher SSG 08 неавтоматическая многозарядная снайперская винтовка с цилиндрическим затвором, приводимым в действие вручную с помощью изогнутой рукоятки, расположенной справа. Разработана винтовка австрийской компанией Steyr Mannlicher… … Википедия

SSG — Die Abkürzung SSG steht für: Sondersammelgebiete im deutschen Bibliothekswesen Spezial Studiengruppe (engl. Special Study Group) Staatliche Schlösser und Gärten Baden Württemberg Stereosichtgerät, eine Anzeige der Beziehung beider Kanäle eines… … Deutsch Wikipedia

Источник

Как выбрать свой Static Site Generator — Новая документация Docsvision ч.1

Я хочу поделиться историей о том, как мы пришли к новой документации и почему. Сначала я кратко расскажу, как устроена наша «старая» документация, а потом расскажу о том, как мы пришли к новой документации.

Эта статья посвящена выбору генератора статических сайтов и тому, что это вообще такое. В следующей статье расскажу подробнее о самом процессе перехода.

Как устроена старая документация

Наша СЭД имеет модульную структуру, и для каждого модуля пишется своё большое руководство, а то и целых три (пользователь, администратор, программист). А ещё есть маленькие документы: список изменений, исправленных ошибок, правила обновления и т.п.

Большие руководства:

От

А вот для Службы фоновых операций документации совсем немного:

Чем не устраивает?

Мы решили, что текущий вид документации нас не устраивает.

Во-первых, всё в офлайне.

Да, есть html, который мы выкладываем на сайте, но это не то, потому что есть ещё pdf.

Во-вторых, разные исходные форматы.

Хорошо бы оставить только один.

В-третьих, нет разбивки на версии.

В репозитории всё удобно, но результирующие файлы лежат в папках версий, созданных вручную.

У всех (примеры будут ниже) документация уже давно в онлайне, а мы всё выкладываем свои pdf да статичные html. Даже наши конкуренты уже выложили документацию в онлайн. Нужно срочно что-то менять.

Я начал присматриваться к рынку и вывел примерные требования к нашей новой документации.

Требования

Примерный список требований к новой документации:

Единый исходный формат документации.

Явное отображение текущей версии документации.

Дата последних изменений.

Страница документации в разработке.

Хлебные крошки для навигации.

Повторное использование текста документации.

Возможность предпросмотра до публикации онлайн.

Было бы неплохо иметь основное содержание и содержание на странице.

Обязательно поиск по сайту. Swiftype, Tipue, Agoolia Docs Search (говорят, что быстро разворачивается), Google Search (использовать гуглопоиск может быть весьма удобно и круто).

Было бы очень здорово найти решение для создания диаграмм.

Валидация документов перед публикацией. Проверка на потерянные изображения, сломавшиеся ссылки.

Спойлер: не все требования нашли реализацию в новой документации, но результат нас полностью устраивает.

Мы решили не рубить с плеча и делать переход поэтапно. Примерно как на картинке выше. Документацию к следующему выпущенному модулю мы переведём на новый формат. А потом подтянутся и другие.

Понимание задачи

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

Генератор работает так: Берём исходники в любом формате, редактируем их, закидываем в репозиторий. Между редактированием и репозиторием некоторые позволяют иметь предпросмотр, валидацию битых ссылок и прочие приятные плюшки. Затем Git собирает сайт из исходников в нашем формате, преобразовывая его в HTML, и публикует онлайн по заданному адресу.

Неплохой разбор SSG от GitLab (на английском).

Дальше я приведу примеры сайтов.

Примеры статических сайтов под наши требования

DITA OT

Сайт пишется на Markdown и HTML, разворачивается на Netlify. При этом исходники сайта лежат в репозитории GitHub.

enriched with Liquid templating tags and styled with Sass. The Bootstrap framework provides the foundation for the site layout. The Jekyll publishing engine combines these plain text components to the final static website you see here.

Удобно, что есть версия «в разработке» и её может изменить почти любой пользователь прямо из браузера.

Неудобно, что есть и MD, и HTML.

Удобно, что есть инструкция по разворачиванию, которую можно использовать как шаблон.

Неудобно, что слишком много переменных: Jekyll, Liquid, Bootstrap.

Повторное использование при помощи Liquid и Jekyll, видимо. Нет last modified, но есть разбивка на версии.

Иронично, конечно, что сайт DITA Open Toolkit написан на Markdown.

YouTrack

Есть last modified, но нет кем. В принципе, неважно. Есть разбивка на версии, но с самой новой версии нельзя переключиться на версию постарше. Или можно, но в YT документации баг.

Нашёл документацию IntelliJ Platform SDK, Исходники в репозитории. Суть та же. Но выяснить, как они её разворачивают не удалось.

GitLab

Сайт документации GitLab. Исходники в репозитории. Написан на Markdown, в создании участвует Nanoc, который генерирует сайт и Rouge, который подсвечивает синтаксис. Есть целая статья со всеми подробностями процесса разворачивания. Статью можно изучить очень подробно и попробовать воспроизвести, если захочется такую же конфигурацию.

Есть разбивка на версии и всё, что душе угодно. Кроме last modified, но это не должно быть особенно сложно добавить.

GitHub Docs

Есть разбивка на версии в правом углу на весь сайт. Нет last modified и вообще мало информации о том, как это построено. Только Nanoc на своей странице хвастается тем, что GitHub Docs на нём построен.

Страница GitHub Developer перенаправляет на docs.github.com. так что это одно и то же, а у nanoc, похоже, старый скрин.

Bootstrap

Bootstrap docs построен на Hugo, написан на Markdown. Репозиторий на GitHub. Наверное, самый удобный сайт. Есть версионирование, есть меню страницы, правда, нет хлебных крошек.

Интересно, что основное меню или меню страницы никуда не уезжают, а фиксированы на странице. От Bootstrap я ожидал больших выкрутасов с выезжающими и скрывающимися меню. Но, наверно, чем проще, тем лучше.

На сайте используется поиск от Agoolia Docs Search. Инструкция по разворачиванию для документации есть вот тут.

Prometheus.io

Я хз, что такое Prometheus.io, но для примера я добавил и его. Сайт сделан на Nanoc, для разворачивания требуется Ruby. Всё содержимое в репозитории на GH. Там же есть инструкция по разворачиванию. Сам сайт написан на Markdown.

Есть содержание страницы, но нет никакого last modified. Разбивка на версии (там, где она есть) встроена прямо в меню сайта. Можно использовать образец.

Jekyll

Логично предположить, что Jekyll (один из самых распространённых SSG для Markdown) и особенно документация построены на Jekyll и разворачиваются через GitHub. Есть поиск, разбивка на версии, меню для разнообразия с правой стороны. Есть небольшая инструкция по локальному запуску, но она что-то не очень подробная. Но есть и инструкции на самом сайте Jekyll. Создан на Ruby.

Antora docs

Очень уютно. Можно просто клонировать репозиторий и попробовать создать из него. Или использовать Antora из докера.

Asciidoc Docs

Репозиторий, сайт. Инструкция, как собрать есть в документации Antora. То есть можно клонировать и построить сайт, только заменив файлы. Использует на Netlify для разворачивания.

А ещё SSG могут

Иметь аутентификацию пользователей Но зачем это сайту с документацией? Ради прикола исключительно.

Sitemap и SEO, тогда документацию смогут находить из поисковиков и вовлекаться в продукт. Но это не точно.

Наши варианты решения

Отлично, рынок я посмотрел, дальше нужно выбирать решение, подходящее именно нам.

Плюсы: Минимум усилий, не потребуется менять формат документации, можно не настраивать UI, т.к. он уже готов. Из Markdown при помощи DITA-OT тоже без проблем можно создать HTML.

Минусы: Если решим что-то изменить, то придётся настраивать DITA OT, XSLT. В DITA OT и XSLT преобразованиях я не силён, я вообще мало чего в них понимаю, потому что унаследовал всё от коллеги. Всегда можно спросить коллегу, но тварь я дрожащая или моя обязанность сделать всё самостоятельно. К тому же при таком раскладе исходники и конечный результат разделены. Придётся либо придумать способ автоматизации сборки из исходников документации и публикацию результата в другой репозиторий, который будет собираться в сайт, либо как-то иначе настроить процесс сборки документации, чтобы документация из исходников собиралась в сайт. Разбивка на версии тоже по умолчанию будет отсутствовать, потребуется допиливать. Не хотелось бы.

Пример сайта на DITA

Но толку от такого сайта мало. Нет разбивки на версии, нет last modified. И, опять же, решение громоздкое.

Но это отдельная стоимость и решение закрытое, хотелось бы open source.

Небольшая часть документации у нас уже на MD. Почему бы не конвертировать всю документацию в этот формат?

Конвертировать в MD из DITA можно c использованием преобразования, которое есть в DITA OT.

Без дополнительных настроек получаем следующее:

Примечания (admonitions: Note, important и т.д.) вообще никак не конвертируются, остаётся только подпись жирным Note.

Удаляется почти всякое форматирование: моноширинный, курсив и т.д.

Зато сохраняются картинки.

Но мне всё равно хотелось сравнить все плюсы и минусы.

ЗА MD:

Некоторые руководства уже в MD.

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

Можно применить трансформацию DITA OT и конвертировать всё разом.

ПРОТИВ MD:

Большое количество разновидностей т.н. flavors.

Совсем простой синтаксис. Многое (перекрёстные ссылки на разделы топиков, например) придётся изобретать при помощи SSG или ещё как-то.

Руководств в MD у нас не так много (я бы оценил в 10-20 процентов, но это не точно).

Для более-менее достойного результата нужно будет настроить XSLT трансформацию. Это трудоёмко и я не знаю ничего о настройке XSLT.

Очень часто нужно переключать раскладку, чтобы обозначить заголовок. После таких сложных действий я нередко путаюсь в том, на каком языке печатаю. А ещё пробелы. Бесконечное количество пробелов, которые визуально считать сложнее, чем символы.

Следующие действия (упрощённо)

Получается примерно следующий алгоритм действий, которые нужно выполнить для перехода на новую документацию:

Выбираем новый формат документации.

Находим SSG под этот формат.

Смотрим, можно ли повторно использовать.

Определяем структуру папок, поддерживаемую выбранным SSG.

Находим инструкцию, а лучше примеры, как сделать сайт на этом формате с этим SSG.

Находим редактор под выбранный формат, чтобы было удобнее работать.

Создаём сайт по инструкции для SSG.

Обычно всё оказывается не так просто в действительности, но посмотрим.

Какие ещё форматы могут быть использованы для создания статических сайтов?

Есть разные форматы-языки, есть даже пара Wiki. Я нашёл, какие форматы поддерживает GitHub, чтобы определиться с форматом документации и идти от него:

Я решил остановить выбор на AsciiDoc (.adoc).

Я определился!

Многое из того, что DITA делает через XSLT (а в MD отсутствует полностью) в AsciiDoc работает из коробки и делается одной строкой. Подписи типа «Рисунок X», номера разделов, перекрёстные ссылки, ключи, передвинуть уровни разделов: всё можно сделать одной строкой.

С IntelliJ Idea ещё и проверка орфографии лучше, чем в Typora Sublime Text, Notepad++ и Oxygen вместе взятых.

И предпросмотр лучше, чем в Typora или Sublime Text.

AsciiDoc также поддерживается GitHub и конвертируется в документ из кода.

Есть одна чёткая версия документации.

Конвертация через Pandoc

Всё ещё остаётся вопрос с конвертацией из DITA. Тут на помощь приходит Pandoc. Он не работает с DITA напрямую, но он работает с HTML, а мы можем из DITA сделать HTML.

Пакетная обработка файлов

Чтобы обрабатывать файлы пачками, а не по одному, нужно создать bat-файл для консоли со следующим содержимым:

Важное замечание: Я конвертировал из простого HTML. Так результат получается чуть более приличным, чем при конвертации из нашего кастомного XSLT шаблона.

Недостатки конвертации

После двойной конвертации остаются артефакты:

Оглавление формируется с небольшими ошибками (link::topics/topic.adoc вместо xref::topic.adoc). Но это дело нехитрое. Нужно только сделать простую замену.

Картинки отображаются неправильно иногда, но это опять же не великая проблема.

Далее я приведу пару скриптов для замены некоторых артефактов конвертации. Скрипты были взяты из открытых источников и доработаны мной, сообществом и моими коллегами.

Удалить ID

Простые замены

Примеры более сложных элементов, которые необходимо обработать после:

После обработки скриптом возникнут трудности с более сложными элементами.

Подчёркивание

Специфика DV

#/Dashboard портит работу скрипта. Строка в результате будет такого вида:

Другие доработки

Но в таком виде [.ph] сильно мешает:

Это редкие случаи, но важные. Потому что даже после полного редактирования возникают ошибки:

ДО РЕДАКТИРОВАНИЯ

ПОСЛЕ РЕДАКТИРОВАНИЯ

Но можно и оставить. Это будут так называемые кастомные роли в AsciiDoc. К ним можно применить особый CSS, что может быть удобно, если такой уже имеется для DITA и хочется сохранить вид как после DITA.

Изображения

Решение: Использовать скрипт в следующих случаях нет смысла по-моему. Тут либо руками, либо сразу предусмотреть такие моменты при конвертации, используя API Pandoc. А ещё можно поиском из IntrelliJ убрать, просто через CTRL+SHIFT+R.

Конвертация будет выдавать вот такой однострочный макрос для изображения:

image::img/dcard_delete_button.png[[.fig—title-label]##Рис. 1. ##Кнопка удаления карточки]

Точнее он должен быть однострочным, но получается в несколько строк:

HTML исходник выглядит так:

То есть желательно сделать следующее:

Добавить перенос строки.

Добавить перенос строки.

На новой строке добавить ссылку на изображение image::img/authentication.png и квадратные скобки.

Удачи в автоматизации этого добра))

Примечания

Но если заголовок вида [.note__title]#Important:# :

Нужно заменить в примечаниях слово NOTE на слово IMPORTANT (обязательно капсом). Заголовок [.note__title]#Important:# удалить:

Или заменить вот такое:

Но надёжнее будет первый вариант, с блоком, т.к. примечания могут быть в несколько строк.

Menucascade

В AsciiDoc есть макрос для меню:

Но из DITA через HTML выходит такое:

Можно заморочиться и заменить всё menucascade на правильные, если вам это надо. Так как я хотел всё по красоте, то я заморочился и заменял все эти недостатки вручную.

Впрочем, есть ограничения. В AsciiDoc макрос меню нельзя затолкать изображение (на самом деле можно, но это не рекомендуется создателями). В таком случае придётся либо описательно называть кнопки, либо изворачиваться как-то ещё.

Заключение

Источник

Торговая стратегия Sincere Systems – можно ли доверять? Отзывы реальных пользователей.

Sincere Systems – платформа, которая занимается продажей алгоритмов для торговли на финансовом рынке. Целевая аудитория сервиса – люди среднего класса, начинающие трейдеры и те, кто желает добиться финансовой независимости.

Согласно легенде компании, они уже более 10 лет занимаются разработкой программ, которые помогают торговать на рынке. Но вот в чём вопрос, можно ли доверять этой конторе? Сегодня рассмотрим Sincere Systems более детально, поскольку мнения трейдеров расходятся на их счёт.

Регистрация аккаунта в Sincere Systems и личный кабинет инвестора

Зарегистрироваться на сайте Sincere Systems не так и просто, как хотелось бы. Получить доступ к боту, или даже хотя бы ознакомиться с его функционалом можно через форму регистрации, но при условии, что новый пользователь укажет своего спонсора.

Через официальный сайт мошенников нельзя узнать никакой конкретной информации по работе их уникальной системы, пользователи не получают ничего о механизме алгоритмической торговли бота компании. Даже если заглянуть в раздел FAQ, то можно узнать, что их программное обеспечение работает на основе нейронных сетей и проводит анализ рынке на основе аналитики лучших трейдеров.

Но глядя на всё это, сразу можно рассмотреть финансовую пирамиду. Особенно если перейти во вкладку «Лидеры», то можно ознакомиться с каждым участником на любом уровне.

Ранее на их сайте была информация о многоуровневой реферальной программе, но мошенники поспешили избавиться от неё.

Можно ли инвестировать в технологии Sincere Systems?

Рассматривая данную платформу, постоянно натыкаешься на «подводные камни», которые компания пытается скрыть от своих пользователей. Первое, на что хотелось бы обратить внимание – минимальный депозит в 100 долларов, но компания не предоставляет никакой информации о том, куда именно инвестирую трейдеры. Единственное, на чём могут они торговать – валютный рынок, но из-за своей волатильности, гарантировать стабильный высокий профит они явно не могут.

Также необходимо выделить ещё несколько значимых моментов:

Мнение пользователей о брокере

В интернете размещено множество отзывов о работе Sincere Systems. Некоторые пишут, что необходимо рисковать, чтобы получать профит, другие наоборот, убеждают, что с ними не стоит связываться.

Если опираться на факт отсутствия лицензии и то, что это пирамида, необходимо лишь дождаться, когда она развалится.

Желаем вам наилучших результатов в трейдинге на бинарных опционах!

Выход есть!