අන්තර්ගතයට යන්න
Chapters
  1. Omarchy වෙත සාදරයෙන් පිළිගනිමු!
  2. ආරම්භය
  3. Mac හෝ Windows වලින් එන විට
  4. සංචලනය
  5. ඉහළ තීරුව
  6. තේමා
  7. ඉක්මන් යතුරු
  8. ඒකාබද්ධ පසුරුපුවරුව සහ ඉතිහාසය
  9. මතක්කිරීම්
  10. දැනුම්දීම්
  11. පෙළ උපුටා ගැනීම සහ උච්චාරණය
  12. තිරරූප සහ පටිගත කිරීම
  13. ටොගල්, අක්‍රියතාව සහ තිර සුරැකුම
  14. Omarchy CLI
  15. ටර්මිනලය
  16. Neovim
  17. AI
  18. සංවර්ධන මෙවලම්
  19. ෂෙල් මෙවලම්
  20. ෂෙල් ශ්‍රිත
  21. TUIs
  22. GUI යෙදුම්
  23. බ්‍රවුසරයන්
  24. වාණිජ යෙදුම්/සේවා
  25. වෙබ් යෙදුම්
  26. ක්‍රීඩා
  27. PDF පුරවාලීම
  28. Windows VM
  29. වෙනත් පැකේජයන්
  30. යාවත්කාලීන කිරීම්
  31. ඩොට්ගොනු
  32. ෂෙල් ප්ලගින
  33. මොනිටර
  34. යතුරුපුවරුව, මූසිකය, Trackpad
  35. ජාලකරණය
  36. පද්ධති නිද්‍රාව
  37. දෘඪාංග සත්‍යාපනය
  38. අකුරු
  39. පසුබිම්
  40. ප්‍රොම්ප්ටය
  41. සන්නාමකරණය
  42. පොදු ගැලපීම්
  43. ඔබේම තේමාවක් සෑදීම
  44. Mac සහාය
  45. දෝශ නිරාකරණය
  46. නිතර අසන ප්‍රශ්න
  47. පද්ධති ස්නැප්ෂොට්
  48. ආරක්ෂාව
  49. Omarchy ...මත
  50. Dual Boot ස්ථාපනය
  51. කිසිවෙකු සහභාගී නොවන ස්ථාපනයන්

අත්පොත

ෂෙල් ප්ලගින

Omarchy ඩෙස්ක්ටොප් එක omarchy-shell නම් තනි දිගුකාලීන Quickshell ක්‍රියාවලියක් ලෙස ක්‍රියාත්මක වන අතර, ඔබට තිරය මත දකින සියල්ල පාහේ එහි ඇතුළත ප්ලගින එකකි. තීරුව ප්ලගින එකකි. එයින් පහළට වැටෙන පැනලයන්, ඉමෝජි තේරීම සහ පසුරු කළමනාකරු වැනි සම්පූර්ණතිර අතිශයයන්, Omarchy මෙනුවම, අගුලු තිරය, polkit සංවාදය, සහ ඔබේ බැටරිය නරඹා රාත්‍රියේ ඔබේ තිරය උණුසුම් කරන හිස නොමැති සේවාවන්ද එසේමය.

එය ක්‍රියාත්මක කිරීමේ විස්තරයක් පමණක් නොවේ. එයින් අදහස් වන්නේ ඔබට ඩෙස්ක්ටොප් එකේ කැබලි අක්‍රීය කිරීමට, ඒවා මාරු කිරීමට, නැතහොත් Omarchy හි මූලාශ්‍රයේ එක රේඛාවකටවත් අත නොතබා ඔබටම ලිවිය හැකි බවයි.

