Sphinxで大量にドキュメントを手軽に作るための工夫/20200610-stapy-sphinx

by opelab

Slide 1

Slide 1 text

Operation Lab ӡ༻ઃܭϥϘ ӡ༻ઃܭϥϘ߹ಉձࣾ 4QIJOYͰ େྔʹυΩϡϝϯτΛखܰʹ࡞ΔͨΊͷ޻෉ 1 ΈΜͳͷ1ZUIPOษڧձ γχΞΞʔΩςΫτ೾ా໺༟Ұ

Slide 2

Slide 2 text

֓ཁ 4QIJOY͸ɺ஌ࣝ΍ܦݧͷΠϯϓοτͱΞ΢τϓοτΛߏ଄ԽͰ͖Δ ڧྗͳπʔϧͰ͢ɻ͕࣌ؒແ͍ͱ͖͸؆୯ͳߏ଄ͰϝϞ͓͖ͯ͠ɺ ͕࣌ؒऔΕΔͱ͖ʹ͔ͬ͠Γߏ଄Խͯ͋͛͠Δ͜ͱͰɺࣗ෼ͷ҉໧ తͳ஌ࣝ΍෺ͷݟํ͕ΈΔΈΔߏ଄Խ͞Ε͍͖ͯ·͢ɻ ೔ຊ6/*9Ϣʔβձ೥݄ษڧձʮυΩϡϝϯτΛ࡞Γͨ͘ ͳͬͯ͠·͏ຐ๏ͷπʔϧ4QIJOYʯ ߨࢣौ઒͞Μɺࢁޱ͞Μɺਗ਼ ਫ઒͞Μ Λ͖͔͚ͬʹ4QIJOYΛ࢖͍͸͡Ίɺ೥ؒ਺ઍͷߏ଄Խυ ΩϡϝϯτΛॻ͘ͳ͔Ͱ΍͖ͬͯͨʮ4QIJOYΛ࢖͏্Ͱͷ޻෉ʯʹ ͍͓ͭͯ࿩͠͠·͢ɻ Operation Lab ӡ༻ઃܭϥϘ 2

Slide 3

Slide 3 text

Operation Lab ӡ༻ઃܭϥϘ ࢲͱӡ༻खॱॻ 3 ‣ ೥୅લ൒໷ؒ࡞ۀ࣌ͷࣗ෼͕৴͡ΒΕͳ͍ͷͰɺ ट͔ΒԼͰ࣮ߦͰ͖ΔखॱॻΛ࡞੒ ‣ ೥୅ޙ൒खॻ͖9.-94-5 YTMUQSPD ͰΠϯ ΫϧʔυՄೳͳखॱॻΛ࡞੒ ೥ఔ౓Ͱ࠳ં ‣ ೥4QIJOYͱग़ձ͍ɺखॱॻͷߏ଄ԽΛਐΊΔɻ ‣ ݱࡏ໿ʙ೥ͷखॱॻΛಠΓͰ࡞੒ɻ ʮڀۃͷӡ༻खॱॻʯΛ௥͍ٻΊΔ׆ಈΛ͍ͯ͠·͢ ࣗݾ঺հͱηογϣϯ֓ཁ

Slide 4

Slide 4 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ׆ಈݚڀձ࿦จ 4 ࣗݾ঺հͱηογϣϯ֓ཁ IUUQTXXXOJDBEKQJXQSPHSBNU *OUFSOFU8FFLυΩϡϝϯτηογϣϯ 4QIJOY

Slide 5

Slide 5 text

• ೔ຊͷ"84ϢʔβίϛϡχςΟͷҰͭɻ • ڵຯର৅͸ɺ6OJpFE"84$-* • ઃཱ • "844VNNJU%BZ • ։࠵ճ ϋϯζΦϯճ υΩϡϝϯτ׆ಈ+"846($-*ઐ໳ࢧ෦ ϋϯζΦϯ͋ͨΓͷखॱॻ ࣗݾ঺հͱηογϣϯ֓ཁ • ฏۉ໿ຕ • ࠷େຕ ͜͜Λ͖͔͚ͬʹΫϥ΢υస৬͢Δਓଟ਺

Slide 6

Slide 6 text

Operation Lab ӡ༻ઃܭϥϘ ༨ஊ"84$-*ެࣜϦϑΝϨϯε 6

Slide 7

Slide 7 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ׆ಈݚڀձ࿦จ 7 ిࢠ௨৴৘ใֶձ ৘ใॲཧֶձ ࣗݾ঺հͱηογϣϯ֓ཁ

Slide 8

Slide 8 text

શͯ4QIJOY͕͋Δ͔ΒͰ͖ͨ • *OUFSOFU8FFL • +"846($-*ઐ໳ࢧ෦ • ݚڀձ࿦จ Operation Lab ӡ༻ઃܭϥϘ 8

Slide 9

Slide 9 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ͷաڈɺݱࡏɺະདྷ 9

Slide 10

Slide 10 text

Operation Lab ӡ༻ઃܭϥϘ ೥൒લʹॻ͍ͨهࣄ 10 https://rsh.csh.sh/misc/20121209-sphinx.html

Slide 11

Slide 11 text

Operation Lab ӡ༻ઃܭϥϘ Ԗච υΩϡϝϯτ࡞੒ͷաڈɺݱࡏ 11 ೖग़ྗͷ෼཭ لݩલ೥ࠒʙ ੈل຤ खॻ͖ ๽ච ໦൛ҹ࡮ ׆൛ҹ࡮ ฏ൘ҹ࡮ λΠϓϥΠλʔ ϫʔϓϩ Ճ޻֓೦ͷ஀ੜ ਵ࣌ग़ྗ ࢴ ϓϦϯλʔ ηϚϯςΟοΫ8FC ೪౔൘ɺ໦؆ ೖྗ ग़ྗ ੈلޙ൒ لݩલ೥ࠒʙ ੈلޙ൒ ੈلதࠒ ੈلࠒ ೖग़ྗҰମ ੈل຤ࠒ Ճ޻ͱग़ྗͷࣗಈԽ 8FC ੈلॳ಄ ೖྗٕज़ ग़ྗٕज़ Ճ޻ٕज़ ݻఆେྔग़ྗ ࢴ ·ͩखೖྗ͕લఏ

Slide 12

Slide 12 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ͷݱࡏ͔Βະདྷ΁ 12 ηϚϯςΟοΫ8FC Ճ޻ͱग़ྗͷࣗಈԽ 8FC ੈلॳ಄ ೖྗٕज़ ग़ྗٕज़ Ճ޻ٕज़ ͕͜͜ະͩ खॻ͖ɾखೖྗ ೖྗ ग़ྗ ʮυΩϡϝϯτͷશͯΛਓ͕ॻ͘ʯͱ͍͏؍೦͔Βͷ୤٫͕ඞཁ ਓͷखͰશͯॻ͜͏ͱ͢Δ͔Β ʮυΩϡϝϯτݏ͍ʯʹͳΔ

Slide 13

Slide 13 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ͷະདྷXJUI4QIJOY 13 ೖྗٕज़ ग़ྗٕज़ Ճ޻ٕज़ ೖྗ ग़ྗ reSTructured Text Parser Builder Theme reSTructured Text ਓ͕ॻ͘ ػց͕ॻ͘ Ϛγϯ • υΩϡϝϯτͷ͏ͪɺਓ͕ॻ͘෦෼ͱɺػցʹॻ͔ͤΔ෦෼Λҙࣝతʹ෼཭͢Δɻ • ػցʹॻ͔ͤΔυΩϡϝϯτΛ໌֬ʹ͢Δ • $47΍:".-ͳͲͷՄಡੑͷߴ͍ߏ଄Խσʔλ • ݴޠͷώΞυΩϡϝϯτػೳͰੜ੒Ͱ͖Δσʔλ • ੲ͸ɺ9.-΋༗ޮͩͬͨ • ػցʹॻ͔ͤͨυΩϡϝϯτύʔπΛɺਓ͕ॻ͍ͨυΩϡϝϯτ͔ΒΠϯΫϧʔυ͢Δɻ

Slide 14

Slide 14 text

Operation Lab ӡ༻ઃܭϥϘ ͱ͋ΔKVTษڧձ ೥݄ 14 TTNKQ ૑ઃऀ ӡ༻υΩϡϝϯτॻ͘ͷΩϥΠ )BUBOP ΄͍ͬ ӡ༻υΩϡϝϯτॻ͘ͷ௒ָ͍͠XXXX

Slide 15

Slide 15 text

Operation Lab ӡ༻ઃܭϥϘ ͜Ε͸িܸͷCFGPSFBGUFSͩͬͨ 15 TTNKQ ૑ઃऀ ӡ༻υΩϡϝϯτॻ͘ͷ ΩϥΠ ӡ༻υΩϡϝϯτॻ͘ͷ ௒ָ͍͠XXXX

Slide 16

Slide 16 text

Operation Lab ӡ༻ઃܭϥϘ ݸਓతʹ΋ 16 ӡ༻υΩϡϝϯτॻ͘ͷ ௒ָ͍͠XXXX )BUBOP υΩϡϝϯτͷΞ΢τϓοτޮ཰͸ഒऑʹ ೥ҎલͱҎ߱ͷൺֱ ೥ؒϖʔδऑWT೥ϖʔδऑ

Slide 17

Slide 17 text

Operation Lab ӡ༻ઃܭϥϘ ʮυΩϡϝϯτͷશͯΛਓ͕ॻ͘ʯ ͱ͍͏؍೦͔Βͷ୤٫ 17

Slide 18

Slide 18 text

Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ΛਓͱػցͰ෼୲͢Δ 18 • υΩϡϝϯτͷ͏ͪɺਓ͕ॻ͘෦෼ͱɺػցʹॻ͔ͤΔ෦෼Λҙࣝతʹ෼཭͢Δɻ • ػցʹॻ͔ͤΔυΩϡϝϯτΛ໌֬ʹ͢Δ • $47΍:".-ͳͲͷՄಡੑͷߴ͍ߏ଄Խσʔλ • ݴޠͷώΞυΩϡϝϯτػೳͰੜ੒Ͱ͖Δσʔλ • ੲ͸ɺ9.-΋༗ޮͩͬͨ • ػցʹॻ͔ͤͨυΩϡϝϯτύʔπΛɺਓ͕ॻ͍ͨυΩϡϝϯτ͔ΒΠϯΫϧʔυ͢Δɻ 4QIJOYͷΠϯΫϧʔυػೳ͕ڧྗ 4QIJOYͷஔ׵ػೳ͕ڧྗ ೖྗٕज़ ग़ྗٕज़ Ճ޻ٕज़ ೖྗ ग़ྗ reSTructured Text reSTructured Text ਓ͕ॻ͘ ػց͕ॻ͘ Ϛγϯ

Slide 19

Slide 19 text

Operation Lab ӡ༻ઃܭϥϘ ͲͷΑ͏ʹਓͱػցͰ෼୲͢Δ͔ 19 ਓ͕ॻ͘ ػց͕ॻ͘ Ϛγϯ ਓʹ͔͠ॻ͚ͳ͍෦෼Λॻ͘ ਓ͕ॻ͔ͳͯ͘΋ྑ͍ͱ͜ΖΛ ॻ͘ ʮػց͕ॻ͚Δͱ͜ΖΛॻ͘ʯͩͱ͍ͭ·Ͱܦͬͯ΋ ਓ͕ॻ͘υΩϡϝϯτ͸ݮΒͳ͍ গ͠ແཧͯ͠΋ػցʹॻ͔ͤΔ

Slide 20

Slide 20 text

Operation Lab ӡ༻ઃܭϥϘ ʮػցʹυΩϡϝϯτΛॻ͔ͤΔʯ 20

Slide 21

Slide 21 text

ػցʹॻ͔ͤΔ ࣗ෼ͷ৔߹ • ώΞυΩϡϝϯτ • DBUίϚϯυ • TFEίϚϯυ • ඪ४ग़ྗΛϑΝΠϧʹϦμΠϨΫτ Operation Lab ӡ༻ઃܭϥϘ 21 γΣϧͷجຊػೳͰे෼ʹՄೳ

Slide 22

Slide 22 text

4QIJOYͷॏཁͳػೳ • ΠϯΫϧʔυػೳ • JODMVEF SF45ϑΝΠϧΛΠϯΫϧʔυ͢Δ • MJUFSBMJODMVEF ιʔείʔυΛΠϯΫϧʔυ͢Δ • DTWUBCMF DTWϑΝΠϧΛΠϯΫϧʔυ͢Δ • ஔ׵ػೳ • ςϯϓϨʔτͷಛఆͷ৔ॴΛॻ͖׵͑ͯग़ྗͰ͖Δ • UPDUSFF • จॻߏ଄ΛܾΊΔ Operation Lab ӡ༻ઃܭϥϘ 22

Slide 23

Slide 23 text

Operation Lab ӡ༻ઃܭϥϘ ʮͲ͏ߏ଄Խ͢Δ͔ʯΛৗʹߟ͑Δ 23

Slide 24

Slide 24 text

ʮͲ͏ߏ଄Խ͢Δ͔ʯΛৗʹߟ͑Δ͜ͱ͕େࣄ Operation Lab ӡ༻ઃܭϥϘ 24 https://rsh.csh.sh/misc/20121209-sphinx.html ߏ଄ԽΛ͢Ε͹ɺͦͷ޻਺ʹݟ߹ͬͨ੒Ռ͕ಘΒΕΔ ਓͱػցͰυΩϡϝϯτ࡞੒ͷ෼୲͕Ͱ͖Δ ͦ͏ɺ4QIJOYͳΒ͹ɺͶ

Slide 25

Slide 25 text

ʮͲ͏ߏ଄Խ͢Δ͔ʯΛৗʹߟ͑Δ͜ͱ͕େࣄ Operation Lab ӡ༻ઃܭϥϘ 25 4QIJOYͰυΩϡϝϯτΛॻ͍͍ͯΔͱ ಄ͷத͕ͲΜͲΜߏ଄Խ͞Ε͍ͯ͘ ग़ྗ͕ඒ͘͠ͳ͍৔߹͸ɺߏ଄͕͓͔͍͠

Slide 26

Slide 26 text

Operation Lab ӡ༻ઃܭϥϘ σϞ 26

Slide 27

Slide 27 text

Operation Lab ӡ༻ઃܭϥϘ ·ͱΊ 27

Slide 28

Slide 28 text

·ͱΊେྔʹυΩϡϝϯτΛखܰʹ࡞Δ • ਓͱػցͰ෼୲͢Δ • γΣϧίϚϯυͰ΋े෼ʹڧྗ • ʮͲ͏ߏ଄Խ͢Δ͔ʯΛৗʹߟ͑Δ͜ͱ͕େࣄ Operation Lab ӡ༻ઃܭϥϘ 28

Slide 29

Slide 29 text

Operation Lab ӡ༻ઃܭϥϘ 29 খٶ͞Μɺਗ਼ਫ઒͞Μ ͓ੈ࿩ʹͳ͍ͬͯ·͢

Slide 30

Slide 30 text

Operation Lab ӡ༻ઃܭϥϘ એ఻ 30

Slide 31

Slide 31 text

• 3&$جૅ • 3&$جૅ ".* • 3*".ೖ໳ • 3*".جૅ *".ϙϦγʔ • 3*".جૅ *".ϩʔϧ • 3*".جૅ ΠϯελϯεϓϩϑΝΠϧ ্݄० એ఻+"846($-*ઐ໳ࢧ෦ΦϯϥΠϯ ࣗݾ঺հͱηογϣϯ֓ཁ खॱॻ͸શͯ4QIJOYͰ࡞੒

Slide 32

Slide 32 text

Operation Lab ӡ༻ઃܭϥϘ ࢀߟաڈͷൃදࢿྉ 32 IUUQTXXXPQTMBCKQQVCMJTI աڈͷൃදࢿྉ͸ 0QT-BCKQͱ͍͏αΠτʹஔ͍ͯ͋Γ·͢ɻ

Slide 33

Slide 33 text

Operation Lab ӡ༻ઃܭϥϘ 33 IUUQXXXPQFSBUJPOMBCDPKQ OperationLab ӡ༻ઃܭ