Make Rails Documents SEO(Search Engine Optimized)

Roppongi.rb #8 での発表資料です。
https://roppongirb.connpass.com/event/118218/

Blog: https://blog.toshimaru.net/make-rails-documents-seo-search-engine-optimized/

現在αバージョンとして公開している railsdoc.github.io を紹介しています。
https://railsdoc.github.io/

Transcript

1. Make Rails Documents SEO(Search Engine Op9mized) 2019/02/22 Roppongi.rb #8 Roppongi.rb #8 1
2. self-introduc.on • toshimaru • Roppongi.rb چ? Organizer • Rails Engineer / Engineer Manager Roppongi.rb #8 2
3. ࿩͢͜ͱ • ެ͕ࣜఏڙ͍ͯ͠ΔRailsυΩϡϝϯτͷSEOʹ͍ͭͯ ࿩͞ͳ͍͜ͱ • ҰൠతͳRailsΞϓϦέʔγϣϯͷSEOʹ͍ͭͯ • SEOͷͨΊͷࡉ͔͍ςΫχΧϧͳ࿩ Roppongi.rb #8 3
4. ಥવͰ͕͢ ͜Μͳܦݧ͸͋Γ·ͤΜ͔ʁ Roppongi.rb #8 4
5. ʮAc#veRecordͷupdateϝιου Ͳ͏࢖͏Μ͚ͩͬʯ Roppongi.rb #8 5
6. ʮάάΔ͔ʯ Roppongi.rb #8 6
7. Roppongi.rb #8 7
8. Roppongi.rb #8 8
9. Roppongi.rb #8 9
10. Roppongi.rb #8 10
11. Roppongi.rb #8 11
12. ! Roppongi.rb #8 12
13. SEOŧŔŕŪũƄŝſ WEBŚƃŢƄŬźͱͯ͠ɺ Rails ؔ࿈ͷݕࡧΫΤϦͰ ࠷దͳ݁Ռ͕ฦΔੈքʹ͍ͨ͠ɻ Roppongi.rb #8 13
14. ࠷దͳ݁Ռ • OfficialʢެࣜͰ͋Δʣ • Accurateʢਖ਼֬Ͱ͋Δʣ • Latestʢ࠷৽Ͱ͋Δʣ Roppongi.rb #8 14
15. Rails Official Documents? Roppongi.rb #8 15
16. Let's see rubyonrails.org Roppongi.rb #8 16
17. Roppongi.rb #8 17
18. Roppongi.rb #8 18
19. Rails Documents 1. rubyonrails.org 2. weblog.rubyonrails.org 3. guides.rubyonrails.org 4. api.rubyonrails.org Roppongi.rb #8 19
20. weblog.rubyonrails.org Roppongi.rb #8 20
21. Roppongi.rb #8 21
22. weblog.rubyonrails.org • Jekyllʹͯߏங • ྑ͍ײ͡ʹSEO͢Δjekyll-seo-tagΛಋೖ • ͦͷଞjekyll-feed, jekyll-sitemapΛαΠτʹ௥Ճ Roppongi.rb #8 22
23. rubyonrails.org Roppongi.rb #8 23
24. Roppongi.rb #8 24
25. rubyonrails.org • Jekyllʹͯߏங • ྑ͍ײ͡ʹSEO͢Δjekyll-seo-tagΛಋೖ (thanks to @benbalter) Roppongi.rb #8 25
26. guides.rubyonrails.org Roppongi.rb #8 26
27. Roppongi.rb #8 27
28. guides.rubyonrails.org • SNSදࣔରࡦͱͯ͠ϕʔγοΫͳOGPΛઃఆ • ಠࣗʹRailsΨΠυΛੜ੒͍ͯ͠Δʢnot JekyllʣͨΊࡉ͔ͳSEO νϡʔχϯά·Ͱ͸΍͍ͬͯͳ͍... Roppongi.rb #8 28
29. api.rubyonrails.org Roppongi.rb #8 29
30. ಥવͷϝϯγϣϯ!!!1 1 h$ps:/ /github.com/rails/rails/issues/27633 Roppongi.rb #8 30
31. ! Roppongi.rb #8 31
32. How to Generate Site • rake rdoc ίϚϯυͰυΩϡϝϯτ ੜ੒ • ੒Ռ෺͸ doc/rdoc ʹు͔ΕΔ • υΩϡϝϯτੜ੒ʹ͸ sdoc gem͕࢖ ΘΕ͍ͯΔ $ cd rails $ rake rdoc Roppongi.rb #8 32
33. sdoc͕ు͘HTMLΛ ΠδΕ͹ྑͦ͞͏ Roppongi.rb #8 33
34. ΠδͬͯΈͨ ! "# Roppongi.rb #8 34
35. அ೦... Roppongi.rb #8 35
36. sdocਏ͍ͱ͜Ζ • ΞΫςΟϒʹϝϯς͞Εͯͳ͍ • iframeʹΑΔϨΠΞ΢τ: URLͰγΣΞ͠΍͘͢͢ΔͨΊʹϨΠ Ξ΢τΛ౷߹͍͕ͤͨ͞େ͖ͳมߋ͕ඞཁ • ݹΊ͔͍͠Rubyίʔυϕʔε: travis.ymlʹRuby1.9.3ͷจࣈ • RailsҎ֎ͷීวతͳϢʔεέʔεΛ૝ఆ͍ͯ͠ΔͷͰഁյతม ߋ͕Ճ͑ʹ͍͘ Roppongi.rb #8 36
37. ιϦϡʔγϣϯ sdocΛfolkͯ͠৽͍͠αΠτΛߏங Roppongi.rb #8 37
38. ࡞ͬͯΈͨ Roppongi.rb #8 38
39. Roppongi.rb #8 39
40. railsdoc.github.io Roppongi.rb #8 40
41. railsdoc.github.io • α(Alpha)όʔδϣϯͱ࣮ͯ͠ݧతʹެ։த • jekyllͰߏஙͯ͠GitHub PagesͰެ։ • folk൛sdoc͕jekyllͷsourceͱͳΔHTMLΛు͘ߏ଄ Roppongi.rb #8 41
42. ݱঢ় • ·ͩίʔυϕʔε੔උத ! ʢະ࣮૷෦෼͕ଟ͋͘Γ·͢ʣ • Pull Request is not very welcomed • Feature Request is welcomed # • Կ͔ϦΫΤετ͋Ε͹ΠγϡʔʹͲ͏ͧ • URL: github.com/railsdoc/railsdoc.github.io Roppongi.rb #8 42
43. ࠓޙʢߏ૝ʣ • folk൛sdoc͡Όͳ͍ಠࣗͷυΩϡϝϯτੜ੒gemΛ࡞Γ͍ͨ • Ͳ͏͏·͘railsͱΠϯςάϨʔγϣϯͤ͞Δ͔͕՝୊ • railsଆͰ࣋ͬͯΔAPIυΩϡϝϯτੜ੒ͷϏδωεϩδοΫΛണ ͕͍ͨ͠ Roppongi.rb #8 43
44. ·ͱΊ 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
45. Thank You! Roppongi.rb #8 45