පළමු-පාර්ශවීය ප්ලගින Omarchy සමඟ පැමිණ $OMARCHY_PATH/shell/plugins/ තුළ ජීවත් වේ. ඔබ විසින්ම එකතු කරන ඕනෑම දෙයක් - ඔබේම අත්හදා බැලීම්, නැතහොත් ඔබට GitHub එකේ හමු වූ දෙයක් - ~/.config/omarchy/plugins/ තුළ ජීවත් වේ. දෙකම ආරම්භයේදී එ ලෙසම සොයාගනු ලැබේ, නමුත් ගොඩනැගූ ඒවාට විශ්වාසදායක ෂෙල් අතුරුමුහුණත් ලැබෙන අතර තෙවන-පාර්ශවීය ප්ලගිනවලට ඒවායේම සේවාව සහ ජීවන පාදකයට සීමා කර සීමාසහිත අතුරුමුහනතක් ලැබේ. ගොඩනැගූ ඒවායේ ක්ලෝන රඳවාගන්නේ මුල් හැසිරීම සඳහා අවශ්‍ය වන මූලාශ්‍ර-නිශ්චිත වින්‍යාසය සහ UI ඇමතුම් පමණි.

ඔබ සතු දේ බැලීම

omarchy plugin list

එය සොයාගත් සෑම ප්ලගිනයක්ම එහි id එක, එය සක්‍රීය කර ඇත්දැයි, එය පළමු-පාර්ශවීයද තෙවන-පාර්ශවීයදැයි, එහි වර්ග, සහ එහි සංදර්ශන නාමය සමඟ මුද්‍රණය කරයි. ඔබ එය වෙනත් දෙයකට පෝෂණය කරන්නේ නම් --json එකතු කරන්න.

ප්ලගින id නාම අවකාශයට අයත්ය. ගොඩනැගූ ඒවා සියල්ල omarchy. සමඟ අරඹයි - omarchy.clock, omarchy.network, omarchy.notifications - සහ එම නාම අවකාශය රක්ෂිත බැවින්, තෙවන-පාර්ශවීය ප්ලගිනුවකට කිසි විටෙකත් එයට හිමිකම් කියිය නොහැක.

ඒවා සක්‍රීය කිරීම සහ අක්‍රීය කිරීම

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

නැතහොත් මෙනුව භාවිතා කරන්න: සැකසුම > ප්ලගින හි සක්‍රීය කරන්න, අක්‍රීය කරන්න, එක් කරන්න, ක්ලෝන කරන්න, සහ ඉවත් කරන්න යන්නේ, එක් එක් එම ක්‍රියාව සඳහා තේරුම් ගත හැකි ප්ලගින පමණක් ලබාදෙන තේරීමක් සමඟ ඇත.

සක්‍රීය කළ තත්ත්වය ~/.config/omarchy/shell.json තුළ ගබඩා කරනු ලබන අතර, ප්ලගින වර්ග දෙක සඳහා නීතිය මදක් වෙනස් වේ. තෙවන-පාර්ශවීය ප්ලගින එකක් එහි id එක එම ගොනුවේ කොතැනක හෝ දිස්වන විට හරියටම සක්‍රීය වේ - තීරු පිරිසැලසුම් ඇතුළත් කිරීමක් ලෙස, plugins[] හි ඇතුළත් කිරීමක් ලෙස, නැතහොත් bar.id ලෙස. තීරු විජෙට් නොවන පළමු-පාර්ශවීය ප්ලගින අනෙක් අතටය: ඒවා පෙරනිමියෙන් සක්‍රීය අතර අක්‍රීය වන්නේ disabledPlugins[] හි ලැයිස්තුගත කිරීමෙන් පමණි.

සම්පූර්ණ තීරු ප්ලගිනුවකට කිසිසේත් අක්‍රීය තත්ත්වයක් නැත. සෑම විටම හරියටම එක් තීරුවක් ඇති බැවින්, ඔබ එය තව එකක් සක්‍රීය කිරීමෙන් ආදේශ කරයි. තීරු විජෙට් නිවැහිල්ල ඉහළ තීරුව තුළ ආවරණය වේ.

git වෙතින් ප්ලගින එකක් එකතු කිරීම

තෙවන-පාර්ශවීය ප්ලගින එකක් යනු එහි මූලයේ manifest.json එකක් ඇති git ගබඩාවක් පමණි.

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

එය යමක් කිරීමට පෙර, ප්ලගින ඔබේ දිගුකාලීන ෂෙල් ක්‍රියාවලිය තුළ අයනික, අනුපාතය අඩු කළ කේතය ලෙස ක්‍රියා කරන බව එය පැහැදිලිවම ඔබට පවසයි, URL එක පෙන්වයි, සහ ඔබට තහවුරු කිරීමට සෑය. එය බරපතලව ගන්න. තෙවන-පාර්ශවීය ප්ලගින අතුරුමුහුණත සත්‍යාපන සේවා සෘජුවම හෙළි නොකරයි, සහ ආදේශක තීරුවකට වින්‍යාස කළ සත්‍යාපන-නොවන UI සඳහා පමණක් සීමාසහිත හැකියාවන් ලැබේ. දෘශ්‍ය ප්ලගින තවමත් ෂෙලයේ QML දර්ශනය බෙදාගැනී සාමාන්‍ය දෙමව්පිය විවෙක වලට ඇවිදිය හැකි වන අතර, සෑම ප්ලගින කේතයක්ම ඔබේ පරිශීලක ගිණුමට ළඟා විය හැකි සියල්ල සමඟ ධාවනය වේ. සත්‍යාපන තත්ත්වය ළඟා විය හැකි ධාරක වස්තු ප්‍රස්ථාරයෙන් පිටත එම සේවාවන් තැබීමෙන් වෙනම ආරක්ෂා වේ. ඔබ ධාවනය කිරීමට කැමති ගබඩාවන් පමණක් එක් කරන්න, සහ ඔබ ඒවා සක්‍රීය කිරීමට පෙර ඒවා කියවන්න.

ආදේශක තීරුවකට ස්ථාපිත විජෙට් විදහා දැක්විය හැක, නමුත් තීරුවට වෙනත් ප්ලගිනුවක සජීවී සේවා වස්තුවක් ඉල්ලීමට අවසර නොමැති බැවින් සේවා-බන්ධනය කළ තෙවන-පාර්ශවීය විජෙට් වලට අඩු ධාරණ අනුවාදයෙන් ක්‍රියාකාරිත්වය අඩු විය හැක. එවැනි විජෙට් එකකට එහි සහායක සේවාව අවශ්‍ය නම් ගොඩනැගූ omarchy.bar එකට ආපසු මාරු වන්න.

ඉන්පසු එය ගබඩාව වේදිකා නාමාවලියකට ක්ලෝන කරයි, මැනිෆෙස්ට් එක වලංගු කරයි, වෙනත් ප්ලගිනුවක් දැනටමත් එම id එකට හිමිකම් කියන්නේ නම් ස්ථාපනය ප්‍රතික්ෂේප කරයි, සහ එය ~/.config/omarchy/plugins/<id>/ වෙත ගෙන යයි. --enable නොමැතිව එය දැන් එය සක්‍රීය කිරීමට ඔබට අවශ්‍යදැයි අසයි, ඔබට නැහැ කියා පළමුව කේතය කියවීමට යා හැක. එය කිසි විටෙකත් ප්ලගිනෙහි කිසිවක් ක්‍රියාත්මක නොකරයි, කිසිවිට ස්ථාපනය කොකුවක් ක්‍රියාත්මක නොකරයි, සහ කිසි විටෙකත් sudo නොඅසනු ඇත - එය ගොනු ක්ලෝන කරයි, මැනිෆෙස්ට් එක පරීක්ෂා කරයි, සහ IPC හරහා කොඩියක් පෙරළයි.

යාවත්කාලීන කිරීම යනු එම එකම පිටපතේම වේගවත්-ඉදිරියට අදින්න කිරීමකි:

omarchy plugin update acme.weather
omarchy plugin update

id එකක් නොමැතිවිට එය ඔබ සතු git-කළමනාකරණය කරනු ලබන සෑම ප්ලගිනුවක්ම යාවත්කාලීන කරයි. එය යෙදීමට පෙර ඔබට වෙනස්කම පෙන්වයි, එය අභිබවනය කළ නොහැකි දේශීය වෙනස්කම් ඔබට ඇත්නම් යාවත්කාලීනයන් ප්‍රතික්ෂේප කරයි, සහ නව නිකුතුව වලංගුභාවය අසමත් නම් ආපසු හරවනු ලැබේ.

omarchy plugin remove acme.weather

ඉවත් කිරීම පළමුව ප්ලගින එක අක්‍රීය කරයි, ඉන්පසු එය git පිටපතක් නම් මකාදමනු ලැබේ (ගබඩාව තවමත් ඉහළට ඇත) නැතහොත් එය අනුලකුණු සබැඳියක් නම් එය ගලවනු ලැබේ. git ගබඩාවක් නොමැති අතින් සාදන ලද ප්ලගින නාමාවලියක් සෘජුවම මකා දැමීම වෙනුවට ප්ලගින නාමාවලිය තුළ කාල මුද්‍රණය කළ උපස්ථයකට ගෙනෙනු ඇත.

එය වෙනස් කිරීමට ගොඩනැගූ එකක් ක්ලෝන කිරීම

මෙය මගේ ප්‍රියතම කොටසයි. ඔබට ගොඩනැගූ විජෙට් එකක් හැසිරෙන ආකාරය වෙනස් කිරීමට අවශ්‍ය නම්, $OMARCHY_PATH යටතේ ඇති ගොනු සංස්කරණය නොකරන්න - ඒවා පැකේජයට අයත් වන අතර ඊළඟ යාවත්කාලීනය එවා අවලංගු කරනු ඇත. ඒ වෙනුවට එය ක්ලෝන කරන්න:

omarchy plugin clone omarchy.clock

එය සම්පූර්ණ ප්ලගින එක ~/.config/omarchy/plugins/dhh.clock එකට පිටපත් කරන ලදී (ඔබේ පරිශීලක නාමය, මගේ නොවේ), එය “My Clock” ලෙස නම් කරයි, එය සක්‍රීය කරයි, සහ ෂෙලය ගොඩනැගූ එකෙන් ඔබේ පිටපතට මාරු කරයි - පවතින තීරු විජෙට් එකක පිහිටුම සහ සැකසීම් තබාගන්නා ගමන්. නව නාමාවලිය ඔබේ $EDITOR එක තුළ වහාම විවෘත කිරීමට --edit එකතු කරන්න, එය මෙනුවේ සැකසුම > ප්ලගින > ප්ලගිනුව ක්ලෝන කරන්න ඔබ වෙනුවෙන් සිදු කරන දේයි.

පරිශීලක නාම උපසර්ගය ඔබේ ක්ලෝනයේ id එක ඔබේම බවට තබාගනී, එබැවින් එය බෙදාගැනීම වෙනත් ඕනෑමෙකුගේ දෙයක් සමඟ ගැටීමක් සිදු නොවේ. මුල් ගොඩනැගූ id එකට සිදුකරන ඇමතුම් ඔබේ ක්ලෝනයට යොමු වනු ඇත, එබැවින් omarchy.clock ගැන සඳහන් කළ කිසිවක් යාවත්කාලීන කිරීමට අවශ්‍ය නැත. ඔබ එය අවුල් කරන්නේ නම්, omarchy plugin remove dhh.clock ගොඩනැගූ එක නැවත ගෙන එයි.

~/.config/omarchy/plugins/ යටතේ ඕනෑම තැනක ගොනුවක් සුරැකීම ස්වයංක්‍රීයව ප්ලගින කේතය නැවත පූරණය කරන බැවින්, ඔබට සංස්කාරකය විවෘතව තබා ඔබේ වෙනස්කම් නතර වන ආකාරය බැලිය හැක.

ඔබේම ඒවා ලිවීම

