Geliştiriciler ve içerik üreticileri

Bir tema oluştur

Tema, GlobalStyles ve isteğe bağlı LexerStyles bölümlerini içeren bir XML belgesidir. Tüm diller için kapsamlı stiller gerektiğinde dışa aktarılmış bir temayla başlayın. Ocean başlangıç örneği özellikle küçük tutulmuştur: düzenleyici için mavi bir renk paleti ve birkaç Python stili tanımlar.

Renkler, # işareti olmadan altı onaltılık basamakla belirtilir. Genel WidgetStyle girişleri düzenleyici yüzeyini, kenar boşluğunu, metin imlecini, seçimi ve geçerli satırı tanımlar. LexerType, dil stillerini gruplandırır; styleID değerleri ilgili sözcüksel çözümleyiciye aittir ve başka bir dildeki değerlerden tahmin edilemez. fontStyle bir bit maskesidir: 1 kalın, 2 italik, 4 altı çizili; 0 normal stildir.

1. Elite-Ocean.xml dosyasını indirin ve düzenlemeden önce bir kopyasını saklayın.
2. Ayarlar → Ayarları ve temaları içe aktar → XML temasını içe aktar yolunu açın. İçe aktarma, uygulama kitaplığındaki bir kopyayı etkinleştirir; orijinal dosya değişmez.
3. Python ve düz metin örneklerini açın. Açık ve koyu ortamlarda metni, seçimi, metin imlecini, kenar boşluklarını ve kontrastı kontrol edin.
4. Temalar → Stilleri düzenle bölümünü açın, sonucu iyileştirmek için Bir kopyasını kaydet seçeneğini kullanın; ardından dağıtmak üzere XML olarak dışa aktarın.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <GlobalStyles>
    <WidgetStyle name="Default Style" styleID="32" fgColor="DCEBFF" bgColor="102C54" fontName="Menlo" fontSize="14" fontStyle="0" />
    <WidgetStyle name="Line number margin" styleID="33" fgColor="88A9D2" bgColor="102C54" />
    <WidgetStyle name="Caret colour" styleID="2069" fgColor="62ADFF" />
    <WidgetStyle name="Selected text colour" styleID="0" fgColor="FFFFFF" bgColor="245B96" />
    <WidgetStyle name="Current line background colour" styleID="0" bgColor="15365F" />
  </GlobalStyles>
  <LexerStyles>
    <LexerType name="python" desc="Python" ext="py pyw">
      <WordsStyle name="KEYWORD" styleID="5" fgColor="84C1FF" bgColor="102C54" fontStyle="1" />
      <WordsStyle name="COMMENTLINE" styleID="1" fgColor="8BA6C8" bgColor="102C54" fontStyle="2" />
    </LexerType>
  </LexerStyles>
</NotepadPlus>

UDL ile bir dil tanımlayın

Bir UDL XML dosyası uzantıları, anahtar sözcük gruplarını, yorumları, sınırlayıcıları ve stilleri tanımlar. Daha kapsamlı bir tanım için yerleşik kullanıcı dili düzenleyicisini kullanın; başlangıç örneği .edemo dosyalarında yalnızca task, end, true ve false sözcüklerini vurgular.

Elite-Demo.xml dosyasını kullanıcı dili olarak içe aktarın ve elite-demo.edemo dosyasını açın. Gerekirse özellikle Elite Demo dilini seçin. Uzantılar boşluklarla ayrılır ve başlarına nokta konulmadan yazılır. Test ettikten sonra bir kopyasını dışa aktarın.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <UserLang name="Elite Demo" ext="edemo" udlVersion="2.1">
    <Settings>
      <Global caseIgnored="no" allowFoldOfComments="no" foldCompact="no" forcePureLC="0" decimalSeparator="0" />
      <Prefix Keywords1="no" />
    </Settings>
    <KeywordLists>
      <Keywords name="Keywords1">task end true false</Keywords>
    </KeywordLists>
    <Styles>
      <WordsStyle name="DEFAULT" styleID="0" fgColor="102C54" bgColor="F8FBFF" fontStyle="0" />
      <WordsStyle name="KEYWORDS1" styleID="4" fgColor="1559AD" bgColor="F8FBFF" fontStyle="1" />
    </Styles>
  </UserLang>
</NotepadPlus>

Otomatik tamamlama sözlüğü oluşturma

Otomatik tamamlama API sözlüğü XML biçiminde KeyWord girişlerini listeler. Bir işlev girişi, çağrı ipuçları için Overload ve Param öğeleri içerebilir. Bunlar önerileri tanımlar; işlevlerin kendisini uygulamaz.

İçe aktarılan dosyanın adı dil kaynağını belirler. Örneğin adını python.xml olarak koruyun ve test ederken Python dilini seçin. Yalnızca AutoComplete language özniteliğini değiştirmek başka bir dili hedeflemek için yeterli değildir. Yerine yeni bir sözlük aktarmadan önce mevcut sözlüğünüzü saklayın.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <AutoComplete language="python">
    <Environment ignoreCase="no" startFunc="(" stopFunc=")" paramSeparator="," />
    <KeyWord name="save_note" func="yes">
      <Overload retVal="None" descr="Save a note to the selected path.">
        <Param name="path: str" />
        <Param name="text: str" />
      </Overload>
    </KeyWord>
    <KeyWord name="project_name" />
  </AutoComplete>
</NotepadPlus>

İşlev listesi kuralları ekleme

İşlev ayrıştırıcısı, bildirimleri tanımak ve adlarını çıkarmak için düzenli ifadeler kullanır. Örnek, Elite Demo dilindeki task bildirimlerini bulur. elite-demo-functions.xml ve overridemap.xml dosyalarının ikisini de işlev kuralları içe aktarıcısıyla içe aktarın.

