Что такое среда выполнения Microsoft Sandcastle

Обновлено: 24.11.2024

<р>1. большое количество мельчайших частиц щебня, ракушек и т.д, встречающихся на пляжах и т.д. Песок رمل, ططام Письк Areia Písek der Sand Sand άμμος Arena Liiv شن Hiekka Sable חול रेत, सिकता Pijesak Homok Pasir Sandur Sabbia 砂 모래 Smėlis Smiltis Pasir Zand Sand Piasek شګه, ريګ, په شګو ډډول, ريګو لاندى كول, په ريګو پوښل, ريګ مالول، په شګه موښل areia nisip песок piesok prod pesak sand ทราย kum 沙子 пісок ریت cát 沙子

<р>2. участок песка, особенно на пляже. Лежим на песке. Песок رمل الشاطئ Плаж Ариа Плаж Дер песчаный песок αμμοΔάά Playa Areenosa (Ranna) Liiv شنزار Hiekka Plage חוֹלוֹת बालू-तट Pješčana Ravnica Föveny, Homok (Часть ОС) Пантай Берпасир Сандеру Спеагиа 砂浜 모래 밭 Smėlis Smiltis; PLUDMALE KAWASAN BERPASIR ZAND PAND PIASEK ريګ Areia Plajă Pesashynyy Пляж Pláž Pesek Pesak Sand ชาย หาด Kumsal, Kumluk 沙灘 pіsok ساحل کی ریتیلی زمین Bãi Cát, LớP Cát 沙滩

отшлифовать например наждачной бумагой. Перед тем, как покрыть лаком, пол следует отшлифовать. skuur يزجج опесачавы lixar obrousit schmirgeln slibe λειαίνω, περνώ με γυαλόχαρτο lijar liivapaberiga hõõruma شن مال كردن hioa hiomapaperilla Саблер לְלַטֵש रेगमार, लकड़ी पर पॉलिश करने का बालू लगा हुआ काग़ज़ pjeskariti, izgladiti pijeskom smirgliz, (ль) csiszol mengampelas pússa með sandpappír sabbiare み が く 사포 로 닦다 šlifuoti, šveisti slīpēt/tīrīt ar smiltīm/smilšpapīru mengempelas schuren slote med sandpapir wyszlifować ريګ مالول lixar netezi; şlefui шлифовать obrúsiť obrusiti šmirglati sandpappra, slipa мед sandpapper ขัด ด้วย ทราย кум serpmek, кум doldurmak 用 砂紙 磨平 шліфувати наждачним папером ریگ مال وغیرہ سے رگڑ کر صاف کرنا RAI кошке, Phu Cát 用 沙 纸 磨光 <р>1. заполнены или засыпаны песком. песчаный пляж. sanderig رَمْلي пясъчен arenoso písečný Sand-. Sandet αμμώΔης Arenoso, de Arena Liivane پوشيده از شن و ماسه hiekkainen sablonneux חולי रेतीला pješčan, pjeskovit homokos berpasir sendinn sabbioso 砂 の 모래 의 smėlio smilshines; Smilšu- Berpasir Zanderig Sand-, Sandoldig, Sandet Piaszczysty شګلن, ريګى Arenoso Nisipos Peschanyy Pieskový, Peiesočný peščen peščan Sandig, Sand- ปกคลุม ด้วย ทราย ทราย ر ر含沙 ر 的, 被被 沙 的 pіщаний ریتیلا, cóct, phủ cát 沙 的, 含沙的

<р>2. (волос) желтовато-красного цвета. У нее светлая кожа и песочные волосы. sandkleurig أصفر كلون الرمل, رملي жълтеникавочервен Руиво pískové Barvy rotblond sandfarvet κοκκινόξανθος (για μαλλιά) Рубио Oscuro liivakarva رنگ حنايي hiekanvärinen блондинка подливку אָדוֹם-צְהַבהַב पीलापन लिए हुए लाल (बाल) žutocrvene Boje vörösesszőke pirang ljósrauður Biondo rossiccio 砂 色 の 모래색 Smėlio Spalvos smilškrāsas- Perang Muda Rossig Rødblond Rudawo-Blond سور Ruivo Arămiu Рыжеватый Piesková Farba Peščen Boje Peska Rödblond สี เหลือง อม แดง แดง แดง 的 pіskovi, Рудувитий زردی مائل سرخ có màu cát 沙色 的

отмель, образованная приливами и течениями. отмели شاطئ رملي пясъчна плитчина Банко де Арейа NANOS письку умирают Песчаная revle αμμώδες ανάχωμα που σχηματίζεται από τα θαλάσσια ρεύματα Банко де арена liivakallas ساحل شنی hiekkasärkkä Banc де соболя שרטון रेती, सकैत Pješčana Obala homokzátony beting Pasir sandalda / -hryggur Банко ди Саббиа 砂州 모래톱 Smėlio sekluma, sąnašos smilšu sēklis tebing Пасир zandbank sandbanke mielizna څوک چی په ساحل کی ژوند کوی Банко де Арейа Banc де nisip песчаная отмель NANOS piesku, piesčina sipina peščana Obala отмель สันดอน ทราย кум SETI 沙洲 піщана обмілина, банка بالوچر Bai Cát 沙洲, 沙丘

