Hi,
I add tutorial into the website, and it is implemented in the existing PR#204 https://github.com/apache/incubator-iotdb/pull/204 <https://github.com/apache/incubator-iotdb/pull/204>. ------------------ ???????? ------------------ ??????: "Xiangdong Huang"<[email protected]>; ????????: 2019??6??26??(??????) ????11:29 ??????: "dev"<[email protected]>; ????: Re: Small bugs of official website Hi, Thanks very much! How about add the tutorial into the website? I think it is better than current instruction [1]. :D [1] http://iotdb.apache.org/#/Development#contributing-by-documentation-changes#contributing-by-documentation-changes ----------------------------------- Xiangdong Huang School of Software, Tsinghua University ?????? ???????? ???????? ?????? <[email protected]> ??2019??6??26?????? ????11:10?????? > Sure, here is a brief tutorial: > > > 1. Suppose we have "chapter 1:Overview" already, and want to add a new > document "A.md" in chapter 1. > Then, > Step 1: add document named "5-A.md" in folder "1-Overview", since it is > the fifth section in this chapter; > Step 2: modify "0-Content.md" file by adding "* 5-A.md" in the list of > "# Chapter 1: Overview". > > > 2. Suppose we want to create a new chapter "chapter7: RoadMap", and want > to add a new document "B.md" in chapter 7. > > Then, > Step 1: create a new folder named "7-RoadMap", and add document named > "1-B.md" in folder "7-RoadMap"; > Step 2: modify "0-Content.md" file by adding "# Chapter 7: RoadMap" in > the end, and adding "* 1-B.md" in the list of this new chapter. > > > Whenever updating User Guide documents, remember to update "0-Content.md" > in the same time. > With any questions about the process, don't hesitate to ask me. > > > > > Thanks and Best Regards, > Zesong Sun > > > > > ------------------ ???????? ------------------ > ??????: "Xiangdong Huang"<[email protected]>; > ????????: 2019??6??26??(??????) ????9:03 > ??????: "dev"<[email protected]>; > > ????: Re: Small bugs of official website > > > > Hi, > > Sounds great. > Can you write a brief tutorial to introduce how to add new documents or how > to modify existing documents? > > Best, > ----------------------------------- > Xiangdong Huang > School of Software, Tsinghua University > > ?????? > ???????? ???????? > > > ?????? <[email protected]> ??2019??6??25?????? ????9:11?????? > > > Hi, > > > > > > To solve the problems, I firstly reorganized the files of documents in > > Repository incubator-iotdb, by separating them into different chapter > > folders. I also added "content.md" to show the content of documents more > > clearly. > > > > > > Then, in Repository incubator-iotdb-website, I changed documents url > > pattern from "/sec" to "/chap/sec", so that the router won't jump to 404 > > after refreshing the website; The loading of nav sidebar content is > > according to "content.md", instead of fixed file names. Therefore, in the > > future, when the documents are updated frequently, the codes of the > website > > needn't be changed. > > > > > > I also refactor the codes according to the change above, because some > > methods will be useless. > > > > > > This fix is implemented in > > * PR#204 https://github.com/apache/incubator-iotdb/pull/204 < > > https://github.com/apache/incubator-iotdb/pull/204> in Repository > > incubator-iotdb; > > * PR#20 https://github.com/apache/incubator-iotdb-website/pull/20 < > > https://github.com/apache/incubator-iotdb-website/pull/20> in Repository > > incubator-iotdb-website. > > > > > > ------------------ ???????? ------------------ > > ??????: "Xiangdong Huang"<[email protected]>; > > ????????: 2019??6??24??(??????) ????10:16 > > ??????: "dev"<[email protected]>; > > > > ????: Re: Small bugs of official website > > > > > > > > Hi Zesong, > > > > Thanks very much for your contribution! > > > > And I notice that the Home page has many syntax errors... I have > submitted > > a PR for fixing that.. > > > > I am not a VUE guy so that I can not help you with fixing the issues you > > mentioned... > > > > Look forward to your achievement! > > > > Best, > > ----------------------------------- > > Xiangdong Huang > > School of Software, Tsinghua University > > > > ?????? > > ???????? ???????? > > > > > > ?????? <[email protected]> ??2019??6??24?????? ????8:34?????? > > > > > Hi, > > > > > > My name is Zesong Sun. Recently I noticed IoTOB and am very interested > in > > > the project. > > > > > > When I looked up through the official website, I found there were some > > > little bugs in document page ( > > > https://iotdb.apache.org/#/Documents/latest/sec1). > > > > > > > > > > > > Firstly, the nav sidebar content of all chapter names are fixed by > codes > > ( > > > > > > https://github.com/apache/incubator-iotdb-website/blob/master/src/components/Global.vue > > ), > > > so if the documents are changed in the future frequently, codes of the > > > website would be updated manually, which is very inconvenient. > > > > > > > > > Besides, clicking the elements in nav sidebar cannot jump to right > > > position in some case. > > > > > > > > > I'd like to refactor the codes of the website to fix these small > > problems. > > > > > > > > > > > > > > > Best Regards, > > > Zesong Sun
