edge
Daugiau informacijos rubyonrails.org: Daugiau apie Ruby on Rails

Ruby on Rails vadovai (75b9e4f)

Tai yra Edge vadovai, pagrįsti main@75b9e4f.

Jei ieškote stabilios versijos vadovų, prašome patikrinti https://guides.rubyonrails.org vietoje.

Vadovai ankstesnėms versijoms: Rails 7.0, Rails 6.1, Rails 6.0, Rails 5.2, Rails 5.1, Rails 5.0, Rails 4.2, Rails 4.1, Rails 4.0, Rails 3.2, Rails 3.1, Rails 3.0, ir Rails 2.3.

Vadovai, pažymėti šiuo piktograma, šiuo metu yra darbuojami ir nebus prieinami vadovų indekso meniu. Nors jie vis tiek yra naudingi, jie gali turėti nepilną informaciją ir net klaidas. Jūs galite padėti peržiūrėdami juos ir pateikdami savo komentarus ir pataisymus.

Pradėkite čia

Pradėkite su Rails

Viskas, ko jums reikia žinoti, kad įdiegtumėte Rails ir sukurtumėte savo pirmąją programą.

Modeliai

Aktyvusis įrašas: pagrindai

Active Record leidžia jūsų modeliams sąveikauti su programos duomenų baze. Šis vadovas padės jums pradėti naudoti Active Record modelius ir išsaugoti duomenis į duomenų bazę.

Aktyvusis įrašo migracijos

Migracijos yra Active Record funkcija, kuri leidžia jums evoliucionuoti duomenų bazės schemą laikui bėgant. Vietoje to, kad rašytumėte schemos modifikacijas grynais SQL, migracijos leidžia jums naudoti Ruby DSL, kad aprašytumėte pakeitimus savo lentelėse.

Aktyvusis įrašo patikrinimas

Validacijos naudojamos tam, kad užtikrintų, jog į jūsų duomenų bazę būtų įrašomi tik teisingi duomenys. Šis vadovas moko, kaip patikrinti objektų būseną prieš juos įrašant į duomenų bazę, naudojant Active Record validacijų funkciją.

Aktyviųjų įrašų atgaliniai kvietimai

Atgalinės iškvietimai leidžia rašyti kodą, kuris bus vykdomas kiekvieną kartą, kai objektas yra sukurtas, atnaujinamas, sunaikinamas ir t.t. Šis vadovas moko, kaip prisijungti prie šio objekto gyvavimo ciklo veiksmų su Active Record objektais.

Aktyvusis įrašo asociacijos

Active Record'e asociacija yra ryšys tarp dviejų Active Record modelių. Šis vadovas apima visas asociacijas, kurias teikia Active Record.

Aktyvusis įrašo užklausos sąsaja

Vietoje naudojimo žalią SQL norint rasti duomenų bazės įrašus, Active Record teikia geresnius būdus atlikti tas pačias operacijas. Šis vadovas apima skirtingus būdus gauti duomenis iš duomenų bazės naudojant Active Record.

Aktyvaus modelio pagrindai

Active Model leidžia jums kurti paprastus Ruby objektus, kurie integruojasi su Action Pack, bet nereikalauja Active Record duomenų bazės išliekamumui. Active Model taip pat padeda kurti pasirinktinius ORMs, skirtus naudoti už Rails karkaso ribų. Šis vadovas suteikia viską, ko jums reikia, norint pradėti naudoti Active Model klases.

Pareiškimai

Veiksmo peržiūros apžvalga

Veiksmo rodinys atsakingas už HTML generavimą interneto atsakymams. Šis vadovas suteikia įvadą į Veiksmo rodinį.

Maketavimas ir atvaizdavimas „Rails“

Šis vadovas apima pagrindines Action Controller ir Action View išdėstymo funkcijas, įskaitant atvaizdavimą ir nukreipimą, naudojant content_for blokus ir dirbant su daliniais.

Veiksmų peržiūros pagalbininkai

Veiksmo peržiūra turi pagalbinius įrankius, skirtus viskam nuo datos formatavimo ir nuorodų į paveikslėlius, iki turinio dezinfekavimo ir lokalizavimo. Šis vadovas pristato keletą dažniau naudojamų Veiksmo peržiūros pagalbinių įrankių.