куча песка, иногда напоминающая замок, построенный специально детьми на пляжах. sandkasteel قلعة رمليه пясъчен замък Каштелу де Арейа град Z письку умереть Сэндберг sandslot πύργος στην άμμο Castillo де арена liivaloss قلعه ماسه اي hiekkalinna шато де соболя אַרמוֹן חוֹל बालू का महल dvorac спосо pijeska homokvár пури Пасир sandkastali Кастелло ди Саббиа 砂 の 城 모래성 Smėlio Pilis smilšu Pils Istana Pasir Zandkasteel Sandslott Zamek Z Piaku د شګو تپه Castelo Na Areia Castel de Nisip Замок из храма Hrad z Piesku Peščeni Grad Zamak od Peska Sandslott ปราสาท ที่ ก่อ ด้วยด้วย ทราย ทราย ทราย ทราย ทราย 沙堡沙堡 沙堡 ด้วย กอง ทราย ریت کا محل lâu đài Trên Cát 沙堡，沙塔

разновидность бумаги с приклеенным к ней песком, используемая для сглаживания и полировки. skuurpapier ورق الزجاج шкурка lixa skelný Papír дас Sandpapier sandpapir γυαλόχαρτο Lija, Papel де Lija liivapaber كاغذ سمباده hiomapaperi папье-де-Verre נְייָר לֶטֶש रेगमाल, रेगमार brusni Папир smirgli Ампелас sandpappír Carta vetrata 紙 や す り 사포 švitrinis popierius, švitras smilšpapīrs kertas Пасир schuurpapier sandpapir папье ścierny ريګ مال، شګ موښى lixa şmirghel наждачная бумага brúsny papier smirkov papir šmirgl papir sandpapper กระดาษทราย zımpara kağıdı 砂紙 наждачний папір; наждачка ریگ مال giấy ráp, giấy nhám 沙纸

сгладить наждачной бумагой.skuur يحك بورق الزجاج изтърквам с шкурка lixar obrousit schmirgeln slibe λειαίνω, περνώ με γυαλόχαρτο lijar liivapaberiga lihvima سمباده كشيدن hioa poncer לְלַטֵש रेगमार करना izgladiti brusnim papirom smirgliz mengampelas pússa carteggiare, cartavetrare 紙 や す り を か け る 사포 로 매끄럽게 하다 nušveisti noslīpēt; notīrīt (ар) smilšpapīru mengempelas рад schuren slipe мед sandpapir szlifować papierem ściernym ريګ مالول, په شګه موښل lixar şmirghelui шлифовать obrúsiť smirkati šmirglati sandpappra, slipa (putsa) мед sandpapper ขัด ด้วย กระดาษทราย zımparalamak 用 砂紙 磨平 шліфувати наждачним папером ریگ مال سے ہموار بنانا đánh giấy rap 用沙纸磨光

мягкая легкая обувь, часто на резиновой подошве. strandsandale حذاء مطاطي خفيف гуменки sapatilhas plátěnky умирают Strandschuhe (пл.) strandsko σανδάλια (πληθ.) playeras rannakingad كفش راحتي kumipohjaiset tossut эспадрильи סַנדָלִים रेत पर चलने के लिए जूते lagane cipele ZA plažu strandcipő sepatu Karet espadrilla, strigaskór Scarpe ди Tela ゴ ム 底 靴 가벼운 테니스화 paplūdimio sandalai buraudekla apavi; Pludmales APAVI sejenis Kasut янь lembut дан ringan strandschoenen strandsko obuwie plażowe څپلۍ sapatilhas espadrile пляжные туфли plátenky espadrile papuče strandskor รองเท้า เดิน บน ทราย Lastik tabanlı Keten Ayakkabı 沙灘鞋 пляжні черевики نرم ہلکے جوتے Giay Dji Cát 沙地 软 鞋

