Julien, Thanks for looking into this issue. I had a chat with Trevor (LF) on IRC about this topic. We came up with the following proposal to discuss in the next Infra WG meeting (I've added this to the agenda)
Proposal: 0) Goal is to reduce duplication of documentation for labs as we have both rst files in the Pharos.git repo and on with Wiki. 1) Labs should be documented in the Pharos.git repository via pod_description.rst and lab_description.rst files. 2) those rst files produce artifact pages(his effort is tracked via PHAROS-29 task) 3) those artifact pages can be linked from the Pharos Community Labs wiki page[1] 4) Pharos team would work with lab owners to reduce the duplicate content currently found as sub-pages under the Community labs page [1] https://wiki.opnfv.org/display/pharos/Community+Labs On 09/12/2016 12:24 AM, zhang.ju...@zte.com.cn (mailto:zhang.ju...@zte.com.cn) wrote: Hi All, In last INFRA WG meeting, there is a suggestion that no directly editing WIKI pages of Pharos Labs, but editing the original files in Pharos repo and then including these documents in repo or rendered files in artifact's website. There is a AP for me to have some test and try for ZTE Lab . In confluence it can not render rst files directly and no plugin available in the https://marketplace.atlassian.com/. I try to use "HTML Include" macro to include the artifacts(http://artifacts.opnfv.org/pharos/colorado/docs/labs_zte-sh-lab-single/index.html) for ZTE Pharos lab(https://wiki.opnfv.org/display/pharos/ZTE+SH+Testlab). Most of the content of artifacts can be imported correctly except the issues bellow: #1 Pictures, "HTML Include" Macro can not imported the static pictures in Artifacts. Can we use another plugin in the market(https://marketplace.atlassian.com/plugins/com.javahollic.confluence.plugins.html-include-replace/server/overview). It can import the static files, Iframe and selectively include remote css and scripts. #2 css class/format The default css table format in the artifacts is "docutils", but it does not exist in confluence. The default css table format in confluence is "confluenceTable". If the new plugin(html-include-replace) is added, the "css" issue will we resolved together, or it will take some time to add the default css format in DOCS project. Regards, Julien [IMAGE] [IMAGE] [IMAGE] Julien(Jun) Zhang D206(D2028), R&D Building, ZTE Plaza, #889, Bibo RD, NFV Architect Pudong District, Shang Hai, P.R.China, 201203 Julien(Jun) Zhang T:+86 21 68897791 M:+86 15317680806 F:+86 21 50801070 NFV Architect E: zhang.ju...@zte.com.cn (mailto:zhang.ju...@zte.com.cn) G: julien...@gmail.com (mailto:julien...@gmail.com) www.zte.com.cn (ZTE), www.opnfv.org (OPNFV) D206(D2028), R&D Building, ZTE Plaza, #889, Bibo RD, Pudong District, Shang Hai, P.R.China, 201203 T:+86 21 68897791 M:+86 15317680806 F:+86 21 50801070 E: zhang.ju...@zte.com.cn (mailto:zhang.ju...@zte.com.cn) G: julien...@gmail.com (mailto:julien...@gmail.com) www.zte.com.cn (ZTE), www.opnfv.org (OPNFV) -- Jack Morgan OPNFV Pharos Intel Lab
_______________________________________________ opnfv-tech-discuss mailing list opnfv-tech-discuss@lists.opnfv.org https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss