Make Rails Documents SEO(Search Engine Optimized)

Slide 1

Slide 1 text

Make Rails Documents SEO(Search Engine Op9mized) 2019/02/22 Roppongi.rb #8 Roppongi.rb #8 1

Slide 2

Slide 2 text

self-introduc.on • toshimaru • Roppongi.rb چ? Organizer • Rails Engineer / Engineer Manager Roppongi.rb #8 2

Slide 3

Slide 3 text

࿩͢͜ͱ • ެ͕ࣜఏڙ͍ͯ͠ΔRailsυΩϡϝϯτͷSEOʹ͍ͭͯ ࿩͞ͳ͍͜ͱ • ҰൠతͳRailsΞϓϦέʔγϣϯͷSEOʹ͍ͭͯ • SEOͷͨΊͷࡉ͔͍ςΫχΧϧͳ࿩ Roppongi.rb #8 3

Slide 4

Slide 4 text

ಥવͰ͕͢ ͜Μͳܦݧ͸͋Γ·ͤΜ͔ʁ Roppongi.rb #8 4

Slide 5

Slide 5 text

ʮAc#veRecordͷupdateϝιου Ͳ͏࢖͏Μ͚ͩͬʯ Roppongi.rb #8 5

Slide 6

Slide 6 text

ʮάάΔ͔ʯ Roppongi.rb #8 6

Slide 7

Slide 7 text

Roppongi.rb #8 7

Slide 8

Slide 8 text

Roppongi.rb #8 8

Slide 9

Slide 9 text

Roppongi.rb #8 9

Slide 10

Slide 10 text

Roppongi.rb #8 10

Slide 11

Slide 11 text

Roppongi.rb #8 11

Slide 12

Slide 12 text

! Roppongi.rb #8 12

Slide 13

Slide 13 text

SEOŧŔŕŪũƄŝſ WEBŚƃŢƄŬźͱͯ͠ɺ Rails ؔ࿈ͷݕࡧΫΤϦͰ ࠷దͳ݁Ռ͕ฦΔੈքʹ͍ͨ͠ɻ Roppongi.rb #8 13

Slide 14

Slide 14 text

࠷దͳ݁Ռ • OﬃcialʢެࣜͰ͋Δʣ • Accurateʢਖ਼֬Ͱ͋Δʣ • Latestʢ࠷৽Ͱ͋Δʣ Roppongi.rb #8 14

Slide 15

Slide 15 text

Rails Oﬃcial Documents? Roppongi.rb #8 15

Slide 16

Slide 16 text

Let's see rubyonrails.org Roppongi.rb #8 16

Slide 17

Slide 17 text

Roppongi.rb #8 17

Slide 18

Slide 18 text

Roppongi.rb #8 18

Slide 19

Slide 19 text

Rails Documents 1. rubyonrails.org 2. weblog.rubyonrails.org 3. guides.rubyonrails.org 4. api.rubyonrails.org Roppongi.rb #8 19

Slide 20

Slide 20 text

weblog.rubyonrails.org Roppongi.rb #8 20

Slide 21

Slide 21 text

Roppongi.rb #8 21

Slide 22

Slide 22 text

weblog.rubyonrails.org • Jekyllʹͯߏங • ྑ͍ײ͡ʹSEO͢Δjekyll-seo-tagΛಋೖ • ͦͷଞjekyll-feed, jekyll-sitemapΛαΠτʹ௥Ճ Roppongi.rb #8 22

Slide 23

Slide 23 text

rubyonrails.org Roppongi.rb #8 23

Slide 24

Slide 24 text

Roppongi.rb #8 24

Slide 25

Slide 25 text

rubyonrails.org • Jekyllʹͯߏங • ྑ͍ײ͡ʹSEO͢Δjekyll-seo-tagΛಋೖ (thanks to @benbalter) Roppongi.rb #8 25

Slide 26

Slide 26 text

guides.rubyonrails.org Roppongi.rb #8 26

Slide 27

Slide 27 text

Roppongi.rb #8 27

Slide 28

Slide 28 text

guides.rubyonrails.org • SNSදࣔରࡦͱͯ͠ϕʔγοΫͳOGPΛઃఆ • ಠࣗʹRailsΨΠυΛੜ੒͍ͯ͠Δʢnot JekyllʣͨΊࡉ͔ͳSEO νϡʔχϯά·Ͱ͸΍͍ͬͯͳ͍... Roppongi.rb #8 28

Slide 29

Slide 29 text

api.rubyonrails.org Roppongi.rb #8 29

Slide 30

Slide 30 text

ಥવͷϝϯγϣϯ!!!1 1 h$ps:/ /github.com/rails/rails/issues/27633 Roppongi.rb #8 30

Slide 31

Slide 31 text

! Roppongi.rb #8 31

Slide 32

Slide 32 text

How to Generate Site • rake rdoc ίϚϯυͰυΩϡϝϯτ ੜ੒ • ੒Ռ෺͸ doc/rdoc ʹు͔ΕΔ • υΩϡϝϯτੜ੒ʹ͸ sdoc gem͕࢖ ΘΕ͍ͯΔ $ cd rails $ rake rdoc Roppongi.rb #8 32

Slide 33

Slide 33 text

sdoc͕ు͘HTMLΛ ΠδΕ͹ྑͦ͞͏ Roppongi.rb #8 33

Slide 34

Slide 34 text

ΠδͬͯΈͨ ! "# Roppongi.rb #8 34

Slide 35

Slide 35 text

அ೦... Roppongi.rb #8 35

Slide 36

Slide 36 text

sdocਏ͍ͱ͜Ζ • ΞΫςΟϒʹϝϯς͞Εͯͳ͍ • iframeʹΑΔϨΠΞ΢τ: URLͰγΣΞ͠΍͘͢͢ΔͨΊʹϨΠ Ξ΢τΛ౷߹͍͕ͤͨ͞େ͖ͳมߋ͕ඞཁ • ݹΊ͔͍͠Rubyίʔυϕʔε: travis.ymlʹRuby1.9.3ͷจࣈ • RailsҎ֎ͷීวతͳϢʔεέʔεΛ૝ఆ͍ͯ͠ΔͷͰഁյతม ߋ͕Ճ͑ʹ͍͘ Roppongi.rb #8 36

Slide 37

Slide 37 text

ιϦϡʔγϣϯ sdocΛfolkͯ͠৽͍͠αΠτΛߏங Roppongi.rb #8 37

Slide 38

Slide 38 text

࡞ͬͯΈͨ Roppongi.rb #8 38

Slide 39

Slide 39 text

Roppongi.rb #8 39

Slide 40

Slide 40 text

railsdoc.github.io Roppongi.rb #8 40

Slide 41

Slide 41 text

railsdoc.github.io • α(Alpha)όʔδϣϯͱ࣮ͯ͠ݧతʹެ։த • jekyllͰߏஙͯ͠GitHub PagesͰެ։ • folk൛sdoc͕jekyllͷsourceͱͳΔHTMLΛు͘ߏ଄ Roppongi.rb #8 41

Slide 42

Slide 42 text

ݱঢ় • ·ͩίʔυϕʔε੔උத ! ʢະ࣮૷෦෼͕ଟ͋͘Γ·͢ʣ • Pull Request is not very welcomed • Feature Request is welcomed # • Կ͔ϦΫΤετ͋Ε͹ΠγϡʔʹͲ͏ͧ • URL: github.com/railsdoc/railsdoc.github.io Roppongi.rb #8 42

Slide 43

Slide 43 text

ࠓޙʢߏ૝ʣ • folk൛sdoc͡Όͳ͍ಠࣗͷυΩϡϝϯτੜ੒gemΛ࡞Γ͍ͨ • Ͳ͏͏·͘railsͱΠϯςάϨʔγϣϯͤ͞Δ͔͕՝୊ • railsଆͰ࣋ͬͯΔAPIυΩϡϝϯτੜ੒ͷϏδωεϩδοΫΛണ ͕͍ͨ͠ Roppongi.rb #8 43

Slide 44

Slide 44 text

·ͱΊ document SEO build rubyonrails.org ̋ jekyll weblog.rubyonrails.org ̋ jekyll guides.rubyonrails.org ˚ Railsಠࣗ api.rubyonrails.org ✕ Railsಠࣗ railsdoc.github.io ?ʢ͕Μ͹Γ·͢!ʣ jekyll Roppongi.rb #8 44

Slide 45

Slide 45 text

Thank You! Roppongi.rb #8 45