мягкая горная порода, состоящая из слоев песка, спрессованных вместе. sandsteen حجر رملي пясъчник Грес pískovec дер Sandstein sandsten αμμόλιθος Пьедра arenisca liivakivi ماسه سنگ hiekkakivi Grès אֶבֶן-חוֹל बलुआ पत्थर, बालुकाश्म pješčenjak homokkő Бату Pasir sandsteinn агепапа 砂岩 사암 Smiltainis smilšakmens Бату Pasir zandsteen sandstein piaskowiec شګلن كاڼى, ريګلن كاڼى Грес gresie песчаник pieskovec peščenjak peščar Sandsten หิน ทราย ซึ่ง เกิด จาก การ เกาะ เกาะ กัน กัน เหนียวแน่น ของ เม็ด ทราย ตัว กัน อย่าง เหนียวแน่น เม็ด ทราย ทราย ทราย อย่าง เหนียวแน่น ของ เม็ด ทราย ทราย ทราย پ پپر Sa Thạchch (đتھر SA Thạchch (đđđ Cát kết lại mà thanh) 沙岩

штормовой ветер, несущий с собой облака песка. Мы попали в песчаную бурю в пустыне. Песчаная, stofstorm عاصفة رمليه пясъчна буря tempestade де Арейа Písečná Буре дер Sandsturm песчаная αμμοθύελλα Tormenta де арена liivatorm طوفان شن hiekkamyrsky Tempete де соболя סוּפַת-חוֹל रेतली आंधी, रेतीला तूफान Pješčana oluja homokvihar Бадай Пасир sandstormur / -rok Tempesta ди Саббиа * 砂 あ ら し 모래 폭풍 Smėlio Одра smilšu Ветра рибут Пасир zandstorm песчаная / -rokk Burza Piaskowa طوفان tempestade де Арейа Furtuna де nisip самум, песчаная буря piesočná Бурка peščeni Вихар peščana oluja песчаная พายุ ทราย кум fırtınası 沙塵暴 самум, піщана буря ریتیلی آندھی Bao Cát 沙尘暴

Разработчикам нужен был еще один инструмент, чтобы взять XML
и создать что-то удобочитаемое. Проект NDoc с открытым исходным кодом ответил на этот вопрос,
улучшив и упростив процесс, а также предоставив различные форматы файлов справки. К сожалению, этот проект
недавно завершился, поскольку его создатель не получил почти никакой помощи от
сообщества разработчиков.

Как получить замок из песка

Под капотом

В Sandcastle есть три основных компонента: MrefBuilder, Build Assembler и XslTransform.
Эти инструменты используют выходные данные, созданные при компиляции сборок. Сюда входит
файл DLL, а также любые файлы комментариев XML.

MrefBuilder анализирует
сборки проекта и создает выходной файл. MrefBuilder
является инструментом командной строки, устанавливаемым вместе с Sandcastle. Сгенерированный выходной файл
преобразуется с помощью инструмента командной строки xslTransform
в файл с именем Reflection.xml. Файл Reflection.xml содержит все данные документации,
но не детали представления.

После завершения MrefBuilder
вступает в силу Build Assembler. Он доступен как инструмент командной строки
BuildAssembler. Он берет данные, сгенерированные MrefBuilder
(reflection.xml), вместе с комментариями к коду (в
отдельных файлах XML) и создает логически сгруппированные файлы HTML. Эти HTML-файлы
используются компилятором справки HTML для получения окончательного вывода.

Этот инструмент не ограничивает вас работой с одной
сборкой за раз. Вам нужно будет покопаться в файле конфигурации Sandcastle, когда вам
нужно обработать несколько сборок. Это XML-файл, содержащий
шаги, необходимые для создания разделов для вашего файла справки.

Вывод

Вывод, созданный Sandcastle, имеет следующие особенности:

  • Внешний вид и поведение в стиле MSDN.
  • Автоматически создаваемые
    элементы указателя, элементы таблицы содержания, разбивка по темам и макет страницы
    способствуют согласованности и знакомству.
  • Автоматически созданные
    разделы объявления синтаксиса.
  • Автоматически созданные
    таблицы наследования.
  • Кодируйте
    раскрашивание.
  • Несколько
    стилей и выбор языка дают конечному пользователю возможность выбирать
    свои любимые предпочтения.

Вывод оформлен и представлен с помощью HTML и CSS, и
Microsoft обещает в будущем использовать другие стили.

Дополнительные интерфейсы

Многие разработчики содрогаются при столкновении с
интерфейсом командной строки — они предпочитают удобный графический интерфейс, такой как популярная Visual
Studio IDE. Доступны сторонние инструменты, которые позволяют управлять процессом
Sandcastle через удобный графический интерфейс. Вот три доступных:

  • Sandcastle
    Создание файлов справки: предоставляет интерфейс, аналогичный NDoc, и
    позволяет импортировать существующие проекты NDoc и автоматизировать
    процесс сборки.
  • SandcastleGUI: это
    свободно доступный внешний интерфейс с графическим интерфейсом для Sandcastle.
  • Sandcastle
    CHM-компиляция BAT-скрипта и утилита настройки: это
    утилита настройки и пакетный скрипт для создания CHM-файлов класса
    документации в стиле MSDN с помощью Sandcastle.

Помогите другим

Разработчикам необходимо знать, как работает приложение, когда
они работают с его кодом, а также как использовать
интерфейс любого приложения. Microsoft Sandcastle предоставляет инструменты, необходимые для создания документации в стиле MSDN для вашего
проекта. Ознакомьтесь с этой вики о Sandcastle, чтобы узнать больше об этом инструменте.

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

Пропустить столбец?

Тони Паттон начал свою профессиональную карьеру в качестве разработчика приложений, получив сертификаты Java, VB, Lotus и XML, чтобы закрепить свои знания.

Насколько я понимаю, существует 3 формата справки для программ Windows:

  1. hlp – очень старый формат, полученный из исходников RichText, больше не поддерживается
  2. chm — все еще поддерживаемый формат, полученный из исходников htm
  3. Microsoft Help 2.0 — самый современный формат, используемый Visual Studio, Embarcadero Delphi и многими другими программами.

Хорошо, теперь я тоже решил придерживаться chm. Но я не понимаю этих решений, потому что Help 2.0 был намного привлекательнее визуально, чем chm!

Много лет назад надежда на новую справочную систему Microsoft не оправдалась — я и тогда не понимал решений (как Microsoft Help MVP).

1 Ответ 1

HTMLHelp находится в "режиме обслуживания" уже несколько лет. Никаких новых функций не ожидается, и теперь будут происходить только критические обновления. Насколько мне известно, в Microsoft не разрабатываются новые справочные системы.

Я думаю, вы могли догадаться, что CHM будет существовать довольно долго, учитывая, что замены нет. Справка MS 2 (используемые расширения см. также: *.HXS) была только для VS 2002/2003/2005/2008 и вся разработка остановлена. Некоторые версии Delphi также поставлялись со справочной системой на основе *.hxs.

MS Help Viewer (.mshc) был многообещающим, но в то время сложным в управлении. Он был создан в основном для таких компаний, как Microsoft, которые кодируют свою справку из базы данных.

Некоторая дополнительная информация (концептуальный контент, созданный вручную):

Sandcastle был разработан для документирования кода на основе набора комментариев XML и информации API, найденной в файле информации об отражении. Таким образом, для создания файла справки, содержащего документацию по API, требуется как минимум одна сборка. Если вы не включите хотя бы одну сборку с пространством имен, содержащим хотя бы один общедоступный класс, файл справки не будет создан.

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

Пример ошибки/предупреждения ниже:

Неразрешенная ссылка на сборку: система (система, версия=0.0.0.0, культура=нейтральная, PublicKeyToken=b77a5c561934e089), требуемая netstandard

SHFB: ошибка BE0043: на последнем шаге сборки обнаружена непредвиденная ошибка. Подробности смотрите в журнале сборки. в SandcastleBuilder.Utils.BuildEngine.TaskRunner.Run(String processFilename, String targetFile, String arguments) в SandcastleBuilder.Utils.BuildEngine.TaskRunner.RunProject(String projectFile, Boolean MinimumOutput) в SandcastleBuilder.Utils.BuildEngine.BuildProcess.Build()" >

Текст был успешно обновлен, но возникли следующие ошибки:

4 октября 2017 г., 10:53, "Эрик Вудрафф" ***@***.***> написал: Можете ли вы прикрепить или отправить мне по электронной почте пример проекта, который я могу использовать для дублирования проблемы? — Вы получаете это, потому что вы создали тему. Ответьте на это письмо напрямую, просмотрите его на GitHub или отключите обсуждение .

Комментарий EWSoftware от 4 октября 2017 г.

Комментарий EWSoftware от 4 октября 2017 г. •

Откуда вы это взяли?Это часть установщика Visual Studio или отдельная загрузка. Если да, то откуда?

4 октября 2017 г., 13:32, "Эрик Вудрафф" ***@***.***> написал: Установите Core 2 SDK Где вы это берете? Это часть установщика Visual Studio или отдельная загрузка. Если да, то откуда? — Вы получаете это, потому что вы создали тему. Ответьте на это письмо напрямую, просмотрите его на GitHub или отключите обсуждение .

Комментарий EWSoftware от 15 октября 2017 г.

прокомментировал jburzynski 22 октября 2017 г. •

У меня точно такая же проблема. Мой проект — .NET Standard 2.0, и я выбрал «.NET Core/.NET Standard» в графическом интерфейсе SHFB. Я пытаюсь собрать его с помощью msbuild 15.4.8.

Большое спасибо за этот замечательный проект!
Надеюсь, я смогу помочь своим примером.

Комментарий EWSoftware от 28 октября 2017 г. •

EDIT: исправленная версия удалена. См. ниже.

комментарий jburzynski от 28 октября 2017 г.

Это происходит сразу после списка конфликтов (Обнаружен конфликт между (.)).

Есть ли у вас идеи, что может быть причиной этого?

Комментарий EWSoftware от 28 октября 2017 г.

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

Читайте также: