Documentație tehnică, ghid de utilizare și configurare a aplicației CodeNote pentru macOS
Autor: Marius Surdu
Coautor: Claude.ai
Suport: seotoolpro.ro/contact
Descarcă: seotoolpro.ro/download-apps
Versiune: 1.5 (2026)

Despre CodeNote

CodeNote este un editor de cod nativ pentru macOS, construit în SwiftUI, care oferă syntax highlighting pentru 20 de limbaje și formate de fișiere, fragmente rapide pentru dezvoltarea web, numerotare automată a liniilor și un sistem nativ de taburi pentru lucrul cu mai multe documente simultan.

Interfața este compactă și organizată clar: bara laterală verticală pentru acțiuni rapide, header cu taburi și selectorul de limbaj, bare contextuale pentru formatare (diferite în funcție de tipul documentului), zona de editare cu numerotare de linii și un footer cu statistici în timp real.

Începând cu versiunea 1.5, CodeNote are o fereastră de Setări (⌘,) cu alegerea temei Sistem / Luminos / Întunecat, un ghid integrat în aplicație și deschide fișierele fără să mai lase un tab „Document nou” gol alături de ele.

Implicit, aplicația urmărește tema sistemului (light sau dark), fără setări suplimentare.

Cerințe preliminare

Pentru a rula CodeNote este nevoie de un Mac cu macOS Sonoma (14) sau mai nou. Aplicația folosește framework-uri native Apple (SwiftUI, AppKit, WebKit) și nu necesită librării externe sau instalare suplimentară.

Nu este nevoie de conexiune la internet pentru funcționarea de bază. Toate operațiile se fac local, pe dispozitiv. Fișierele editate nu părăsesc niciodată Mac-ul. Conexiunea este folosită doar pentru verificarea actualizărilor.

Notă: pentru fontul recomandat (JetBrains Mono sau Geist Mono), fișierele .ttf/.otf trebuie incluse în bundle-ul aplicației, la secțiunea Copy Bundle Resources. Dacă nu sunt găsite, CodeNote folosește automat fontul monospaced al sistemului.

Limbaje suportate

Aplicația oferă syntax highlighting nativ pentru 20 de limbaje și formate de fișiere. Limbajul este detectat automat la deschiderea unui fișier, pe baza extensiei:

  • TXT — text simplu, formatare pe selecție (doar în sesiune)
  • NFO — fișiere de informații, cu suport pentru CP437 (ASCII art)
  • HTML — tag-uri, atribute, comentarii, CSS și JavaScript inline
  • CSS / SCSS / SASS / LESS — selectori, proprietăți, valori, at-rules
  • JavaScript / TypeScript — cuvinte cheie, funcții, template strings
  • PHP — tag-uri PHP, variabile, cuvinte cheie, comentarii
  • Python — cuvinte cheie, string-uri multi-linie, decoratori
  • Ruby — cuvinte cheie, simboluri, variabile de instanță
  • JSON — chei, valori, string-uri, numere
  • XML — tag-uri, atribute, comentarii
  • YAML — chei, valori, comentarii
  • Markdown — titluri, bold, italic, cod inline, link-uri
  • SQL — cuvinte cheie, șiruri, numere, comentarii
  • CSV — separare pe coloane, șiruri între ghilimele
  • RTF — formatare reală, salvată în fișier

Limbajul poate fi schimbat manual din meniul derulant din colțul dreapta-sus al ferestrei. La crearea unui document nou, aplicația detectează automat limbajul pe baza conținutului (HTML, PHP, JS, CSS, XML, SQL) la lipirea unui text.

Detectare automată
La lipirea unui text într-un document nou,
CodeNote analizează conținutul și alege limbajul
potrivit: HTML, PHP, JavaScript, CSS, XML, SQL,
sau TXT ca fallback.

Fragmente rapide

Bara orizontală de deasupra zonei de editare conține fragmente rapide, specifice limbajului activ. Fiecare fragment este reprezentat printr-o iconiță SF Symbols; la hover, un tooltip arată ce se inserează.

Fragmentele disponibile pentru HTML (17 la număr) acoperă elementele cele mai frecvente: Link, Line break, Comentariu, Imagine, Bold, Italic, Div, Span, Paragraf, Listă, Tabel, Formular, Input, Buton, Script, CSS și Template HTML5 complet.

Există seturi dedicate și pentru PHP, CSS/SCSS/SASS/LESS, JavaScript/TypeScript, SQL, Python și Markdown.

Wrap pe selecție

Dacă ai un text selectat în editor și apeși un buton de fragment, CodeNote înfășoară textul selectat în tag-urile fragmentului, în loc să-l șteargă. Comportamentul funcționează pentru toate fragmentele de tip „container”: Paragraf, Bold, Italic, Div, Span, Link, etc.

SelecțieApeșiRezultat
lumeParagraf<p>lume</p>
lumeBold<strong>lume</strong>
lumeLink<a href="">lume</a>
<a href="">gica</a>Bold<strong><a href="">gica</a></strong>
<strong>gica</strong>Bold (din nou)gica (toggle — scoate tag-urile)
Poziționare cursor: după aplicarea unui fragment, cursorul rămâne în poziția naturală — pe textul selectat (dacă a existat selecție), sau la locul marcat cu %%CURSOR%% în snippet (dacă nu a existat selecție).

Scurtături tastatură

CodeNote folosește scurtăturile standard macOS pentru editare, plus câteva specifice aplicației:

ScurtăturăAcțiune
⌘ + NTab nou
⌘ + ODeschide fișier
⌘ + SSalvează
⌘ + ⇧ + SSalvează ca…
⌘ + ZUndo
⌘ + ⇧ + ZRedo
⌘ + X / C / VTaie / Copiază / Lipește
⌘ + ⇧ + ⌥ + VLipește ca text simplu (curățat)
⌘ + ASelectează tot
⌘ + FCaută
⌘ + ⌥ + FCaută și înlocuiește
⌘ + GUrmătoarea potrivire
⌘ + ⇧ + GPotrivirea anterioară
⌘ + LSalt la linia…
⌘ + RPreview HTML (deschide fereastra popup)
⌘ + B / I / UBold / Italic / Subliniat (documente formatate)
⌘ + +Mărește textul
⌘ + −Micșorează textul
⌘ + 0Mărime normală (13 pt)
⌘ + scrollMărește / micșorează textul continuu
⌘ + ,Setări Nou
⌘ + ?Ghid CodeNote (acest manual) Nou

Mărimea textului este salvată automat și se aplică tuturor documentelor deschise ulterior.

Interfață & comenzi

Fereastra aplicației este împărțită în zone distincte, fiecare cu un rol clar:

  • Bara laterală verticală (stânga) — butoane rapide pentru document și căutare; rotița din partea de jos deschide fereastra de Setări
  • Header — taburi pentru documente deschise, buton Run (pentru HTML), buton „Paste curat”, toggle wrap, salt la linie, selector de limbaj
  • Bara contextuală — diferă în funcție de tipul documentului: cod (formatare + snippets + unelte pe linii), text (formatare rich-text în sesiune), RTF (formatare completă salvată în fișier)
  • Zona de editare — editorul propriu-zis, cu numerotare de linii, syntax highlighting, evidențiere liniei curente și suport pentru undo/redo
  • Footer — statistici în timp real: poziția cursorului, număr de cuvinte, linii, caractere, codare, limbaj

Textul folosește fontul monospaced al sistemului sau unul dintre fonturile recomandate (JetBrains Mono, Geist Mono) dacă sunt disponibile.

Fiecare tab are propriul state (poziția cursorului, scroll, selecție), astfel încât trecerea între documente păstrează contextul intact.

Paste curat

