Make Rails Documents SEO(Search Engine Optimized)

5919537a0ecfa5d4dea704cf878ae90e?s=47 toshimaru
February 22, 2019

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/

5919537a0ecfa5d4dea704cf878ae90e?s=128

toshimaru

February 22, 2019
Tweet

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