ප්ලගිනුවක් යනු manifest.json එකක් සහ QML ටිකක් සහිත නාමාවලියකි. මැනිෆෙස්ට් එක schemaVersion: 1, id එකක්, name, version, එක් හෝ වැඩි kinds, සහ සෑම වර්ගයක් සඳහාම QML ගොනුවට යොමු කරන entryPoints වස්තුවක් ප්‍රකාශ කරයි:

Kind What it is
bar-widget ක්‍රියාකාරී තීරුවකට කොටසකට දැමිය හැකි සංරචකයක්
panel ස්ථිර හෝ කැඳවනු ලැබූ උපයෝගී කවුළුවක්
overlay සම්පූර්ණ තිර අතිශයය
menu කැඳවනු ලැබූ මෙනූ මතුපිටක්
service UI නොමැති හිස නොමැති තනි ඩෙයක්
bar ගොඩනැගූ එක ආදේශ කරන සම්පූර්ණ තීරුවක්

ප්ලගිනුවකට එකවර වර්ග කිහිපයක් ප්‍රකාශ කළ හැක - මාධ්‍ය ප්ලගිනුව service එකක් සහ bar-widget එකක් යන දෙකම වේ. තීරු විජෙට්වලට එක්ස්ට්‍රා barWidget බ්ලොක් එකක් ලැබෙන අතර එය සංදර්ශන නාමය, ප්‍රවර්ගය, වාචික defaultSection එකක්, සහ allowMultiple ඇතුළත් වේ, එය තීරුවේ එකකට වැඩි ගණනක් තිබීම අර්ථවත්දැයි පැවසීමයි. බොහෝ විජෙට් එය false ලෙස සැකසයි; ස්පේසර් සහ දර්ශක එය true ලෙස සැකසයි.

ඔබ යමක් ප්‍රකාශනය කිරීමට පෙර, එය පරීක්ෂා කරන්න:

omarchy plugin validate ./my-plugin

එය ෂෙලය පූරණය කිරීමේදී කරන පරීක්ෂාවන්ම පවත්වාගෙන යයි: යෝජනා අනුවාදය, අවශ්‍ය ක්ෂේත්‍ර, රක්ෂිත නොවන id එක, ආරක්ෂිත සාපේක්ෂ මාර්ග සහ සැබවින්ම පවතින ඇතුළු වීමේ ලක්ෂ්‍ය, ඔබ හිමිකම් පෑ සෑම වර්ගයක් සඳහාම ඇතුළු වීමේ ලක්ෂ්‍යයක්, සහ නාමාවලිය ඇතුළත කොහේකවත් අනුලකුණු සබැඳි නැත.

ප්ලගින සංවර්ධනය සඳහා, ෂෙල් යොමුව සහ පළමු-පාර්ශවීය ප්ලගින නාමවාලිය බලන්න.

ඔබේ ඒවා ලෝකය සමඟ බෙදාගැනීම

ඔබ ඔබට කැමති යමක් සාදා ඇති නමුත් සැටින් පසුව, එය පොදු git ගබඩාවක දාන්න. එය සම්පූර්ණ බෙදාහැරීමේ යාන්ත්‍රණයයි - එවිට ඕනෑම කෙනෙකුට ඔබේ URL එකට එරෙහිව omarchy plugin add ක්‍රියාත්මක කර තත්පර ගණනින් එය ධාවනය කළ හැක.

මිනිසුන්ට එය සැබවින්ම සොයාගැනීමට උපකාර කිරීමට, එය plugins.omarchy.org හි ලැයිස්තුගත කරන්න. එය Omarchy ෂෙල් ප්ලගින සඳහා වෙළඳපොළ වන අතර, ඔබ ලිවීමට සිටින විජෙට් එක දැනටමත් යමෙකු ගොඩනගා ඇත්දැයි කල්පනා කරන විට බැලීමට පළමු ස්ථානය එයයි. ඔබ ආරම්භයට පෙර එය පිරික්සන්න!