Butonul Paste curat (sau ⌘ + ⇧ + ⌥ + V) lipește doar textul, fără formatarea sursei: elimină caracterele invizibile și spațiile ciudate, normalizează sfârșiturile de linie și taie spațiile de la capătul liniilor (în afară de Markdown). În documentele de cod, ghilimelele „inteligente” devin ghilimele drepte.

Căutare și înlocuire

⌘ + F deschide bara de căutare (numărul de rezultate apare în câmp, căutarea ignoră majusculele). ⌘ + ⌥ + F adaugă câmpul de înlocuire, cu Înlocuiește și Înlocuiește tot. Esc închide bara.

Contact
Website: seotoolpro.ro
Descarcă: seotoolpro.ro/download-apps
Contact: seotoolpro.ro/contact

Taburi, salvare & deschidere fișiere

CodeNote lucrează cu taburi: fiecare document are tabul lui în header. Un punct violet lângă nume arată că documentul are modificări nesalvate. La închiderea unui tab modificat, aplicația întreabă dacă vrei să salvezi.

Fișierele sunt salvate cu extensia corespunzătoare limbajului selectat, iar la deschidere limbajul este detectat automat pe baza extensiei.

Extensiile suportate includ: txt, nfo, html, htm, css, scss, sass, less, js, mjs, ts, php, py, rb, sql, json, xml, yaml, yml, md, csv, rtf. Fișierele doc și docx se deschid ca text simplu, fără formatarea originală.

Dacă extensia nu corespunde unui limbaj cunoscut, se folosește TXT ca fallback. Poți schimba manual limbajul oricând din selectorul din header, fără să afectezi conținutul.

Deschiderea unui fișier Nou în v1.5

Când deschizi un fișier (⌘ + O, din Finder sau prin „Deschide cu CodeNote”) și singurul tab existent este un „Document nou” gol și nemodificat, fișierul îi ia locul. În header apare doar documentul tău, nu și un tab gol alături de el.

SituațieRezultat
Tab „Document nou” gol + deschizi un fișierFișierul înlocuiește tabul gol
Ai scris ceva în „Document nou” + deschizi un fișierFișierul se deschide într-un tab nou; textul tău rămâne
Deschizi mai multe fișiere deodatăPrimul înlocuiește tabul gol, restul primesc taburi separate
Fișierul este deja deschisCodeNote trece pe tabul existent, fără duplicate

Un fișier deschis din Finder când CodeNote rulează deja ajunge în fereastra existentă, nu într-o fereastră nouă.

Preview HTML

Pentru documentele HTML, CodeNote include un preview nativ — o fereastră popup care randează pagina direct în interiorul aplicației, folosind WKWebView. Nu se deschide niciun tab în browser, nu se creează fișiere temporare, nu se acumulează ferestre.

Cum funcționează

  • Apeși ⌘R (sau butonul Run din header)
  • Se deschide o fereastră popup cu HTML-ul randat
  • Modifici codul → apeși ⌘R din nou → aceeași fereastră se actualizează, se aduce în față
  • Închizi fereastra → următoarea apăsare ⌘R creează una nouă

Ce suportă preview-ul

FeatureStatus
HTML + CSS✅ complet
JavaScript inline✅ complet
DOM manipulation, event handlers✅ complet
setTimeout, setInterval✅ complet
<canvas>, WebGL✅ complet
Media queries (light/dark)✅ forțat light mode pentru consistență cu browserul
Poziție & dimensiune fereastră✅ salvate automat

Aspect vizual

Fereastra de preview forțează light mode, indiferent de tema aplicației. Astfel, pagina HTML se randează identic cu browserul real, cu fundal alb și text negru. Proprietatea CSS prefers-color-scheme returnează light în preview.

Sfat: fereastra își salvează poziția și dimensiunea automat. Ajusteaz-o o dată (mai lată, mai înaltă), și se va redeschide mereu cu aceleași dimensiuni.

Formatare text & cod

CodeNote oferă trei moduri de formatare, în funcție de tipul documentului:

Documente de cod (HTML, CSS, JS, PHP, SQL, JSON etc.)