Geçersiz kılma haritası, Elite Demo adlı UDL dilini elite-demo-functions.xml dosyasına bağlar. Zaten bir haritanız varsa diğer eşlemeleri kaybetmemek için yeni ilişkilendirmeyi mevcut haritayla birleştirin. .edemo örneğiyle ve bildirim içermeyen bir dosyayla test edin.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <functionList>
    <parser id="elite-demo" displayName="Elite Demo">
      <function mainExpr="(?m)^task\h+\w+">
        <functionName><nameExpr expr="task\h+\K\w+" /></functionName>
      </function>
    </parser>
  </functionList>
</NotepadPlus>

Yararlı makroları paylaşın

Tekrarlanabilir küçük bir düzenlemeyi kaydedin ve bir kopya üzerinde test edin. Makroya açıklayıcı bir ad verin ve makro kitaplığından yönetin. Yerel dışa aktarmalar sürümlendirilmiş JSON'yi kullanır; taşınabilir dışa aktarmalar, desteklenen eylem alt kümesi için shortcuts.xml kullanır.

Uygulama tarafından dışa aktarılan formatı koruyun. Dahili kimlikleri elle düzenlemeyin veya her eylemin profiller arasında hareket edebileceğini varsaymayın. Beklenen seçim modunu, giriş örneğini, çıktı örneğini ve uygulama sürümünü ekleyin. Çalıştırılamayan içe aktarılan kayıtlar, desteklendiği şeklinde duyurulmak yerine incelenmelidir.

Bir UDL kataloğu yayınlayın

Özel katalog, schemaVersion değeri 1 olan ve entries dizisi içeren bir JSON dosyasıdır. Her giriş benzersiz bir id, name, author, ham XML dosyasının HTTPS adresini içeren url ve lisans bilgisi taşır. İsteğe bağlı sha256, kaynağın 64 basamaklı SHA-256 özetini içerir.

Bu siteden indirilebilen katalog gerçek Elite Demo XML dosyasına bağlanır ve onun sağlama toplamını içerir. Kendi kataloğunuzu yayımlamak için girişi ve URL adresini kendi kaynağınızla değiştirin, düzenlemelerden sonra özeti yeniden hesaplayın ve her iki dosyayı HTTPS üzerinden sunun. Ardından katalog önizlemesini ve uygulamadaki kurulumu test edin.

{
  "schemaVersion": 1,
  "entries": [
    {
      "id": "elite-demo",
      "name": "Elite Demo",
      "author": "NotePad Elite",
      "url": "https://notepadelite.pages.dev/resources/Elite-Demo.xml",
      "license": "MIT",
      "sha256": "840e13fc62289ec0edf66a525370b30626d400a46e0fb559c4fb9e9c268f6fee"
    }
  ]
}

Projeleri ve oturumları paylaşın

Proje XML dosyası, dosya ve klasörlere yapılan başvuruları gruplandırır. Kök öğe olarak NotepadPlus, alt öğeler olarak name öznitelikli Project, Folder ve File kullanılır. Özel mutlak yollara dayanmak yerine yapıyı oluşturmak, içe ve dışa aktarmak için proje panelini kullanın.

Dışa aktarılan proje, belgelerin kopyalarını değil, referansları içerir. Yeni bir cihazda yolların nasıl eşleneceğini ve bir klasöre nasıl yetki verileceğini açıklayın. Paylaşılan oturumlardan kişisel yolları kaldırın, örnek bir klasör ekleyin ve özel belgeleri paketin dışında tutun.

Bir dil sunucusuna bağlanın

Kod zekası, TCP veya TLS üzerinden LSP kullanarak seçtiğiniz bir dil sunucusuna bağlanabilir. Ana bilgisayarı ve bağlantı noktasını yapılandırın, yerel proje klasörünü yetkilendirin ve sunucu farklı bir yol kullanıyorsa onun URI adresini eşleyin. Uygulama sizin için sunucuyu yüklemez veya başlatmaz.

Dil eylemleri talep ettiğinizde bağlantı, belge metnini ve yollarını bu sunucuya gönderebilir. Sunucunun kurulumunu, desteklenen dili, aktarım ve gizlilik uygulamalarını açıklayın. Yalnızca çevrimdışı sembol aramaya ihtiyaç duyduğunuzda yerel proje dizinini kullanın.

Çalışmanızı paketleyin ve paylaşın

Açıkça adlandırılmış bir kaynağı README, yazar, sürüm, lisans, desteklenen uygulama sürümleri, kurulum adımları ve küçük bir örnekle yayınlayın. Bir tema için ekran görüntüsü ve makrolar veya ayrıştırıcı kuralları için beklenen giriş/çıkış ekleyin.

Pakete eklediğiniz üçüncü taraf içeriklerini yeniden dağıtma hakkınız olduğunu kontrol edin. Kişisel yolları, kimlik bilgilerini ve özel belgeleri çıkarın. Bu web sitesi dokümantasyon ve indirilebilir başlangıç kaynakları sunar; kullanıcıların dosya yüklediği bir galeri değildir. Kendi deponuzu veya indirme URL adresinizi paylaşın ya da kaynak bağlantısını destek ekibine e-postayla gönderin.

1. İçe aktarmayı test edin, kaynağı seçin ve sağlanan örnek üzerindeki etkisini doğrulayın.
2. Aksanlı karakterler içeren metin ve boş bir dosyayla test edin; uzun adları ve açık/koyu kontrastı kontrol edin.
3. Nihai kaynağı uygulamadan dışarı aktarın, tüm sınırları belgeleyin ve bir değişiklik günlüğü ekleyin.
4. Diğer kullanıcıların ne yüklediklerini bilmesi için URL, lisans ve kaynak türünü paylaşın.