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