Инсталация

Feed и токен

RayCraft.Write не е в nuget.org. Той е в частния feed на RayCraft:

https://nuget.raycraft.dev/v3/index.json

Нужен ви е акаунт в RayCraft с активно право за RayCraft Write. От страницата на акаунта създавате токен за feed-а (организацията може да има няколко токена; токен може да се отмени по всяко време). Пазете токена като парола.

Добавяне на feed-а

Не слагайте токена в хранилището с кода. Добавете източника на вашата машина:

dotnet nuget add source https://nuget.raycraft.dev/v3/index.json --name raycraft --username token --password <ВАШИЯТ-ТОКЕН> --store-password-in-clear-text

На сървър за сглобяване ползвайте тайна, а не файл. В NuGet.config може да сочите променлива на средата:

<configuration>
  <packageSources>
    <add key="raycraft" value="https://nuget.raycraft.dev/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <raycraft>
      <add key="Username" value="token" />
      <add key="ClearTextPassword" value="%RAYCRAFT_TOKEN%" />
    </raycraft>
  </packageSourceCredentials>
</configuration>

Задайте променливата RAYCRAFT_TOKEN във вашата CI система. Не записвайте токена в хранилището.

Потребителското име и точният вид на токена се показват на страницата на акаунта; стойностите по-горе са обичайният вид за feed с токен.

Инсталиране на пакета

dotnet add package RayCraft.Write

или във файла на проекта:

<PackageReference Include="RayCraft.Write" Version="1.*" />

Пакетът съдържа библиотеката (Rte.dll), статичните файлове (_content/Rte/css/rte.css, _content/Rte/js/...), десетте езикови пакета (вградени), README.md, EULA.txt и THIRD-PARTY-NOTICES.md. Сборката и пространството от имена са Rte.

Регистриране и ползване

Вижте Начало. Настройката, която най-често се забравя, е размерът на съобщенията на SignalR: редакторът изпраща HTML и качени файлове по връзката, а лимитът по подразбиране от 32 KB е твърде малък.

Обновления и версии

Версиите следват семантичното версиране. По-новите версии идват от същия feed с същия токен, докато лицензът ви е активен (лицензът е за една година и се подновява ежегодно). Версиите, които вече сте получили, продължават да работят при условията, с които са дошли (Лиценз).

Лицензният файл

Лицензът е за една производствена инстанция: на практика един публичен домейн. Освен токена за feed-а, акаунтът ви дава подписан лицензен файл (rte.license), издаден за този домейн. Той се проверява локално, офлайн, при всяко стартиране на приложението и не праща нищо по мрежата. Сложете го на едно от тези места (проверяват се по този ред):

1. RteServerOptions.License.Text или .FilePath, подадени на AddRte(o => o.License = ...).
2. Променливата на средата RTE_LICENSE (съдържанието на файла) или RTE_LICENSE_FILE (път до него).
3. Файл с име rte.license до приложението.

Без валиден файл, или на адрес, който файлът не покрива, редакторът продължава да работи, в режим за оценка: показва се банер, а износът в Word, вносът и библиотеката от файлове се изключват. Нищо от съдържанието ви никога не се изтрива или заключва.

Домейни

Лицензът посочва единия производствен адрес, за който важи (example.com, или *.example.com за всички негови поддомейни). Лицензът не е обвързан с конкретен компютър или сървър, затова преместването на същото приложение на нов хардуер, или разпределянето му на няколко сървъра зад баланс на натоварването, не иска нов файл. localhost, 127.0.0.1 и всеки адрес, завършващ на .localhost, .local или .test, винаги работят, без лиценз, за локална разработка. Тестов или staging поддомейн на истинския ви домейн (staging.example.com) не е безплатен сам по себе си, затова не може да се ползва и като безплатна продукция; добавете го в лиценза (или ползвайте заместител) по същия начин като производствения адрес, или пишете на support@raycraft.dev, за да добавите втори адрес.

Вижте Лиценз какво значи всяко състояние на банера и какви са условията.

Отстраняване на проблеми

Признак	Вероятна причина
NU1101 или Unable to find package RayCraft.Write	feed-ът не е добавен, или токенът е грешен или отменен
401 или 403 от feed-а	токенът не е валиден, или организацията ви няма право за RayCraft Write
редакторът показва само текста от сървъра	страницата не е интерактивна: добавете @rendermode InteractiveServer
връзката прекъсва при поставяне на картина или файл	лимитът на съобщенията на SignalR е малък (AddHubOptions)
страницата за миг изглежда нестилизирана	добавете <link> към rte.css в App.razor