Veiksmo peržiūros formos pagalbininkai

HTML formos gali greitai tapti nuobodžios rašyti ir palaikyti dėl poreikio tvarkyti formos valdiklio pavadinimą ir jo daugybę atributų. "Rails" pašalina šią sudėtingumą, teikdamas vaizdo pagalbininkus, skirtus generuoti formos žymėjimą.

Valdikliai

Veiksmų valdiklio apžvalga

Veiksmų valdikliai yra pagrindinė internetinio užklausos dalis „Rails“ karkase. Šis vadovas aprašo, kaip veikia valdikliai ir kaip jie įsijungia į jūsų programos užklausos ciklą. Jame aptariamos sesijos, filtrai, slapukai, duomenų srautai ir kaip tvarkyti užklausos metu iškeltus išimtis, tarp kitų temų.

Rails maršrutizavimas iš išorės į vidų

Rails maršrutizatorius atpažįsta URL adresus ir nukreipia juos į valdiklio veiksmą. Šis vadovas apima Rails maršrutizavimo vartotojui matomas funkcijas. Jei norite suprasti, kaip naudoti maršrutizavimą savo pačiame Rails aplikacijoje, pradėkite čia.

Kiti komponentai

Aktyvusis palaikymas - pagrindiniai plėtiniai

Active Support teikia Ruby kalbos plėtinius ir įrankius. Jis papildo Ruby kalbą, skirtą „Rails“ programų kūrimui, taip pat ir Ruby on Rails pačiam kūrimui.

Veiksmų siuntimo pagrindai

Šis vadovas suteikia jums viską, ko jums reikia pradėti siųsti el. laiškus iš savo programos ir daugybę Action Mailer vidinių funkcijų.

Veiksmų pašto dėžutės pagrindai

Šis vadovas aprašo, kaip naudoti Action Mailbox gauti el. laiškus.

Action Text apžvalga

Šis vadovas aprašo, kaip naudoti Action Text, kad būtų galima tvarkyti turtingo formato turinį.

Aktyvios užduoties pagrindai

Aktyvus darbas yra karkasas, skirtas deklaruoti fono darbus ir juos paleisti įvairiose eilės pagrindinėse sistemose. Šis vadovas suteikia jums viską, ko jums reikia pradėti kurti, įtraukti į eilę ir vykdyti fono darbus.

Aktyvaus saugojimo apžvalga

Aktyvus saugojimas palengvina failų įkėlimą į debesų saugojimo paslaugą, transformuoja įkėlimus ir išgauna metaduomenis. Šis vadovas aprašo, kaip pridėti failus prie jūsų aktyviųjų įrašų modelių.

Action Cable apžvalga

Veiksmo kabelis integruoja WebSocket su visomis jūsų „Rails“ programos dalimis. Tai leidžia rašyti realaus laiko funkcijas „Ruby“ kalba taip pat, kaip ir visą jūsų „Rails“ programą. Šis vadovas paaiškina, kaip veikia veiksmo kabelis ir kaip naudoti WebSocket, kad sukurtumėte realaus laiko funkcijas.

Webpacker

Šis vadovas parodys, kaip įdiegti ir naudoti Webpacker, kad supakuotumėte JavaScript, CSS ir kitus turinius kliento pusėje savo Rails aplikacijoje.

Giliau kasant

Rails Internationalizacijos (I18n) API

Šis vadovas aprašo, kaip pridėti internacionalizaciją prie savo programų. Jūsų programa galės išversti turinį į skirtingas kalbas, keisti daugiskaitos taisykles, naudoti teisingus datos formatavimus kiekvienai šaliai ir t.t.

Rails aplikacijų testavimas

Tai yra gana išsamus vadovas apie įvairias testavimo priemones „Rails“ karkase. Jame aptariama viskas nuo „Kas yra testas?“ iki integracinio testavimo. Mėgaukitės.

Rails aplikacijų saugumas

Šis vadovas aprašo dažnai pasitaikančius saugumo problemas interneto aplikacijose ir kaip jų išvengti naudojant Rails.

Klaidų pranešimai „Rails“ programose

Šis vadovas pristato būdus, kaip valdyti išimtis, kurios atsiranda Ruby on Rails programose.

Rails aplikacijų derinimas

Šis vadovas aprašo, kaip derinti Rails aplikacijas. Jis apima skirtingus būdus, kaip tai pasiekti, ir kaip suprasti, kas vyksta "užkulisiuose" jūsų kodo.

Konfigūruojant „Rails“ aplikacijas

Šis vadovas apima pagrindinius konfigūracijos nustatymus „Rails“ programai.

Rails Komandinė eilutė

Yra keletas komandų, kurios yra absoliučiai būtinos jūsų kasdieniam „Rails“ naudojimui. Šis vadovas apima komandinės eilutės įrankius, kurie yra pateikiami „Rails“.

Turtinio turto linija

Turtinio aktyvų linija teikia pagrindą sujungti ir sumažinti arba suspausti JavaScript, CSS ir vaizdo aktyvus. Ji taip pat suteikia galimybę rašyti šiuos aktyvus kitomis kalbomis ir pirmaujančiomis programomis, tokiomis kaip CoffeeScript, Sass ir ERB.

Dirbant su JavaScript „Rails“

Šis vadovas paaiškina, kaip naudoti importavimo žemėlapius arba jsbundling-rails, kad įtrauktumėte „JavaScript“ į „Rails“ programas ir aptartumėte pagrindinius darbą su „Turbo“ „Rails“ aspektus.

Rails Inicializacijos Procesas

Šis vadovas paaiškina Rails inicializacijos proceso vidinius veiksmus. Tai yra labai išsamus vadovas, rekomenduojamas patyrusiems Rails programuotojams.

Automašinų įkėlimas ir perkrovimas

Šis vadovas dokumentuoja, kaip veikia automatinis įkėlimas ir konstantų perkrovimas (Zeitwerk režime).

Klasikinio režimo pereinamasis prie Zeitwerk HOWTO

Šis vadovas dokumentuoja, kaip perkelti Rails aplikacijas iš `classic` į `zeitwerk` režimą.

Podėliavimas su Rails: Apžvalga

Šis vadovas yra įvadas į jūsų "Rails" aplikacijos pagreitinimą su talpinimu.

Aktyvusis palaikymo instrumentavimas

Šis vadovas paaiškina, kaip naudoti instrumentavimo API, esantį Active Support, norint matuoti įvykius Rails ir kitame Ruby kode.

Naudodami „Rails“ API programoms

Šis vadovas paaiškina, kaip efektyviai naudoti Rails kurti JSON API programą.

Aktyvusis įrašas ir PostgreSQL

Šis vadovas apima PostgreSQL specifinį Active Record naudojimą.

Kelių duomenų bazių naudojimas su Active Record

Šis vadovas aprašo, kaip naudoti kelias duomenų bazes savo aplikacijoje.

Aktyvusis įrašo šifravimas

Šis vadovas aprašo, kaip užšifruoti savo duomenų bazės informaciją naudojant Active Record.

Išplėsti Rails

Rails pluginų pagrindai

Šis vadovas aprašo, kaip sukurti įskiepį, kuris išplečia Rails funkcionalumą.

Rails ant Rack

Šis vadovas apima Rails integraciją su Rack ir sąveiką su kitais Rack komponentais.

Kuriamas ir pritaikomas „Rails“ generatoriai ir šablonai

Šis vadovas aprėpia naujo generatoriaus pridėjimo procesą prie jūsų plėtinio arba alternatyvos teikimą įmontuoto Rails generatoriaus elementui (pvz., alternatyvių testavimo šablonų teikimas šablonų generatoriui).

Pradėkime su varikliais

Varikliai gali būti laikomi miniatiūrinėmis programomis, kurios suteikia papildomą funkcionalumą savo pagrindinėms programoms. Šiame vadove sužinosite, kaip sukurti savo pačių variklį ir jį integruoti su pagrindine programa.

Rails aplikacijų šablonai

Programos šablonai yra paprasti Ruby failai, kuriuose yra DSL (Domain Specific Language) pridėtiems gemams, inicializavimo failams ir kt., į jūsų naujai sukurtą Rails projektą arba esamą Rails projektą.

Gijimo ir kodo vykdymas „Rails“

Šis vadovas aprašo svarstymus ir įrankius, kurie yra naudojami tiesiogiai dirbant su konkurencija „Rails“ programoje.

Prisidedant

Prisidėjimas prie Ruby on Rails

Rails nėra "kito žmogaus karkasas". Šis vadovas apima įvairias būdas, kaip galite dalyvauti nuolatinėje Rails plėtros veikloje.

API Dokumentacijos Gairės

Šis vadovas dokumentuoja Ruby on Rails API dokumentacijos gaires.

Ruby on Rails Gidų gairės

Šis vadovas dokumentuoja Ruby on Rails vadovų gaires.

Įdiegiant "Rails Core" plėtros priklausomybes

Šis vadovas aprašo, kaip sukurti aplinką Ruby on Rails pagrindiniam programiniam įrangos kūrimui.

Politikos

Ruby on Rails priežiūros politika

Kokios versijos Ruby on Rails šiuo metu palaikomos, ir kada galima tikėtis naujų versijų.

Išleidimo pastabos

Ruby on Rails atnaujinimas

Šis vadovas pateikia žingsnius, kurie turi būti laikomi atnaujinant jūsų programinę įrangą iki naujesnės Ruby on Rails versijos.

Ruby on Rails 7.1 Išleidimo pastabos

Leidimo pastabos dėl Rails 7.1.

Ruby on Rails 7.0 Išleidimo Pastabos

Išleidimo pastabos Rails 7.0 versijai.

Ruby on Rails 6.1 Išleidimo pastabos

Išleidimo pastabos Rails 6.1.

Ruby on Rails 6.0 Išleidimo Pastabos

Išleidimo pastabos Rails 6.0 versijai.

Ruby on Rails 5.2 Išleidimo pastabos

Išleidimo pastabos Rails 5.2.

Ruby on Rails 5.1 Išleidimo pastabos

Išleidimo pastabos Rails 5.1.

Ruby on Rails 5.0 Išleidimo pastabos

Išleidimo pastabos Rails 5.0 versijai.

Ruby on Rails 4.2 Išleidimo pastabos

Išleidimo pastabos Rails 4.2.

Ruby on Rails 4.1 Išleidimo pastabos

Išleidimo pastabos dėl Rails 4.1.

Ruby on Rails 4.0 Išleidimo pastabos

Išleidimo pastabos Rails 4.0.

Ruby on Rails 3.2 Išleidimo pastabos

Išleidimo pastabos Rails 3.2.

Ruby on Rails 3.1 Išleidimo pastabos

Išleidimo pastabos Rails 3.1.

Ruby on Rails 3.0 Išleidimo pastabos

Išleidimo pastabos Rails 3.0.

Ruby on Rails 2.3 Išleidimo pastabos

Išleidimo pastabos Rails 2.3 versijai.

Ruby on Rails 2.2 Išleidimo Pastabos

Išleidimo pastabos Rails 2.2 versijai.

Atsiliepimai

Jūs esate skatinami padėti pagerinti šio vadovo kokybę.

Prašome prisidėti, jei pastebite rašybos klaidų ar faktinių klaidų. Norėdami pradėti, galite perskaityti mūsų dokumentacijos prisidėjimo skyrių.

Taip pat gali būti nepilnos informacijos arba informacijos, kuri nėra atnaujinta. Prašome pridėti bet kokią trūkstamą dokumentaciją pagrindiniam. Patikrinkite Edge vadovus pirmiausia, ar problemas jau išspręsta arba ne pagrindinėje šakoje. Patikrinkite Ruby on Rails vadovų gaires dėl stiliaus ir konvencijų.

Jei dėl kokios nors priežasties pastebite kažką, ką reikia ištaisyti, bet negalite patys tai pataisyti, prašome pranešti apie problemą.

Ir galiausiai, bet ne mažiau svarbu, bet koks diskusijos dėl Ruby on Rails dokumentacijos yra labai laukiamos oficialiame Ruby on Rails forume.