From bfabaa50bc6a6f078fd70a3c1053b51bb721ac97 Mon Sep 17 00:00:00 2001 From: Lea Anthony Date: Mon, 18 Mar 2024 21:52:39 +1100 Subject: [PATCH] Add Cymraeg --- mkdocs-website/docs/cy/API/application.md | 141 ++++++++ .../docs/cy/API/application_dialogs.md | 67 ++++ .../docs/cy/API/application_events.md | 13 + .../docs/cy/API/application_menu.md | 27 ++ .../docs/cy/API/application_screens.md | 13 + .../docs/cy/API/application_window.md | 64 ++++ mkdocs-website/docs/cy/API/mainthread.md | 50 +++ mkdocs-website/docs/cy/API/menu.md | 73 ++++ mkdocs-website/docs/cy/API/systray.md | 104 ++++++ mkdocs-website/docs/cy/API/window.md | 116 +++++++ mkdocs-website/docs/cy/changelog.md | 55 +++ mkdocs-website/docs/cy/development/changes.md | 20 ++ .../docs/cy/development/changes_bindings.md | 87 +++++ .../docs/cy/development/changes_clipboard.md | 3 + .../cy/development/changes_context_menus.md | 18 + .../docs/cy/development/changes_dialogs.md | 25 ++ .../docs/cy/development/changes_dragndrop.md | 8 + .../docs/cy/development/changes_enums.md | 41 +++ .../docs/cy/development/changes_events.md | 39 +++ .../docs/cy/development/changes_logging.md | 6 + .../docs/cy/development/changes_misc.md | 41 +++ .../docs/cy/development/changes_plugins.md | 33 ++ .../docs/cy/development/changes_systray.md | 8 + .../docs/cy/development/changes_window.md | 27 ++ .../docs/cy/development/changes_wml.md | 50 +++ .../docs/cy/development/introduction.md | 220 ++++++++++++ mkdocs-website/docs/cy/development/status.md | 215 ++++++++++++ .../docs/cy/getting-started/feedback.md | 66 ++++ .../docs/cy/getting-started/installation.md | 81 +++++ .../docs/cy/getting-started/next-steps.md | 20 ++ .../docs/cy/getting-started/your-first-app.md | 83 +++++ mkdocs-website/docs/cy/index.md | 37 ++ mkdocs-website/docs/cy/learn/runtime.md | 52 +++ mkdocs-website/docs/cy/roadmap.md | 198 +++++++++++ mkdocs-website/docs/cy/whats-new.md | 317 ++++++++++++++++++ mkdocs-website/generate/claude/go.mod | 3 + mkdocs-website/generate/claude/translate.go | 185 ++++++++++ mkdocs-website/mkdocs.yml | 107 ++---- .../overrides/partials/languages/cy.html | 60 ++++ 39 files changed, 2703 insertions(+), 70 deletions(-) create mode 100644 mkdocs-website/docs/cy/API/application.md create mode 100644 mkdocs-website/docs/cy/API/application_dialogs.md create mode 100644 mkdocs-website/docs/cy/API/application_events.md create mode 100644 mkdocs-website/docs/cy/API/application_menu.md create mode 100644 mkdocs-website/docs/cy/API/application_screens.md create mode 100644 mkdocs-website/docs/cy/API/application_window.md create mode 100644 mkdocs-website/docs/cy/API/mainthread.md create mode 100644 mkdocs-website/docs/cy/API/menu.md create mode 100644 mkdocs-website/docs/cy/API/systray.md create mode 100644 mkdocs-website/docs/cy/API/window.md create mode 100644 mkdocs-website/docs/cy/changelog.md create mode 100644 mkdocs-website/docs/cy/development/changes.md create mode 100644 mkdocs-website/docs/cy/development/changes_bindings.md create mode 100644 mkdocs-website/docs/cy/development/changes_clipboard.md create mode 100644 mkdocs-website/docs/cy/development/changes_context_menus.md create mode 100644 mkdocs-website/docs/cy/development/changes_dialogs.md create mode 100644 mkdocs-website/docs/cy/development/changes_dragndrop.md create mode 100644 mkdocs-website/docs/cy/development/changes_enums.md create mode 100644 mkdocs-website/docs/cy/development/changes_events.md create mode 100644 mkdocs-website/docs/cy/development/changes_logging.md create mode 100644 mkdocs-website/docs/cy/development/changes_misc.md create mode 100644 mkdocs-website/docs/cy/development/changes_plugins.md create mode 100644 mkdocs-website/docs/cy/development/changes_systray.md create mode 100644 mkdocs-website/docs/cy/development/changes_window.md create mode 100644 mkdocs-website/docs/cy/development/changes_wml.md create mode 100644 mkdocs-website/docs/cy/development/introduction.md create mode 100644 mkdocs-website/docs/cy/development/status.md create mode 100644 mkdocs-website/docs/cy/getting-started/feedback.md create mode 100644 mkdocs-website/docs/cy/getting-started/installation.md create mode 100644 mkdocs-website/docs/cy/getting-started/next-steps.md create mode 100644 mkdocs-website/docs/cy/getting-started/your-first-app.md create mode 100644 mkdocs-website/docs/cy/index.md create mode 100644 mkdocs-website/docs/cy/learn/runtime.md create mode 100644 mkdocs-website/docs/cy/roadmap.md create mode 100644 mkdocs-website/docs/cy/whats-new.md create mode 100644 mkdocs-website/generate/claude/go.mod create mode 100644 mkdocs-website/generate/claude/translate.go create mode 100644 mkdocs-website/overrides/partials/languages/cy.html diff --git a/mkdocs-website/docs/cy/API/application.md b/mkdocs-website/docs/cy/API/application.md new file mode 100644 index 000000000..f193672aa --- /dev/null +++ b/mkdocs-website/docs/cy/API/application.md @@ -0,0 +1,141 @@ +# Cais + +Mae'r API cais yn cynorthwyo i greu cais gan ddefnyddio fframwaith Wails. + +### Newydd + +API: `New(appOptions Options) *App` + +`New(appOptions Options)` yn creu cais newydd gan ddefnyddio'r opsiynau cais a ddarperir. Mae'n cymhwyso gwerthoedd rhagosodedig ar gyfer opsiynau heb eu pennu, yn eu cyfuno â'r rhai a ddarparwyd, yn eu cychwyn a'n dychwelyd enghraifft o'r cais. + +Os bydd gwall yn ystod y cychwyn, caiff y cais ei atal gyda'r neges gwall a ddarperir. + +Dylid nodi, os oes enghraifft gyffredinol o gais yn bodoli eisoes, y bydd yr enghraifft honno'n cael ei dychwelyd yn hytrach na chreu un newydd. + +```go title="main.go" hl_lines="6-9" +package main + +import "github.com/wailsapp/wails/v3/pkg/application" + +func main() { + app := application.New(application.Options{ + Name: "Demo Ffenestr Gweddarlunydd", + // Opsiynau eraill + }) + + // Gweddill y cais +} +``` + +### Cael + +`Get()` yn dychwelyd yr enghraifft gyffredinol o'r cais. Mae'n ddefnyddiol pan fydd angen mynediad i'r cais o wahanol rannau o'ch cod. + +```go + // Cael enghraifft o'r cais + app := application.Get() +``` + +### Galluoedd + +API: `Capabilities() capabilities.Capabilities` + +`Capabilities()` yn adfer map o'r galluoedd sydd gan y cais ar hyn o bryd. Gall y galluoedd fod ynghylch y nodweddion gwahanol y system weithredu sy'n darparu, fel nodweddion gweddarlunydd. + +```go + // Cael galluoedd y cais + capabilities := app.Capabilities() + if capabilities.HasNativeDrag { + // Gwneud rhywbeth + } +``` + +### GetPID + +API: `GetPID() int` + +`GetPID()` yn dychwelyd ID y Broses y cais. + +```go + pid := app.GetPID() +``` + +### Rhedeg + +API: `Run() error` + +`Run()` yn dechrau gweithredu'r cais a'i gydrannau. + +```go + app := application.New(application.Options{ + //options + }) + // Rhedeg y cais + err := application.Run() + if err != nil { + // Ymdrin â'r gwall + } +``` + +### Gadael + +API: `Quit()` + +`Quit()` yn gadael y cais trwy ddinistrio ffenestri a rhai cydrannau eraill o bosibl. + +```go + // Gadael y cais + app.Quit() +``` + +### AydunDdyryslyd + +API: `IsDarkMode() bool` + +`IsDarkMode()` yn gwirio a yw'r cais yn rhedeg mewn modd tywyll. Mae'n dychwelyd gwerth boolean yn nodi a yw'r modd tywyll wedi'i alluogi. + +```go + // Gwiriwch a yw'r modd tywyll wedi'i alluogi + if app.IsDarkMode() { + // Gwneud rhywbeth + } +``` + +### Cuddio + +API: `Hide()` + +`Hide()` yn cuddio ffenestr y cais. + +```go + // Cuddio ffenestr y cais + app.Hide() +``` + +### Dangos + +API: `Show()` + +`Show()` yn dangos ffenestr y cais. + +```go + // Dangos ffenestr y cais + app.Show() +``` + +--8<-- +./docs/cy/API/application_window.md +./docs/cy/API/application_menu.md +./docs/cy/API/application_dialogs.md +./docs/cy/API/application_events.md +./docs/cy/API/application_screens.md +--8<-- + + +## Opsiynau + +```go title="pkg/application/application_options.go" +--8<-- +../v3/pkg/application/application_options.go +--8<-- +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/application_dialogs.md b/mkdocs-website/docs/cy/API/application_dialogs.md new file mode 100644 index 000000000..0efda3f54 --- /dev/null +++ b/mkdocs-website/docs/cy/API/application_dialogs.md @@ -0,0 +1,67 @@ +### Dangos Deialog Ynghylch + +API: `ShowAboutDialog()` + +Mae `ShowAboutDialog()` yn dangos blwch deialog "Ynghylch". Gall ddangos enw'r +cymhwysiad, disgrifiad ac eicon. + +```go + // Dangos y deialog ynghylch + app.ShowAboutDialog() +``` + +### Gwybodaeth + +API: `InfoDialog()` + +Mae `InfoDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` gyda +`InfoDialogType`. Defnyddir y deialog hon fel arfer i ddangos negeseuon +gwybodaeth i'r defnyddiwr. + +### Cwestiwn + +API: `QuestionDialog()` + +Mae `QuestionDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` +gyda `QuestionDialogType`. Defnyddir y deialog hon yn aml i ofyn cwestiwn i'r +defnyddiwr a disgwyl ymateb. + +### Rhybudd + +API: `WarningDialog()` + +Mae `WarningDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` +gyda `WarningDialogType`. Fel y mae'r enw yn awgrymu, defnyddir y deialog hon yn +bennaf i ddangos negeseuon rhybudd i'r defnyddiwr. + +### Gwall + +API: `ErrorDialog()` + +Mae `ErrorDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` gyda +`ErrorDialogType`. Cynlluniwyd y deialog hon i'w defnyddio pan fydd angen +dangos neges gwall i'r defnyddiwr. + +### Agor Ffeil + +API: `OpenFileDialog()` + +Mae `OpenFileDialog()` yn creu ac yn dychwelyd esiampl newydd o +`OpenFileDialogStruct`. Mae'r deialog hon yn annog y defnyddiwr i ddewis un neu +ragor o ffeiliau o'u system ffeiliau. + +### Cadw Ffeil + +API: `SaveFileDialog()` + +Mae `SaveFileDialog()` yn creu ac yn dychwelyd esiampl newydd o +`SaveFileDialogStruct`. Mae'r deialog hon yn annog y defnyddiwr i ddewis lleoliad +yn eu system ffeiliau lle y dylid cadw ffeil. + +### Agor Cyfeiriadur + +API: `OpenDirectoryDialog()` + +Mae `OpenDirectoryDialog()` yn creu ac yn dychwelyd esiampl newydd o +`MessageDialog` gyda `OpenDirectoryDialogType`. Mae'r deialog hon yn galluogi'r +defnyddiwr i ddewis cyfeiriadur o'u system ffeiliau. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/application_events.md b/mkdocs-website/docs/cy/API/application_events.md new file mode 100644 index 000000000..22a9a83c1 --- /dev/null +++ b/mkdocs-website/docs/cy/API/application_events.md @@ -0,0 +1,13 @@ +### Ar + +API: +`Ar(eventType digwyddiadau.DdigwyddiadweithgangeningApplicationEventType, atebydd func(digwyddiad *Digwyddiad)) func()` + +Mae `Ar()` yn cofrestru gwrandäwr digwyddiad ar gyfer digwyddiadau cymhwysiad penodol. Bydd y swyddogaeth atebydd a ddarperir yn cael ei sbarduno pan fydd y digwyddiad cysylltiedig yn digwydd. Mae'r swyddogaeth yn dychwelyd swyddogaeth y gellir ei galw i dynnu'r gwrandäwr. + +### CofrestruArgraffwyr + +API: +`CofrestruArgraffwyr(eventType digwyddiadau.DdigwyddiadweithgangeningApplicationEventType, atebydd func(digwyddiad *Digwyddiad)) func()` + +Mae `CofrestruArgraffwyr()` yn cofrestru atebydd i'w redeg fel crocen yn ystod digwyddiadau penodol. Caiff y crocenau hyn eu rhedeg cyn gwrandawyr sy'n gysylltiedig ag `Ar()`. Mae'r swyddogaeth yn dychwelyd swyddogaeth y gellir ei galw i dynnu'r bâs. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/application_menu.md b/mkdocs-website/docs/cy/API/application_menu.md new file mode 100644 index 000000000..198cb3d88 --- /dev/null +++ b/mkdocs-website/docs/cy/API/application_menu.md @@ -0,0 +1,27 @@ +### RegisterContextMenu + +API: `RegisterContextMenu(name string, menu *Menu)` + +Mae `RegisterContextMenu()` yn cofrestru dewislen cyd-destun gyda enw penodol. Gellir defnyddio'r dewislen hon yn ddiweddarach yn yr ap. + +```go + // Creu dewislen newydd + ctxmenu := app.NewMenu() + + // Cofrestru'r dewislen fel dewislen cyd-destun + app.RegisterContextMenu("MyContextMenu", ctxmenu) +``` + +### SetMenu + +API: `SetMenu(menu *Menu)` + +Mae `SetMenu()` yn gosod y ddewislen ar gyfer yr ap. Ar Mac, bydd hyn yn fod y ddewislen fyd-eang. Ar gyfer Windows a Linux, bydd hyn yn fod y ddewislen ddiofyn ar gyfer unrhyw ffenestr newydd a grëir. + +```go + // Creu dewislen newydd + menu := app.NewMenu() + + // Gosod y ddewislen ar gyfer yr ap + app.SetMenu(menu) +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/application_screens.md b/mkdocs-website/docs/cy/API/application_screens.md new file mode 100644 index 000000000..fc1ab89eb --- /dev/null +++ b/mkdocs-website/docs/cy/API/application_screens.md @@ -0,0 +1,13 @@ +### GetPrimaryScreen + +API: `GetPrimaryScreen() (*Sgrin, error)` + +Mae `GetPrimaryScreen()` yn dychwelyd y sgrin brif y system. + +### GetScreens + +API: `GetScreens() ([]*Sgrin, error)` + +Mae `GetScreens()` yn dychwelyd gwybodaeth am bob sgrin sydd wedi'i chysylltu â'r system. + +Dyma grynodeb byr o'r dulliau allforio yn y `App` strwythur a ddarparwyd. Cofiwch, ar gyfer mwy o swyddogaethau neu ystyriaethau manwl, cyfeiriwch at y cod Go gwirioneddol neu ddogfennaeth fewnol bellach. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/application_window.md b/mkdocs-website/docs/cy/API/application_window.md new file mode 100644 index 000000000..be39f59b4 --- /dev/null +++ b/mkdocs-website/docs/cy/API/application_window.md @@ -0,0 +1,64 @@ +Dyma'r testun wedi'i gyfieithu i'r Gymraeg: + +### NewWebviewWindow + +API: `NewWebviewWindow() *WebviewWindow` + +Mae `NewWebviewWindow()` yn creu ffenestr Webview newydd gyda'r opsiynau rhagosodedig, ac yn ei dychwelyd. + +```go + // Creu ffenestr webview newydd + window := app.NewWebviewWindow() +``` + +### NewWebviewWindowWithOptions + +API: +`NewWebviewWindowWithOptions(windowOptions WebviewWindowOptions) *WebviewWindow` + +Mae `NewWebviewWindowWithOptions()` yn creu ffenestr webview newydd gydag opsiynau custom. Caiff y ffenestr newydd ei ychwanegu at fap o ffenestri a reolir gan y cymhwysiad. + +```go + // Creu ffenestr webview newydd gydag opsiynau custom + window := app.NewWebviewWindowWithOptions(WebviewWindowOptions{ + Name: "Main", + Title: "Fy Ffenestr", + Width: 800, + Height: 600, + }) +``` + +### OnWindowCreation + +API: `OnWindowCreation(callback func(window *WebviewWindow))` + +Mae `OnWindowCreation()` yn cofrestru ffwythiant alw-nôl i'w alw pan grëir ffenestr. + +```go + // Cofrestru ffwythiant alw-nôl i'w alw pan grëir ffenestr + app.OnWindowCreation(func(window *WebviewWindow) { + // Gwneud rhywbeth + }) +``` + +### GetWindowByName + +API: `GetWindowByName(name string) *WebviewWindow` + +Mae `GetWindowByName()` yn nôl ac yn dychwelyd ffenestr gyda enw penodol. + +```go + // Cael ffenestr drwy ei henw + window := app.GetWindowByName("Main") +``` + +### CurrentWindow + +API: `CurrentWindow() *WebviewWindow` + +Mae `CurrentWindow()` yn nôl ac yn dychwelyd cyfeiriad at y ffenestr weithredol yn y cymhwysiad. Os nad oes ffenestr, mae'n dychwelyd nil. + +```go + // Cael y ffenestr gyfredol + window := app.CurrentWindow() +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/mainthread.md b/mkdocs-website/docs/cy/API/mainthread.md new file mode 100644 index 000000000..d58b1f17b --- /dev/null +++ b/mkdocs-website/docs/cy/API/mainthread.md @@ -0,0 +1,50 @@ +# Prif Swyddogaethau Trywydd + +Mae'r dulliau hyn yn swyddogaethau cymorth i redeg cod ar y prif drywydd. Mae hyn yn +ofynnol pan fyddwch am redeg cod cyfaddas ar y llwyfan UI. + +### InvokeSync + +API: `InvokeSync(fn func())` + +Mae'r swyddogaeth hon yn rhedeg y swyddogaeth a drosglwyddwyd (`fn`) yn ddilynebol. Mae'n defnyddio WaitGroup +(`wg`) i sicrhau bod y prif drywydd yn aros i `fn` swyddogaeth orffen +cyn iddo barhau. Os bydd panig yn digwydd o fewn `fn`, bydd yn cael ei drosglwyddo i'r +swyddogaeth trin panig `PanicHandler`, a ddiffinnir yn opsiynau'r cymhwysiad. + +### InvokeSyncWithResult + +API: `InvokeSyncWithResult[T any](fn func() T) (res T)` + +Mae'r swyddogaeth hon yn gweithio'n debyg i `InvokeSync(fn func())`, fodd bynnag, mae'n rhoi +canlyniad. Defnyddiwch hyn ar gyfer galw unrhyw swyddogaeth gyda un canlyniad yn unig. + +### InvokeSyncWithError + +API: `InvokeSyncWithError(fn func() error) (err error)` + +Mae'r swyddogaeth hon yn rhedeg `fn` yn ddilynebol ac yn dychwelyd unrhyw wall a gynhyrchir gan `fn`. +Sylwch y bydd y swyddogaeth hon yn adfer o banig os bydd un yn digwydd yn ystod +gweithrediad `fn`. + +### InvokeSyncWithResultAndError + +API: +`InvokeSyncWithResultAndError[T any](fn func() (T, error)) (res T, err error)` + +Mae'r swyddogaeth hon yn rhedeg `fn` yn ddilynebol ac yn dychwelyd canlyniad o fath `T` a +gwall. + +### InvokeAsync + +API: `InvokeAsync(fn func())` + +Mae'r swyddogaeth hon yn rhedeg `fn` yn asyng. Mae'n rhedeg y swyddogaeth a roddir ar y +prif drywydd. Os bydd panig yn digwydd o fewn `fn`, bydd yn cael ei drosglwyddo i'r +swyddogaeth trin panig `PanicHandler`, a ddiffinnir yn opsiynau'r cymhwysiad. + +--- + +_Sylw_: Bydd y swyddogaethau hyn yn rhwystro gweithrediad nes bod `fn` wedi gorffen. Mae'n +hanfodol sicrhau nad yw `fn` yn rhwystro. Os bydd angen i chi redeg swyddogaeth sy'n +rhwystro, defnyddiwch `InvokeAsync` yn lle. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/menu.md b/mkdocs-website/docs/cy/API/menu.md new file mode 100644 index 000000000..70a87ffe4 --- /dev/null +++ b/mkdocs-website/docs/cy/API/menu.md @@ -0,0 +1,73 @@ +# Dewislen + +Gellir creu a chynnwys dewislenni yn y rhaglen. Gellir eu defnyddio i greu +dewislenni cyd-destun, dwylo system a dewislenni rhaglen. + +I greu dewislen newydd, galwch: + +```go + // Creu dewislen newydd + dewislen := app.NewMenu() +``` + +Mae'r gweithrediadau canlynol ar gael ar y `Dewislen` math: + +### Ychwanegu + +API: `Ychwanegu(label string) *EitemDewislen` + +Mae'r dull hwn yn cymryd `label` o fath `string` fel mewnbwn ac yn ychwanegu +`EitemDewislen` newydd gyda'r label a roddir at y ddewislen. Mae'n dychwelyd yr +`EitemDewislen` a ychwanegwyd. + +### YchwaneguSeparwr + +API: `YchwaneguSeparwr()` + +Mae'r dull hwn yn ychwanegu `EitemDewislen` gwahanol newydd at y ddewislen. + +### YchwaneguBlwch + +API: `YchwaneguBlwch(label string, galluogedig bool) *EitemDewislen` + +Mae'r dull hwn yn cymryd `label` o fath `string` a `galluogedig` o fath `bool` +fel mewnbwn ac yn ychwanegu `EitemDewislen` blwch ticio newydd gyda'r label a'r +cyflwr galluogedig a roddir at y ddewislen. Mae'n dychwelyd yr `EitemDewislen` +a ychwanegwyd. + +### YchwaneguRadio + +API: `YchwaneguRadio(label string, galluogedig bool) *EitemDewislen` + +Mae'r dull hwn yn cymryd `label` o fath `string` a `galluogedig` o fath `bool` +fel mewnbwn ac yn ychwanegu `EitemDewislen` radio newydd gyda'r label a'r +cyflwr galluogedig a roddir at y ddewislen. Mae'n dychwelyd yr `EitemDewislen` +a ychwanegwyd. + +### Diweddaru + +API: `Diweddaru()` + +Mae'r dull hwn yn prosesu unrhyw grwpiau radio ac yn diweddaru'r ddewislen os +na chaiff y rhyngwyneb dewislen ei gychwyn. + +### YchwaneguIsddewislen + +API: `YchwaneguIsddewislen(s string) *Dewislen` + +Mae'r dull hwn yn cymryd `s` o fath `string` fel mewnbwn ac yn ychwanegu +`EitemDewislen` isddewislen newydd gyda'r label a roddir at y ddewislen. Mae'n +dychwelyd yr isddewislen a ychwanegwyd. + +### YchwaneguRôl + +API: `YchwaneguRôl(rôl Rôl) *Dewislen` + +Mae'r dull hwn yn cymryd `rôl` o fath `Rôl` fel mewnbwn, yn ei ychwanegu at y +ddewislen os nad yw'n `nil` ac yn dychwelyd y `Dewislen`. + +### SetLabel + +API: `SetLabel(label string)` + +Mae'r dull hwn yn gosod `label` y `Dewislen`. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/systray.md b/mkdocs-website/docs/cy/API/systray.md new file mode 100644 index 000000000..75b0ed9ad --- /dev/null +++ b/mkdocs-website/docs/cy/API/systray.md @@ -0,0 +1,104 @@ +# Ardal Hysbysu + +Mae'r ardal hysbysu yn cynnwys ardal hysbysu ar amgylchedd bwrdd gwaith, a all +gynnwys eiconau o'r rhaglenni sy'n rhedeg ar hyn o bryd a hysbysiadau system +penodol. + +Rydych yn creu ardal hysbysu trwy alw `app.NewSystemTray()`: + +```go + // Creu ardal hysbysu newydd +tray := app.NewSystemTray() +``` + +Mae'r dulliau canlynol ar gael ar y `SystemTray` math: + +### SetLabel + +API: `SetLabel(label string)` + +Mae'r dull `SetLabel` yn gosod label yr ardal hysbysu. + +### Label + +API: `Label() string` + +Mae'r dull `Label` yn adfer label yr ardal hysbysu. + +### PositionWindow + +API: `PositionWindow(*WebviewWindow, offset int) error` + +Mae'r dull `PositionWindow` yn galw'r dulliau `AttachWindow` a `WindowOffset`. + +### SetIcon + +API: `SetIcon(icon []byte) *SystemTray` + +Mae'r dull `SetIcon` yn gosod eicon yr ardal hysbysu system. + +### SetDarkModeIcon + +API: `SetDarkModeIcon(icon []byte) *SystemTray` + +Mae'r dull `SetDarkModeIcon` yn gosod eicon yr ardal hysbysu system pan mewn modd tywyll. + +### SetMenu + +API: `SetMenu(menu *Menu) *SystemTray` + +Mae'r dull `SetMenu` yn gosod dewislen yr ardal hysbysu. + +### Destroy + +API: `Destroy()` + +Mae'r dull `Destroy` yn dinistrio'r enghraifft ardal hysbysu. + +### OnClick + +API: `OnClick(handler func()) *SystemTray` + +Mae'r dull `OnClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio. + +### OnRightClick + +API: `OnRightClick(handler func()) *SystemTray` + +Mae'r dull `OnRightClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio â'r dde. + +### OnDoubleClick + +API: `OnDoubleClick(handler func()) *SystemTray` + +Mae'r dull `OnDoubleClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio ddwywaith. + +### OnRightDoubleClick + +API: `OnRightDoubleClick(handler func()) *SystemTray` + +Mae'r dull `OnRightDoubleClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio ddwywaith â'r dde. + +### AttachWindow + +API: `AttachWindow(window *WebviewWindow) *SystemTray` + +Mae'r dull `AttachWindow` yn atodi ffenestr i'r ardal hysbysu system. Bydd y ffenestr yn cael ei dangos pan fo'r eicon ardal hysbysu wedi'i glicio. + +### WindowOffset + +API: `WindowOffset(offset int) *SystemTray` + +Mae'r dull `WindowOffset` yn gosod y bwlch mewn picselau rhwng yr ardal hysbysu system a'r ffenestr. + +### WindowDebounce + +API: `WindowDebounce(debounce time.Duration) *SystemTray` + +Mae'r dull `WindowDebounce` yn gosod amser diddymu. Yng nghyd-destun Windows, defnyddir hyn i bennu faint o amser i aros cyn ymateb i ddigwyddiad clic llygoden i fyny ar yr eicon hysbysu. + +### OpenMenu + +API: `OpenMenu()` + +Mae'r dull `OpenMenu` yn agor y ddewislen sy'n gysylltiedig â'r ardal hysbysu system. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/API/window.md b/mkdocs-website/docs/cy/API/window.md new file mode 100644 index 000000000..847d17c73 --- /dev/null +++ b/mkdocs-website/docs/cy/API/window.md @@ -0,0 +1,116 @@ +# Ffenestr + +I greu ffenestr, defnyddiwch +[Application.NewWebviewWindow](application.md#newwebviewwindow) neu +[Application.NewWebviewWindowWithOptions](application.md#newwebviewwindowwithoptions). +Mae'r cyntaf yn creu ffenestr gyda nodweddion rhagosodedig, tra bod yr olaf yn +caniatáu i chi bennu opsiynau wedi'u haddasu. + +Mae'r dulliau hyn yn galladwy ar y gwrthrych WebviewWindow a ddychwelir: + +### SetTitle + +API: `SetTitle(teitl string) *WebviewWindow` + +Mae'r dull hwn yn diweddaru teitl y ffenestr i'r llinyn a ddarperir. Mae'n dychwelyd +y gwrthrych WebviewWindow, gan ganiatáu i ddulliau gael eu cadwyn. + +### Enw + +API: `Enw() string` + +Mae'r swyddogaeth hon yn dychwelyd enw'r WebviewWindow. + +### SetSize + +API: `SetSize(lled, uchder int) *WebviewWindow` + +Mae'r dull hwn yn gosod maint y WebviewWindow i'r lled a'r uchder a ddarperir. Os +yw'r dimensiynau a ddarparwyd yn rhagori ar y cyfyngiadau, mae'n eu haddasu'n briodol. + +### SetAlwaysOnTop + +API: `SetAlwaysOnTop(b bool) *WebviewWindow` + +Mae'r swyddogaeth hon yn gosod y ffenestr i aros ar y brig yn seiliedig ar y blaen +llinyn a ddarperir. + +### Dangos + +API: `Dangos() *WebviewWindow` + +Mae'r dull `Dangos` yn cael ei ddefnyddio i wneud y ffenestr yn weladwy. Os +nad yw'r ffenestr yn rhedeg, mae'n gwahodd y dull `rhedeg` i ddechrau'r ffenestr +ac yna'n ei gwneud yn weladwy. + +### Cuddio + +API: `Cuddio() *WebviewWindow` + +Mae'r dull `Cuddio` yn cael ei ddefnyddio i guddio'r ffenestr. Mae'n gosod y +statws cudd o'r ffenestr i wir ac yn lledu'r digwyddiad cuddio ffenestr. + +### SetURL + +API: `SetURL(s string) *WebviewWindow` + +Mae'r dull `SetURL` yn cael ei ddefnyddio i osod URL y ffenestr i'r llinyn URL a ddarparwyd. + +### SetZoom + +API: `SetZoom(mewnosod float64) *WebviewWindow` + +Mae'r dull `SetZoom` yn gosod lefel swm cynnwys y ffenestr i'r lefel mewnosod a ddarparwyd. + +### GetZoom + +API: `GetZoom() float64` + +Mae'r swyddogaeth `GetZoom` yn dychwelyd y lefel swm bresennol o gynnwys y ffenestr. + +### GetScreen + +API: `GetScreen() (*Screen, error)` + +Mae'r dull `GetScreen` yn dychwelyd y sgrin lle mae'r ffenestr yn cael ei harddangos. + +### SetFrameless + +API: `SetFrameless(frameless bool) *WebviewWindow` + +Mae'r swyddogaeth hon yn cael ei defnyddio i dynnu'r ffrâm a bar teitl y ffenestr. +Mae'n toglo'r framelessness o'r ffenestr yn unol â'r gwerth boolean a ddarperir +(gwir ar gyfer frameless, ffug ar gyfer ffrâm). + +### RegisterContextMenu + +API: `RegisterContextMenu(enw string, dewislen *Dewislen)` + +Mae'r swyddogaeth hon yn cael ei defnyddio i gofrestru dewislen cyd-destun ac +yn ei neilltuo i'r enw a ddarparwyd. + +### NativeWindowHandle + +API: `NativeWindowHandle() (uintptr, error)` + +Mae'r swyddogaeth hon yn cael ei defnyddio i nodi'r handlen ffenestr brodorol +ar gyfer y ffenestr. + +### Ffocws + +API: `Ffocws()` + +Mae'r swyddogaeth hon yn cael ei defnyddio i ffocysu'r ffenestr. + +### SetEnabled + +API: `SetEnabled(galluogwyd bool)` + +Mae'r swyddogaeth hon yn cael ei defnyddio i alluogi/analluogi'r ffenestr yn +seiliedig ar y gwerth boolean a ddarperir. + +### SetAbsolutePosition + +API: `SetAbsolutePosition(x int, y int)` + +Mae'r swyddogaeth hon yn gosod y safle absoliwt o'r ffenestr yn y sgrin. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/changelog.md b/mkdocs-website/docs/cy/changelog.md new file mode 100644 index 000000000..100f6b96f --- /dev/null +++ b/mkdocs-website/docs/cy/changelog.md @@ -0,0 +1,55 @@ +# Croniclau + + + +## [Heb ei ryddhau] + +### Ychwanegwyd +- [darwin] ychwanegu Digwyddiad ApplicationShouldHandleReopen i fedru ymdrin â chlicio ar yr eicon doc gan @5aaee9 yn [#2991](https://github.com/wailsapp/wails/pull/2991) +- [darwin] ychwanegu getPrimaryScreen/getScreens i impl gan @tmclane yn [#2618](https://github.com/wailsapp/wails/pull/2618) +- [darwin] ychwanegu opsiwn ar gyfer dangos y bar offer mewn modd sgrin llawn ar macOS gan [@fbbdev](https://github.com/fbbdev) yn [#3282](https://github.com/wailsapp/wails/pull/3282) +- [linux] ychwanegu rhesymeg onKeyPress i drosi allwedd linux i gyflymydd gan @[Atterpac](https://github.com/Atterpac) yn [#3022](https://github.com/wailsapp/wails/pull/3022]) +- [linux] ychwanegu tasg `rhedeg:linux` gan [@marcus-crane](https://github.com/marcus-crane) yn [#3146](https://github.com/wailsapp/wails/pull/3146) +- allforio dull `SetIcon` gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3147) +- Gwella `OnShutdown` gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3189) +- adfer dull `ToggleMaximise` yn y rhyngwyneb `Window` gan [@fbbdev](https://github.com/fbbdev) yn [#3281](https://github.com/wailsapp/wails/pull/3281) + +### Wedi Trwsio + +- Wedi trwsio prosesau zombie wrth weithio mewn modd datblygu drwy ddiweddaru i'r diweddaraf gan [Atterpac](https://github.com/atterpac) yn [#3320](https://github.com/wailsapp/wails/pull/3320). +- Wedi trwsio ffynhonnell ffeil webkit appimage gan [Atterpac](https://github.com/atterpac) yn [#3306](https://github.com/wailsapp/wails/pull/3306). +- Wedi trwsio Doctor fygythiad pecyn apt gan [Atterpac](https://github.com/Atterpac) yn [#2972](https://github.com/wailsapp/wails/pull/2972). +- Wedi trwsio'r cais wedi rhewi wrth ddod allan (Darwin) gan @5aaee9 yn [#2982](https://github.com/wailsapp/wails/pull/2982) +- Wedi trwsio lliwiau cefndir yr enghreifftiau ar Windows gan [mmgvh](https://github.com/mmghv) yn [#2750](https://github.com/wailsapp/wails/pull/2750). +- Wedi trwsio dewislenni cyd-destun rhagosodedig gan [mmgvh](https://github.com/mmghv) yn [#2753](https://github.com/wailsapp/wails/pull/2753). +- Wedi trwsio gwerth hecsadegol ar gyfer bysellau saeth ar Darwin gan [jaybeecave](https://github.com/jaybeecave) yn [#3052](https://github.com/wailsapp/wails/pull/3052). +- Gosod llusgo-a-gollwng ar gyfer Windows i weithio. Ychwanegwyd gan [@pylotlight](https://github.com/pylotlight) yn [PR](https://github.com/wailsapp/wails/pull/3039) +- Wedi trwsio bygiau ar gyfer linux yn y meddyg os nad oes gan y defnyddiwr y gyrwyr priodol wedi'u gosod. Ychwanegwyd gan [@pylotlight](https://github.com/pylotlight) yn [PR](https://github.com/wailsapp/wails/pull/3032) +- Trwsio graddio dpi wrth gychwyn (windows). Newidiwyd gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3145) +- Trwsio'r llinell amnewid yn `go.mod` i ddefnyddio llwybrau cymharol - Trwsio llwybrau Windows gyda gofodau gan @leaanthony. +- Trwsio gweithredu clicio Maclanwad system wrth ddim cysylltiedig â ffenestr gan [thomas-senechal](https://github.com/thomas-senechal) yn PR [#3207](https://github.com/wailsapp/wails/pull/3207) +- Trwsio adeiladu Windows yn methu oherwydd opsiwn anhysbys gan [thomas-senechal](https://github.com/thomas-senechal) yn PR [#3208](https://github.com/wailsapp/wails/pull/3208) +- Trwsio URL sylfaenol anghywir wrth agor ffenestr ddwywaith gan @5aaee9 yn PR [#3273](https://github.com/wailsapp/wails/pull/3273) +- Trwsio trefn brigiau os yn y dull `WebviewWindow.Restore` gan [@fbbdev](https://github.com/fbbdev) yn [#3279](https://github.com/wailsapp/wails/pull/3279) +- Cyfrifo `startURL` yn gywir ar draws galwadau lluosog `GetStartURL` pan fo `FRONTEND_DEVSERVER_URL` yn bresennol. [#3299](https://github.com/wailsapp/wails/pull/3299) + +### Newidiwyd + +### Tynnwyd + +### Wedi Dibrisio + +### Diogelwch \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes.md b/mkdocs-website/docs/cy/development/changes.md new file mode 100644 index 000000000..db1e3e0c1 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes.md @@ -0,0 +1,20 @@ +# Newidiadau ar gyfer v3 + +!!! note + Mae hwn ar hyn o bryd yn ddampio meddwl heb ei drefnu o newidiadau. Bydd yn cael ei drefnu i fformat mwy darllenadwy yn fuan. + +--8<-- +./docs/en/development/changes_events.md +./docs/en/development/changes_window.md +./docs/en/development/changes_systray.md +./docs/en/development/changes_bindings.md +./docs/en/development/changes_dragndrop.md +./docs/en/development/changes_context_menus.md +./docs/en/development/changes_dialogs.md +./docs/en/development/changes_clipboard.md +./docs/en/development/changes_wml.md +./docs/en/development/changes_plugins.md +./docs/en/development/changes_enums.md +./docs/en/development/changes_logging.md +./docs/en/development/changes_misc.md +--8<-- \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_bindings.md b/mkdocs-website/docs/cy/development/changes_bindings.md new file mode 100644 index 000000000..c4a061d50 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_bindings.md @@ -0,0 +1,87 @@ +Dyma'r cyfieithiad i'r gymraeg: + +## Rhwymedigaethau + +Mae rhwymedigaethau yn gweithio mewn modd tebyg i v2, drwy ddarparu ffordd i rwymo +dulliau strwythur i'r rhyngwyneb blaen. Gellir eu galw yn y rhyngwyneb blaen gan +ddefnyddio'r wraperi rhwymedigaeth a gynhyrchwyd gan y gorchymyn `wails3 generate bindings`: + +```javascript +// @ts-check +// Mae'r ffeil hon wedi'i chynhyrchu'n awtomatig. PEIDIWCH Â'I GOLYGU + +import { main } from "./models"; + +window.go = window.go || {}; +window.go.main = { + GreetService: { + /** + * GreetService.Greet + * Mae Greet yn cyfarch rhywun + * @param name {string} + * @returns {Promise} + **/ + Greet: function (name) { + wails.CallByID(1411160069, ...Array.prototype.slice.call(arguments, 0)); + }, + + /** + * GreetService.GreetPerson + * Mae GreetPerson yn cyfarch rhywun + * @param person {main.Person} + * @returns {Promise} + **/ + GreetPerson: function (person) { + wails.CallByID(4021313248, ...Array.prototype.slice.call(arguments, 0)); + }, + }, +}; +``` + +Mae dulliau rhwymo wedi'u cuddio'n ddiofyn, ac maent yn cael eu hadnabod gan IDs uint32, +a gyfrifir gan ddefnyddio'r [algorithm hasio FNV](https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function). +Mae hyn er mwyn atal enw'r dull rhag cael ei ddatgelu mewn adeiladau cynhyrchiol. Mewn +modd dadfygio, mae'r IDs dull yn cael eu logio ynghyd â'r ID a gyfrifwyd o'r dull +i helpu i ddadfygio. Os ydych chi am ychwanegu haen arall o guddio, gallwch +ddefnyddio'r opsiwn `BindAliases`. Mae hyn yn caniatáu ichi bennu map o IDs alias i +IDs dull. Pan fydd y rhyngwyneb blaen yn galw dull gan ddefnyddio ID, bydd yr ID dull +yn cael ei chwilio yn y map alias yn gyntaf am gywiro. Os nad yw'n ei ganfod, +mae'n tybio mai ID dull safonol yw ac yn ceisio canfod y dull yn y ffordd arferol. + +Enghraifft: + +```go + app := application.New(application.Options{ + Bind: []any{ + &GreetService{}, + }, + BindAliases: map[uint32]uint32{ + 1: 1411160069, + 2: 4021313248, + }, + Assets: application.AssetOptions{ + Handler: application.AssetFileServerFS(assets), + }, + Mac: application.MacOptions{ + ApplicationShouldTerminateAfterLastWindowClosed: true, + }, + }) +``` + +Nawr gallwn alw gan ddefnyddio'r alias hwn yn y rhyngwyneb blaen: `wails.Call(1, "byd!")`. + +### Galwadau anniogel + +Os nad ydych chi'n poeni am eich galwadau yn cael eu cyhoeddi mewn testun plaen yn eich binari +ac nid oes gennych fwriad o ddefnyddio [garble](https://github.com/burrowers/garble), yna +gallwch ddefnyddio'r dull `wails.CallByName()` anniogel. Mae'r dull hwn yn cymryd enw +llawn cymhwysol y dull i'w alw a'r arguments i'w pasio iddo. +Enghraifft: + + ```go + wails.CallByName("main.GreetService.Greet", "byd!") + ``` + +!!! angen gofal + + Darperir hwn dim ond fel dull cyfleustra ar gyfer datblygu. Ni chyngherir i'w ddefnyddio mewn cynhyrchiad. diff --git a/mkdocs-website/docs/cy/development/changes_clipboard.md b/mkdocs-website/docs/cy/development/changes_clipboard.md new file mode 100644 index 000000000..13196ba29 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_clipboard.md @@ -0,0 +1,3 @@ +## ClipBoard + +Mae API y clipfwrdd wedi'i symleiddio. Mae bellach un gwrthrych `Clipboard` y gellir ei ddefnyddio i ddarllen a chyflwyno i'r clipfwrdd. Mae'r gwrthrych `Clipboard` ar gael yn Go ac JS. `SetText()` i osod y testun a `Text()` i gael y testun. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_context_menus.md b/mkdocs-website/docs/cy/development/changes_context_menus.md new file mode 100644 index 000000000..7f4e6a4e9 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_context_menus.md @@ -0,0 +1,18 @@ +## Dewislenni Cyd-destun + +Mae dewislenni cyd-destun yn ddewislenni cyd-destunol a ddangosir pan fydd y +defnyddiwr yn clicio'n dde ar elfen. Mae creu dewislen gyd-destun yr un peth â +chreu dewislen safonol, gan ddefnyddio `app.NewMenu()`. I wneud y ddewislen +gyd-destun ar gael i ffenestr, galwch `window.RegisterContextMenu(name, menu)`. +Bydd y enw yn yr id o'r ddewislen gyd-destun ac a ddefnyddir gan y rhaglen +wynebu. + +I nodi bod gan elfen ddewislen gyd-destun, ychwanegwch y priodoledd +`data-contextmenu` at yr elfen. Dylai gwerth y priodoledd hwn fod yn enw o +ddewislen gyd-destun a gofrestrwyd yn flaenorol gyda'r ffenestr. + +Mae'n bosibl cofrestru dewislen gyd-destun ar lefel y cymhwysiad, gan ei +gwneud ar gael i bob ffenestr. Gellir gwneud hyn gan ddefnyddio +`app.RegisterContextMenu(name, menu)`. Os na ellir dod o hyd i ddewislen +gyd-destun ar lefel y ffenestr, bydd y dewislenni cyd-destun cymhwyso yn cael +eu gwirio. Ceir demo o hyn yn `v3/examples/contextmenus`. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_dialogs.md b/mkdocs-website/docs/cy/development/changes_dialogs.md new file mode 100644 index 000000000..f1390d9a0 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_dialogs.md @@ -0,0 +1,25 @@ +## Sgyrsiau + +Mae sgyrsiau bellach ar gael yn JavaScript! + +### Ffenestri + +Nid yw botymau sgyrsiau yn Windows yn ffurfweddadwy ac yn gyson yn dibynnu ar y +math o sgwrs. I drîgeru galwad enw pan fo botwm yn cael ei wasgu, crëwch botwm +â'r un enw â'r botwm yr ydych am gael y galwad enw i'w gysylltu ag ef. +Enghraifft: Crëwch fotwm â'r label `Ok` a defnyddio `OnClick()` i osod y +dull galwad enw: + +```go + dialog := app.QuestionDialog(). + SetTitle("Diweddaru"). + SetMessage("Mae'r botwm canslo yn cael ei ddewis pan fo'r bys dianc yn cael ei wasgu") + ok := dialog.AddButton("Ok") + ok.OnClick(func() { + // Gwneud rhywbeth + }) + no := dialog.AddButton("Canslo") + dialog.SetDefaultButton(ok) + dialog.SetCancelButton(no) + dialog.Show() +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_dragndrop.md b/mkdocs-website/docs/cy/development/changes_dragndrop.md new file mode 100644 index 000000000..0dda22df7 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_dragndrop.md @@ -0,0 +1,8 @@ +## Llusgo a Gollwng + +Gellir galluogi llusgo a gollwng brodorol fesul ffenest. Yn syml, gosodwch yr +opsiwn cyflunio ffenest `EnableDragAndDrop` i `true` a bydd y ffenest yn +caniatáu i ffeiliau gael eu llusgoi arni. Pan fydd hyn yn digwydd, bydd y +digwyddiad `events.FilesDropped` yn cael ei yrru. Gellir yna nôl yr enwau +ffeil o `WindowEvent.Context()` gan ddefnyddio'r dull `DroppedFiles()`. Mae +hwn yn dychwelyd sleis o linynnau yn cynnwys yr enwau ffeil. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_enums.md b/mkdocs-website/docs/cy/development/changes_enums.md new file mode 100644 index 000000000..b22676e5c --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_enums.md @@ -0,0 +1,41 @@ +#### Enawau + +Yng Ngo, mae enawau yn aml yn cael eu diffinio fel math a set o gysonau. Er enghraifft: + +```go +type MyEnum int + +const ( + MyEnumOne MyEnum = iota + MyEnumTwo + MyEnumThree +) +``` + +Oherwydd anghydnawsedd rhwng Go a JavaScript, ni ellir defnyddio mathau custom mewn +ffordd hon. Y strategaeth orau yw defnyddio alias math ar gyfer float64: + +```go +type MyEnum = float64 + +const ( + MyEnumOne MyEnum = iota + MyEnumTwo + MyEnumThree +) +``` + +Yn JavaScript, gallwch chi wedyn ddefnyddio'r canlynol: + +```js +const MyEnum = { + MyEnumOne: 0, + MyEnumTwo: 1, + MyEnumThree: 2, +}; +``` + +- Pam defnyddio `float64`? Oni allwn ni ddefnyddio `int`? + - Oherwydd nad oes gan JavaScript gysyniad o `int`. Mae popeth yn `number`, sy'n cyfieithu i `float64` yn Go. Mae hefyd cyfyngiadau + ar daflu mathau yn pecyn adlewyrchu Go, sy'n golygu nad yw defnyddio `int` yn + gweithio. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_events.md b/mkdocs-website/docs/cy/development/changes_events.md new file mode 100644 index 000000000..0785f89a7 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_events.md @@ -0,0 +1,39 @@ +## Digwyddiadau + +Yn v3, mae 3 math o ddigwyddiadau: + +- Digwyddiadau Cymhwysiad +- Digwyddiadau Ffenestr +- Digwyddiadau Cyfaddas + +### Digwyddiadau Cymhwysiad + +Mae digwyddiadau cymhwysiad yn ddigwyddiadau a allbynir gan y cymhwysiad. Mae'r digwyddiadau hyn yn cynnwys digwyddiadau brodorol fel `ApplicationDidFinishLaunching` ar macOS. + +### Digwyddiadau Ffenestr + +Mae digwyddiadau ffenestr yn ddigwyddiadau a allbynir gan ffenestr. Mae'r digwyddiadau hyn yn cynnwys digwyddiadau brodorol fel `WindowDidBecomeMain` ar macOS. Diffinnir digwyddiadau cyffredin hefyd, fel y maent yn gweithio ar draws platfformau, e.e. `WindowClosing`. + +### Digwyddiadau Cyfaddas + +Mae'r digwyddiadau y mae'r defnyddiwr yn eu diffinio yn cael eu galw `WailsEvents`. Mae hyn er mwyn eu gwahaniaethu o'r gwrthrych `Event` a ddefnyddir i gyfathrebu gyda'r porwr. Mae WailsEvents bellach yn wrthrychau sy'n erynu holl fanylion digwyddiad. Mae hyn yn cynnwys enw'r digwyddiad, y data, a ffynhonnell y digwyddiad. + +Mae'r data sy'n gysylltiedig â WailsEvent bellach yn un gwerth. Os oes angen mwy nag un gwerth, gellir defnyddio strwythur. + +### Galwadau digwyddiad a llofnod swyddogaeth `Emit` + +Mae llofnodion y galwadau digwyddiad (fel y defnyddir gan `On`, `Once` & `OnMultiple`) wedi newid. Yn v2, naeth y swyddogaeth alwad dderbyn data dewisol. Yn v3, mae'r swyddogaeth alwad yn derbyn gwrthrych `WailsEvent` sy'n cynnwys yr holl ddata sy'n berthnasol i'r digwyddiad. + +Yn yr un modd, mae'r swyddogaeth `Emit` wedi newid. Yn lle cymryd enw a data dewisol, mae'n cymryd un gwrthrych `WailsEvent` y bydd yn ei allbynnu. + +### `Off` a `OffAll` + +Yn v2, byddai galwadau `Off` a `OffAll` yn tynnu digwyddiadau i ffwrdd yn JS ac yn Go. Oherwydd natur aml-ffenestr v3, mae hyn wedi newid fel bod y dulliau hyn ond yn berthnasol i'r cyd-destun y'u galwyd. Er enghraifft, os ydych yn galw `Off` mewn ffenestr, dim ond digwyddiadau ar gyfer y ffenestr honno y bydd yn eu tynnu. Os ydych yn defnyddio `Off` yn Go, dim ond digwyddiadau ar gyfer Go y bydd yn eu tynnu. + +### Bachau + +Mae Bachau Digwyddiad yn nodwedd newydd yn v3. Maent yn caniatáu i chi fachlu i mewn i'r system ddigwyddiadau a chyflawni gweithredoedd pan fydd digwyddiadau penodol yn cael eu hallbynnu. Er enghraifft, gallwch fachlu i mewn i'r digwyddiad `WindowClosing` a chyflawni rhywfaint o lanhau cyn i'r ffenestr gau. Gellir cofrestru bachau ar lefel y cymhwysiad neu ar lefel y ffenestr gan ddefnyddio `RegisterHook`. Bydd bachau lefel cymhwysiad ar gyfer digwyddiadau cymhwysiad. Bydd bachau lefel ffenestr ond yn cael eu galw ar gyfer y ffenestr y'u cofrestrir. + +### Nodiadau datblygwr + +Pan allbynwch ddigwyddiad yn Go, bydd yn dosbarthu'r digwyddiad i wrrandawyr Go lleol a hefyd i bob ffenestr yn y cymhwysiad. Pan allbynwch ddigwyddiad yn JS, mae'n nawr yn anfon y digwyddiad at y cymhwysiad. Caiff hwn ei brosesu fel petai wedi ei allbynnu yn Go, fodd bynnag bydd ID y anfonwr yn bod hwnnw o'r ffenestr. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_logging.md b/mkdocs-website/docs/cy/development/changes_logging.md new file mode 100644 index 000000000..691589183 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_logging.md @@ -0,0 +1,6 @@ +### Cofnodi + +Roedd cofnodi yn v2 yn ddryslyd gan fod cofnodion cymhwysiad a chofnodion system (mewnol) yn defnyddio'r un cofnodwr. Rydym wedi ei symleiddio fel a ganlyn: + +- Mae cofnodion mewnol yn cael eu trin nawr gan ddefnyddio'r cofnodwr `slog` safonol Go. Caiff hwn ei ffurfweddu gan ddefnyddio'r opsiwn `logger` yn yr opsiynau cymhwysiad. Yn ddiofyn, mae hwn yn defnyddio'r cofnodwr [tint](https://github.com/lmittmann/tint). +- Gellir cyflawni cofnodion cymhwysiad nawr trwy'r ciplug `log` newydd sy'n defnyddio `slog` o dan y rhyngwyneb. Mae'r ciplug hwn yn darparu API syml ar gyfer cofnodi i'r consol. Mae ar gael yn y naill iaith Go a JS. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_misc.md b/mkdocs-website/docs/cy/development/changes_misc.md new file mode 100644 index 000000000..ae52545ea --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_misc.md @@ -0,0 +1,41 @@ +### Misc + +## Opsiynau Cymhwyso Windows + +### WndProcInterceptor + +Os caiff hwn ei osod, bydd WndProc yn cael ei ychwanegu ac fe gaiff y swyddogaeth ei galw. +Mae hyn yn caniatáu i chi ddelio â negeseuon Windows yn uniongyrchol. Dylai'r swyddogaeth +fod â'r llofnod canlynol: + +```go +func(hwnd uintptr, msg uint32, wParam, lParam uintptr) (returnValue uintptr, shouldReturn) +``` + +Dylid gosod y gwerth `shouldReturn` i `true` os dylai'r `returnValue` gael ei +ddychwelyd gan y prif ddull wndProc. Os caiff ei osod i `false`, bydd y gwerth +dychwelyd yn cael ei anwybyddu a bydd y neges yn parhau i gael ei phrosesu gan y prif +ddull wndProc. + +## Cuddio'r Ffenestr wrth Gau + OnBeforeClose + +Yn v2, roedd y fflag `HideWindowOnClose` i guddio'r ffenestr pan gaiff ei chau. +Roedd gorgyffwrdd rhesymegol rhwng y fflag hon a'r galwad `OnBeforeClose`. +Yn v3, mae'r fflag `HideWindowOnClose` wedi'i thynnu ac mae'r galwad `OnBeforeClose` +wedi'i ailenwi i `ShouldClose`. Caiff y galwad `ShouldClose` ei galw pan fydd y +defnyddiwr yn ceisio cau ffenestr. Os bydd y galwad yn dychwelyd `true`, caiff y +ffenestr ei chau. Os yw'n dychwelyd `false`, ni chaiff y ffenestr ei chau. Gellir +ei ddefnyddio i guddio'r ffenestr yn hytrach na'i chau. + +## Llusgo Ffenestr + +Yn v2, defnyddiwyd yr ymddangosiad `--wails-drag` i nodi y gallai elfen gael ei +defnyddio i lusgo'r ffenestr. Yn v3, mae hwn wedi'i ddisodli gan `--webkit-app-region` +i fod yn fwy yn unol â'r ffordd y mae fframweithiau eraill yn ymdrin â hyn. Gellir +gosod yr ymddangosiad `--webkit-app-region` i unrhyw un o'r gwerthoedd canlynol: + +- `drag` - Gellir defnyddio'r elfen i lusgo'r ffenestr +- `no-drag` - Ni ellir defnyddio'r elfen i lusgo'r ffenestr + +Byddem wedi hoffi defnyddio `app-region`, fodd bynnag, nid yw hwn yn cael ei +gefnogi gan yr alwad `getComputedStyle` ar webkit ar macOS. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_plugins.md b/mkdocs-website/docs/cy/development/changes_plugins.md new file mode 100644 index 000000000..984c04f7e --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_plugins.md @@ -0,0 +1,33 @@ +## Ategion + +Mae ategion yn ffordd o ymestyn swyddogaeth eich cais Wails. + +### Creu ategyn + +Mae ategion yn strwythur Go safonol sy'n cydymffurfio â'r rhyngwyneb canlynol: + +```go +type Plugin interface { + Name() string + Init(*application.App) error + Shutdown() + CallableByJS() []string + InjectJS() string +} +``` + +Mae'r dull `Name()` yn dychwelyd enw'r ategyn. Defnyddir hwn at ddibenion cofnodi. + +Mae'r dull `Init(*application.App) error` yn cael ei alw pan gaiff yr ategyn ei lwytho. +Mae'r paramedr `*application.App` yn gymhwysiad y caiff yr ategyn ei lwytho iddo. Bydd unrhyw +wallau yn atal y cais rhag dechrau. + +Mae'r dull `Shutdown()` yn cael ei alw pan fydd y cais yn cau. + +Mae'r dull `CallableByJS()` yn dychwelyd rhestr o swyddogaethau alladwy y gellir eu galw o'r +blaen-wyneb. Rhaid i enwau'r dulliau hyn gyfateb yn union i enwau'r dulliau a allodir +gan yr ategyn. + +Mae'r dull `InjectJS()` yn dychwelyd JavaScript y dylid ei fewnosod i bob ffenestr wrth iddynt +gael eu creu. Mae hyn yn ddefnyddiol ar gyfer ychwanegu swyddogaethau JavaScript +cyfatebol i'r ategyn. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_systray.md b/mkdocs-website/docs/cy/development/changes_systray.md new file mode 100644 index 000000000..bb70523c7 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_systray.md @@ -0,0 +1,8 @@ +## Syscynhwysydd + +Mae Wails 3 yn dod â syscynhwysydd adeiledig-mewn. Mae hwn yn syscynhwysydd wedi'i gyflawni'n llawn sydd wedi'i ddylunio i fod mor syml â phosibl i'w ddefnyddio. Mae'n bosibl gosod yr eicon, y frawsfyriad a'r dewislen y syscynhwysydd. Mae'n bosibl hefyd "atodi" ffenestr i'r syscynhwysydd. Gan wneud hyn, bydd y swyddogaethau canlynol ar gael: + +- Clicio ar eicon y syscynhwysydd yn ymhallu gwelededd y ffenestr +- Clicio'n dde ar y syscynhwysydd yn agor y ddewislen, os oes un + +Ar macOS, os nad oes ffenestr atodedig, bydd y syscynhwysydd yn defnyddio'r dull rhagosodedig o arddangos y ddewislen (unrhyw botwm). Os oes ffenestr atodedig ond dim dewislen, bydd y syscynhwysydd yn ymhallu'r ffenestr waeth pa fotwm a wasgerir. \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_window.md b/mkdocs-website/docs/cy/development/changes_window.md new file mode 100644 index 000000000..03f095bf7 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_window.md @@ -0,0 +1,27 @@ +## Ffenestr + +Mae'r API Ffenestr wedi aros yn yr un fath i raddau helaeth, fodd bynnag mae'r dulliau yn awr ar enghraifft o ffenestr yn hytrach na'r amser gweithredu. Rhai gwahaniaeth nodedig yw: + +- Mae gan Ffenestri nawr Enw sy'n eu hadnabod. Defnyddir hyn i adnabod y ffenestr wrth yrru digwyddiadau. +- Mae gan Ffenestri lawer mwy o ddulliau ar y rhai nad oeddent ar gael o'r blaen, fel `AbsolutePosition` a `ToggleDevTools`. +- Gall Ffenestri nawr dderbyn ffeiliau drwy lusgo a gollwng brodorol. Gweler yr adran Lusgo a Gollwng am fwy o fanylion. + +### ColourCefndir + +Yn v2, roedd hwn yn bwynt i strwythur `RGBA`. Yn v3, mae hwn yn werthhRGBA` strwythur. + +### FfenestrnynTranslucent + +Mae'r fflach hon wedi'i thynnu. Erbyn hyn mae gan `BackgroundType` fflach y gellir ei defnyddio i osod y math o gefndir y dylai'r ffenestr ei chael. Gellir gosod y fflach hon i unrhyw un o'r gwerthoedd canlynol: + +- `BackgroundTypeSolid` - Bydd gan y ffenestr gefndir solet +- `BackgroundTypeTransparent` - Bydd gan y ffenestr gefndir tryloyw +- `BackgroundTypeTranslucent` - Bydd gan y ffenestr gefndir trawslucent + +Ar Windows, os yw'r `BackgroundType` wedi'i osod i `BackgroundTypeTranslucent`, gellir gosod y math o drawslucedd gan ddefnyddio'r fflach `BackdropType` yn opsiynau `WindowsWindow`. Gellir gosod hon i unrhyw un o'r gwerthoedd canlynol: + +- `Auto` - Bydd y ffenestr yn defnyddio effaith a benderfynir gan y system +- `None` - Ni fydd gan y ffenestr gefndir +- `Mica` - Bydd y ffenestr yn defnyddio'r effaith Mica +- `Acrylic` - Bydd y ffenestr yn defnyddio'r effaith acrylig +- `Tabbed` - Bydd y ffenestr yn defnyddio'r effaith tabbed \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/changes_wml.md b/mkdocs-website/docs/cy/development/changes_wml.md new file mode 100644 index 000000000..596825879 --- /dev/null +++ b/mkdocs-website/docs/cy/development/changes_wml.md @@ -0,0 +1,50 @@ +## Iaith Marcio Wails (WML) + +Mae'r Iaith Marcio Wails yn iaith farcio syml sy'n caniatáu i chi ychwanegu +swyddogaeth at elfennau HTML safonol heb ddefnyddio JavaScript. + +Mae'r tagiau canlynol yn cael eu cefnogi ar hyn o bryd: + +### `data-wml-event` + +Mae hyn yn pennu y bydd digwyddiad Wails yn cael ei allyrru pan gliciwyd ar yr +elfen. Dylai gwerth yr priodoledd fod yn enw'r digwyddiad i'w allyrru. + +Enghraifft: + +```html + +``` + +Weithiau mae angen i'r defnyddiwr gadarnhau gweithred. Gellir gwneud hyn drwy +ychwanegu'r briodoledd `data-wml-confirm` at yr elfen. Bydd gwerth y briodoledd +hwn yn fesur i'w ddangos i'r defnyddiwr. + +Enghraifft: + +```html + +``` + +### `data-wml-window` + +Gellir galw unrhyw fethododd `wails.window` drwy ychwanegu'r briodoledd +`data-wml-window` at elfen. Dylai gwerth y briodoledd fod yn enw'r +dull i'w alw. Dylai enw'r dull fod yn yr un acen â'r dull. + +```html + +``` + +### `data-wml-trigger` + +Mae'r briodoledd hwn yn pennu pa ddigwyddiad JavaScript ddylai ysgogi'r +weithred. Y rhagosodiad yw `click`. + +```html + +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/introduction.md b/mkdocs-website/docs/cy/development/introduction.md new file mode 100644 index 000000000..fdaecb8d6 --- /dev/null +++ b/mkdocs-website/docs/cy/development/introduction.md @@ -0,0 +1,220 @@ +Dyma'r cyfieithiad Cymraeg (cym) o'r testun Saesneg: + +# Cyflwyniad + +!!! note + Mae'r canllaw hwn yn gweithio ymlaen. + +Diolch am ddymuno helpu gyda datblygu Wails! Bydd y canllaw hwn yn eich helpu i +gychwyn. + +## Cychwyn + +- Cloniwch y storfa Git. Symudwch i'r gangen `v3-alpha`. +- Gosodwch y CLI: `cd v3/cmd/wails3 && go install` + +- Dewisol: Os ydych am ddefnyddio'r system adeiladu i adeiladu cod blaen, bydd + angen i chi osod [npm](https://nodejs.org/en/download). + +## Adeiladu + +Ar gyfer rhaglenni syml, gallwch ddefnyddio'r gorchymyn `go build` safonol. Mae +modd defnyddio `go run` hefyd. + +Mae Wails hefyd yn cynnwys system adeiladu y gellir ei defnyddio i adeiladu +prosiectau mwy cymhleth. Mae'n defnyddio'r system adeiladu wych +[Task](https://taskfile.dev). Am fwy o wybodaeth, gwiriwch y dudalen gartref Task +neu runnwch `wails task --help`. + +## Cynllun prosiect + +Mae'r prosiect yn cael y strwythur canlynol: + + ``` + v3 + ├── cmd/wails3 // CLI + ├── examples // Enghreifftiau o apiau Wails + ├── internal // Pecynnau mewnol + | ├── runtime // Y runtime JS Wails + | └── templates // Y templed prosiect a gynhelir + ├── pkg + | ├── application // Y llyfrgell Wails craidd + | └── events // Diffiniadau digwyddiadau + | └── mac // Cod penodol i macOS a ddefnyddir gan addasiadau + | └── w32 // Cod penodol i Windows + ├── plugins // Addasiadau a gynhelir + ├── tasks // Tasgau cyffredinol + └── Taskfile.yaml // Ffurfweddiad tasgau datblygu + ``` + +## Datblygu + +### Rhestr Tasgau Alpha + +Rydym yn monitro materion hysbys a thasgau ar hyn o bryd yn y +[Rhestr Tasgau Alpha](https://github.com/orgs/wailsapp/projects/6). Os ydych am +helpu, edrychwch ar y rhestr hon a dilyn y cyfarwyddiadau yn y +[Adborth](../getting-started/feedback.md) tudalen. + +### Ychwanegu swyddogaeth ffenestr + +Y ffordd well o ychwanegu swyddogaeth ffenestr yw ychwanegu swyddogaeth newydd i'r +ffeil `pkg/application/webview_window.go`. Dylai hon weithredu'r holl +swyddogaeth sydd ei hangen ar gyfer pob platfform. Dylid galw unrhyw god platfform +penodol drwy fethôd `webviewWindowImpl`. Gweithredir y rhyngwyneb hwn gan bob un +o'r platfformau targed i ddarparu'r swyddogaeth benodol i'r platfform. Mewn rhai +achosion, efallai na fydd yn gwneud dim. Ar ôl ychwanegu'r dull rhyngwyneb, +sicrhewch fod pob platfform yn ei weithredu. Mae'r dull `SetMinSize` yn enghraifft +dda o hyn. + +- Mac: `webview_window_darwin.go` +- Windows: `webview_window_windows.go` +- Linux: `webview_window_linux.go` + +Dylai'r rhan fwyaf, os nad y cyfan, o'r cod platfform penodol gael ei redeg ar y +prif drywydd. Er mwyn symleiddio hyn, mae nifer o ddulliau `invokeSync` wedi'u +diffinio yn `application.go`. + +### Diweddaru'r runtime + +Mae'r runtime wedi'i leoli yn `v3/internal/runtime`. Pan diweddarir y runtime, +rhaid cymryd y camau canlynol: + +```shell +wails3 task runtime:build +``` + +### Digwyddiadau + +Diffinnir digwyddiadau yn `v3/pkg/events`. Wrth ychwanegu digwyddiad newydd, rhaid +cymryd y camau canlynol: + +- Ychwanegu'r digwyddiad i'r ffeil `events.txt` +- Rhedeg `wails3 task events:generate` + +Mae nifer o fathau o ddigwyddiadau: digwyddiadau platfform penodol i'r ap a'r +ffenestr + digwyddiadau cyffredin. Mae'r digwyddiadau cyffredin yn ddefnyddiol ar +gyfer trin digwyddiadau ar draws platfformau, ond nid ydych wedi'ch cyfyngu i'r "isaf +cyffredin". Gallwch ddefnyddio'r digwyddiadau platfform penodol os oes angen i chi. + +Wrth ychwanegu digwyddiad cyffredin, sicrhewch fod y digwyddiadau platfform penodol +wedi'u mapio. Mae enghraifft o hyn yn `window_webview_darwin.go`: + +```go + // Translate ShouldClose to common WindowClosing event + w.parent.On(events.Mac.WindowShouldClose, func(_ *WindowEventContext) { + w.parent.emit(events.Common.WindowClosing) + }) +``` + +NODYN: Efallai y byddwn yn ceisio awtomeiddio hyn yn y dyfodol drwy ychwanegu'r +mapio at y diffiniad digwyddiad. + +### Addasiadau + +Mae addasiadau yn ffordd o estyn swyddogaeth eich ap Wails. + +#### Creu addasiad + +Mae addasiadau yn strwythur Go safonol sy'n cydymffurfio â'r rhyngwyneb canlynol: + +```go +type Plugin interface { + Name() string + Init(*application.App) error + Shutdown() + CallableByJS() []string + InjectJS() string +} +``` + +Mae'r dull `Name()` yn dychwelyd enw'r addasiad. Defnyddir hwn at ddibenion +cofnodi. + +Mae'r dull `Init(*application.App) error` yn cael ei alw pan gaiff yr addasiad ei +lwytho. Mae'r paramedr `*application.App` yn yr ap y caiff yr addasiad ei lwytho +iddo. Bydd unrhyw wallau yn atal yr ap rhag cychwyn. + +Gelwir y dull `Shutdown()` pan gaiff yr ap ei ddidoli. + +Mae'r dull `CallableByJS()` yn dychwelyd rhestr o swyddogaethau alladwy y gellir +eu galw o'r blaen. Rhaid i enwau'r dulliau hyn gwatsh yn union ag enwau'r dulliau +a alluogeir gan yr addasiad. + +Mae'r dull `InjectJS()` yn dychwelyd JavaScript y dylid ei fewnosod i bob ffenestr +wrth iddynt gael eu creu. Mae hyn yn ddefnyddiol ar gyfer ychwanegu swyddogaethau +JavaScript cyfaddas i'r addasiad. + +Cewch hyd i'r addasiadau mewnol yn y cyfeiriadur `v3/plugins`. Edrychwch arnynt am +ysbrydoliaeth. + +## Tasgau + +Mae'r CLI Wails yn defnyddio'r system adeiladu [Task](https://taskfile.dev). Fe'i +mewnforiwyd fel llyfrgell a'i ddefnyddio i redeg y tasgau a ddiffinnir yn +`Taskfile.yaml`. Y prif gyswllt â Task ddigwydd yn `v3/internal/commands/task.go`. + +### Uwchraddio Taskfile + +I wirio a oes diweddariad ar gyfer Taskfile, rhedwch `wails3 task -version` a +gwiriwch yn erbyn gwefan Task. + +I uwchraddio'r fersiwn o Taskfile a ddefnyddir, rhedwch: + +```shell +wails3 task taskfile:upgrade +``` + +Os oes anghydnawsedd, dylai'r rhain ymddangos yn y ffeil +`v3/internal/commands/task.go`. + +Fel arfer, y ffordd orau o drwsio anghydnawsedd yw clonio'r storfa dasg yn +`https://github.com/go-task/task` a gwirio hanes y git i benderfynu beth sydd +wedi newid a pham. + +I wirio bod yr holl newidiadau wedi gweithio'n gywir, ail-osodwch y CLI a gwirio'r +fersiwn eto: + +```shell +wails3 task cli:install +wails3 task -version +``` + +## Agor PR + +Gwnewch yn siŵr bod gan bob PR docyn cysylltiedig â nhw sy'n darparu cyd-destun y +newid. Os nad oes tocyn, crëwch un yn gyntaf. Sicrhewch fod pob PR wedi +diweddaru'r ffeil CHANGELOG.md gyda'r newidiadau a wnaed. Mae'r ffeil CHANGELOG.md +wedi'i lleoli yn y cyfeiriadur `mkdocs-website/docs`. + +## Tasgau Amrywiol + +### Uwchraddio Taskfile + +Mae'r CLI Wails yn defnyddio'r system adeiladu [Task](https://taskfile.dev). Fe'i +mewnforiwyd fel llyfrgell a'i ddefnyddio i redeg y tasgau a ddiffinnir yn +`Taskfile.yaml`. Y prif gyswllt â Task ddigwydd yn `v3/internal/commands/task.go`. + +I wirio a oes diweddariad ar gyfer Taskfile, rhedwch `wails3 task -version` a +gwiriwch yn erbyn gwefan Task. + +I uwchraddio'r fersiwn o Taskfile a ddefnyddir, rhedwch: + +```shell +wails3 task taskfile:upgrade +``` + +Os oes anghydnawsedd, dylai'r rhain ymddangos yn y ffeil +`v3/internal/commands/task.go`. + +Fel arfer, y ffordd orau o drwsio anghydnawsedd yw clonio'r storfa dasg yn +`https://github.com/go-task/task` a gwirio hanes y git i benderfynu beth sydd +wedi newid a pham. + +I wirio bod yr holl newidiadau wedi gweithio'n gywir, ail-osodwch y CLI a gwirio'r +fersiwn eto: + +```shell +wails3 task cli:install +wails3 task -version +``` \ No newline at end of file diff --git a/mkdocs-website/docs/cy/development/status.md b/mkdocs-website/docs/cy/development/status.md new file mode 100644 index 000000000..35722587a --- /dev/null +++ b/mkdocs-website/docs/cy/development/status.md @@ -0,0 +1,215 @@ +Dyma'r cyfieithiad Cymraeg (cym): + +# Statws + +Statws nodweddion yn v3. + +!!! note + + Mae'r rhestr hon yn gymysgedd o gymorth API cyhoeddus a mewnol.
+ Nid yw'n gyflawn ac efallai nad yw'n gyfoes. + +## Problemau Hysbys + +- Nid yw Linux eto ar barity nodwedd gyda Windows/Mac + +## Cymhwyster + +Dulliau rhyngwyneb cymhwyster + +| Dull | Windows | Linux | Mac | Nodiadau | +| ------------------------------------------------------------- | ------- | ----- | --- | -------- | +| run() gwall | I | I | I | | +| destroy() | | I | I | | +| setApplicationMenu(menu \*Menu) | I | I | I | | +| name() llinell | | I | I | | +| getCurrentWindowID() uint | I | I | I | | +| showAboutDialog(name llinell, description llinell, icon []byte) | | I | I | | +| setIcon(icon []byte) | - | I | I | | +| on(id uint) | | | I | | +| dispatchOnMainThread(fn func()) | I | I | I | | +| cuddio() | I | I | I | | +| dangos() | I | I | I | | +| getPrimaryScreen() (\*Screen, gwall) | | I | I | | +| getScreens() ([]\*Screen, gwall) | | I | I | | + +## Ffenestr Gwe-weld + +Dulliau Rhyngwyneb Ffenestr Gwe-weld + +| Dull | Windows | Linux | Mac | Nodiadau | +| -------------------------------------------------- | ------- | ----- | --- | ---------------------------------------- | +| canolbwyntio() | I | I | I | | +| cau() | i | I | I | | +| destroy() | | I | I | | +| execJS(js llinell) | i | I | I | | +| ffocws() | I | I | | | +| forceReload() | | I | I | | +| fullscreen() | I | I | I | | +| getScreen() (\*Screen, gwall) | i | I | I | | +| getZoom() float64 | | I | I | | +| uchder() int | I | I | I | | +| cuddio() | I | I | I | | +| isFullscreen() bool | I | I | I | | +| isMaximised() bool | I | I | I | | +| isMinimised() bool | I | I | I | | +| mwyhau() | I | I | I | | +| lleihau() | I | I | I | | +| nativeWindowHandle() (uintptr, gwall) | I | I | I | | +| on(eventID uint) | i | | I | | +| openContextMenu(menu *Menu, data *ContextMenuData) | i | I | I | | +| positionsberthol() (int, int) | I | I | I | | +| ail-lwytho() | i | I | I | | +| rhedeg() | I | I | I | | +| setAlwaysOnTop(alwaysOnTop bool) | I | I | I | | +| setBackgroundColour(color RGBA) | I | I | I | | +| setEnabled(bool) | | I | I | | +| setFrameless(bool) | | I | I | | +| setFullscreenButtonEnabled(enabled bool) | - | I | I | Nid oes botwm sgrin lawn yn Windows | +| setHTML(html llinell) | I | I | I | | +| setMaxSize(width, uchder int) | I | I | I | | +| setMinSize(width, uchder int) | I | I | I | | +| setRelativePosition(x int, y int) | I | I | I | | +| setResizable(resizable bool) | I | I | I | | +| setSize(width, uchder int) | I | I | I | | +| setTitle(title llinell) | I | I | I | | +| setURL(url llinell) | I | I | I | | +| setZoom(zoom float64) | I | I | I | | +| dangos() | I | I | I | | +| maint() (int, int) | I | I | I | | +| toggleDevTools() | I | I | I | | +| un-fullscreen() | I | I | I | | +| un-mwyhau() | I | I | I | | +| un-lleihau() | I | I | I | | +| lled() int | I | I | I | | +| chwyddo() | | I | I | | +| chwyddo() | I | I | I | | +| chwyddo() | I | I | I | | +| chwyddo() | I | I | I | | + +## Amser Gweithredol + +### Cymhwyster + +| Nodwedd | Windows | Linux | Mac | Nodiadau | +| ------- | ------- | ----- | --- | -------- | +| Gadael | I | I | I | | +| Cuddio | I | I | I | | +| Dangos | I | | I | | + +### Deialogau + +| Nodwedd | Windows | Linux | Mac | Nodiadau | +| -------- | ------- | ----- | --- | -------- | +| Gwybodaeth | I | I | I | | +| Rhybudd | I | I | I | | +| Gwall | I | I | I | | +| Cwestiwn | I | I | I | | +| OpenFile | I | I | I | | +| SaveFile | I | I | I | | + +### Clipfwrdd + +| Nodwedd | Windows | Linux | Mac | Nodiadau | +|---------|---------|-------|-----|----------| +| SetText | I | I | I | | +| Text | I | I | I | | + +### ContextMenu + +| Nodwedd | Windows | Linux | Mac | Nodiadau | +|------------------|---------|-------|-----|----------| +| OpenContextMenu | I | I | I | | +| Ar Ddiofyn | | | | | +| Rheoli drwy HTML | I | | | | + +Mae'r ddewislen cyd-destun rhagosodedig wedi'i galluogi'n rhagosodedig ar gyfer yr holl elfennau sydd â `contentEditable: true`, `` neu `