Bara contextuală include acțiuni de formatare pentru limbajul activ: Formatează (indentează) și Minify (comprimă), disponibile pentru HTML, XML, CSS, JavaScript, TypeScript, JSON și SQL. Pentru JSON există și butonul Validează, care arată dacă documentul este valid și unde este eroarea.

Meniul Linii oferă unelte pe linii: sortare A→Z / Z→A, deduplicare, eliminare linii goale, tăiere spații de la sfârșit.

Documente .txt

Formatare rich-text (bold, italic, subliniat, aliniere, mărime font) care se aplică pe selecție sau pe tot documentul. Formatarea este vizibilă în sesiunea curentă dar nu se salvează în fișier (TXT nu suportă formatare). Include și acțiunea Beautify — curăță textul, pune o linie goală între paragrafe și aliniază justify.

Documente .rtf

Formatare completă, salvată efectiv în fișier: font, mărime, bold, italic, subliniat, tăiat, culoare text, aliniere.

Comportament „pe selecție sau pe tot”: dacă ai text selectat, formatarea se aplică doar pe selecție. Dacă nu ai nimic selectat, se aplică pe întregul document.
Vrei să păstrezi formatarea? Un fișier .txt conține doar text. Comută documentul pe RTF din selectorul de limbaj și salvează ca .rtf.

Setări & temă Nou în v1.5

Setările se deschid cu ⌘ + ,, din meniul CodeNote ▸ Setări… sau cu rotița din bara laterală. Fereastra are trei secțiuni:

Aspect

Trei carduri cu previzualizare, pentru alegerea temei:

TemăComportament
SistemUrmărește automat setarea macOS (light / dark). Valoarea implicită.
LuminosForțează tema deschisă, indiferent de sistem
ÎntunecatForțează tema întunecată, indiferent de sistem

Tema se aplică imediat, în toată aplicația: editor, bare, numere de linii, ferestre de dialog și setări. Revenirea la Sistem readuce corect aspectul macOS.

Editor

  • Mărime font — de la 8 la 40 pt
  • Încadrare text (wrap) — liniile lungi se rup la marginea ferestrei
  • Numerotare linii — afișează sau ascunde coloana cu numere
  • Evidențiază linia curentă — fundal discret pe linia cu cursorul
  • Resetează setările — readuce toate valorile la cele implicite

Despre

Versiunea aplicației, link-uri către descărcare și contact, butonul Verifică actualizări și butonul Ghid de utilizare (acest manual).

Ghid integrat: manualul se deschide și din meniul Ajutor ▸ Ghid CodeNote (⌘ + ?), într-o fereastră proprie. Setările se păstrează între porniri și se aplică tuturor documentelor.

Noutăți în versiunea 1.5

Modificări față de versiunea 1.4

  • Fără tab „Document nou” în plus — deschiderea unui fișier înlocuiește tabul gol și nemodificat, în loc să-l lase alături de document
  • Fereastră de Setări (⌘,) — secțiuni Aspect, Editor și Despre, în stilul celorlalte aplicații SeoToolPro
  • Alegerea temei — Sistem / Luminos / Întunecat, cu carduri de previzualizare
  • Tema la nivel de aplicație — „Sistem” revine corect la setarea macOS după ce ai folosit Luminos sau Întunecat
  • Ghid integrat — manualul se deschide din aplicație (Ajutor ▸ Ghid CodeNote, ⌘?)
  • Fișiere din Finder în fereastra existentă — nu se mai deschide o fereastră nouă pentru fiecare fișier
  • Resetare setări — buton dedicat pentru valorile implicite
  • Bara laterală — rotița deschide fereastra de Setări, în loc de meniul mic de mai înainte
Notă: toate funcționalitățile din versiunile anterioare (syntax highlighting pentru 20 de limbaje, preview HTML, wrap pe selecție, numerotare linii, statistici în timp real, paste curat, detectare automată a limbajului) sunt păstrate neschimbate în v1.5.
Versiune: 1.5 (2026) Generat cu seotoolpro.ro
↑