Differences between revisions 7 and 26 (spanning 19 versions)

How to upload a document file to JGW Doc

How to Upload a file

1. Access to JGW Document Database

Login name and password are required.
$/!\$ Ask any KAGRA members around you if you don't know login name and/or password.

2. Click Reserve Number or Upload Document at the top

$/!\$ In general, please use Reserve Number if possible.
- It allows for obtaining the document identification number before the upload so that one can insert the identification number in the file name for easy identification in future.
Clicking on Reserve Number, you will be transferred to the document number request page, but you don't need to upload the file in this page. You can upload your document files later. You get a JGW number here, put the number in your document and then you can upload them.
If you click on Upload, you have to upload your document in the next step. 　
The forms with a * symbol must be filled.

3. Enter the Title and Abstract

The present year will be shown by default. If this year is 2013, the document number will be G130xxxx.
- If you put other year in the document number, please put the year you like to put. For example, if you put 2009, the document number will be G090xxxx.

4. Upload the file

If you have multiple files you can select files up to 6. Please ignore Descriprion, Main section.
The file cannot be uploaded if you chose Resreve Document above. Open the page you made with reserved number on JGWDoc, then click Create a new version on the left column to upload the document.
$/!\$ Do not use Japanese character in the file name. It will cause a trouble on the system, and files can not be uploaded.

5. Document Type

Please select G for the normal presentation and T for the technical documents. This classification of Document Type will be the first letter of the document number you will get later.
$/!\$ You cannot change the document number once you get the number. (Please do not hesitate to get a new number if you make a mistake.)

6. Submitter and Authors

When you select names, you see so many names. If you type the name rapidly, you can jump to the target name directly.
$/!\$ You can pick up multiple authors by control key for Windows, command key for Mac.
$/!\$ You can register your name if you do not see your name in the Authors list. From Top page, click the Authors in the middle, then click (Add a new author) on the 3rd line. In the case if you do not see your institute name, please contact to Osamu. Currently only administrator can add institute names.

7. View

"Public" will be selected by default and the document will be open to public.
Chose "upload" or "upload and admin" in the case that you would like to open only to KAGRA collaborators.

8. Modify

Modify defines groups which can update documents later.
Usually, please choose "upload" or "upload and admin".
$/!\$ If you selected only "admin", documents cannot be updated without asking administrator.
$/!\$ Do not select only "update" for view and only "admin" for Modify. Anybody won't be able to update the documents after all because documents cannot be seen with admin authority and cannot be updated with upload authority. We don't have any solution of this problem so far.

9. Topics

Select at least one topic.
Select Management if necessary.
Select "conference" for big conferences or international conferences and "meeting" for other small meetings.
Ask Osamu if you would like to add other items.

10. Enter Related Documents (if you have need)

Enter 'docid' in the box of Related Documents if you have any related documents.
'docid' is the paticular 1-5 digits number which is attached to each document. Please refer to the explanation below.
You can refer to multiple related documents by putting multiple docid separated by space.
It is convenient that referred documents can have automatically links from which referred.

Please fill in other items by your self.

Currently, you cannot delete files because of the security reasons even if you upload by mistake. Please contact Osmau when you need to delete the file by some reason. Also, you cannot delete or change the document number once you get. When you get a number by mistake, don't hesitate to get a new number again.

How to Check, Update and Modify files

1. Put your name in the search box on the top page (click "DocDB Home" on top in any page of JGWDoc)

2. Or select the uploaded document from the list shown if you click "List Recen Changes" on top page .

You have succeeded in uploading If the document you uploaded is shown.
Direct URL will be like http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18.
- Last docid=XXXX is the particular document number.

3. Click "Create a new version" on the left of the page if you want to update your documents.

The similar page when you uploaded will be shown, so please select and upload new files.
$/!\$ If you cannot see "Create a new version", probably you selected "admin" in 'Modify' section when you uploaded or reserved a number. (If you do not see, "upload" on "Modifarable by" in the right column. Then please contact Osamu.)

4. If you have some small change for abstract or adding authors etc. just click "Change DB Info" in the left column on the page.

All the information shown in this page are for private access. They have "private" after "cgi-bin" of "http://...". People who don't have the right to upload can not see the private pages.

In order to show the pages to people who don't have the right to upload, tell them the link deleted "private" from the address above. Then they will be able to access the page.

For example, if the address of private files is :
- http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18
It will be :
- http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=18
when you selected "upload", not "public" page will not be open to the public even somebody access directly to the file page.

-  ⇤ ← Revision 7 as of 2013-07-03 17:35:13 → 
  Size: 9763
  Editor: MihokoOkinaka
  Comment:
+   ← Revision 26 as of 2019-02-23 11:24:52 → ⇥
  Size: 6807
  Editor: KiwamuIzumi
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 8:
-   *Fill in your login name/password.
   *Ask any KAGRA members when you don't know your login name/password.
+   * Login name and password are required.
   . /!\ Ask any KAGRA members around you if you don't know login name and/or password.
 Line 11:
-. ''' Click ''Reserve Number'' or ''Upload Document'' above '''
   *If you click ''Reserve Number'', you can get a Document number.  You don't need to upload the file then, you can upload the document file by getting a number and putting it in the document. 
   *If you click ''Upload'', you go to the webpage for uploading directly. Then you have to upload the file inevitably.   　
      * /!\ Please upload with ''Reserve Number'' if possible so that we can recognize the document by the number even later.   
   * items with * are indispensable.
+. ''' Click ''Reserve Number'' or ''Upload Document'' at the top '''
   . /!\ In general, please use ''Reserve Number'' if possible. 
     * It allows for obtaining the document identification number before the upload so that one can insert the identification number in the file name for easy identification in future.   
   * Clicking on ''Reserve Number'', you will be transferred to the document number request page, but you don't need to upload the file in this page. You can upload your document files later. You get a JGW number here, put the number in your document and then you can upload them.
   * If you click on ''Upload'', you have to upload your document in the next step.   　

   * The forms with a * symbol must be filled.
-Line 18:
+Line 20:
-   * Japanese capable.
   * The present year will be in by default if you don't enter any.
   * The Doc number of the year 2009 will be G0900xxx. Past documents, for example the one written in 2003, please enter 2003. Then it will be G0300xxx.
+   * The present year will be shown by default. If this year is 2013, the document number will be G130xxxx.
    * If you put other year in the document number, please put the year you like to put. For example, if you put 2009, the document number will be G090xxxx.
-Line 22:
+Line 23:
-. ''' Choose the file '''
   * Plural files can be chosen. ''Descriprion'', ''Main'' can be as it is.
   * The file cannot be uploaded by choosing ''Resreve Document'' above and reserve a number. Open the number on JGWDoc again after reserving and click '' Create a new version '' on the left to upload the document. 
   * /!\ Do not use Japanese for the file name. It will cause garbling and the file can not be uploaded properly.
+. ''' Upload the file '''
   * If you have multiple files you can select files up to 6. Please ignore ''Descriprion'', ''Main'' section.
   * The file cannot be uploaded if you chose ''Resreve Document'' above. Open the page you made with reserved number on JGWDoc, then click '' Create a new version '' on the left column to upload the document. 
   * /!\ Do not use Japanese character in the file name. It will cause a trouble on the system, and files can not be uploaded.
-Line 27:
+Line 28:
-. ''' Chose the Document Type '''
   * Choose G for the normal presentation and T for the documents. This classification of Document Type will be the first letter of the document number which will be given later.
   * /!\ You cannot change the document number once you get.(Please get a new number if you make a mistake.)
+. ''' Document Type '''
   * Please select G for the normal presentation and T for the technical documents. This classification of Document Type will be the first letter of the document number you will get later.
   * /!\ You cannot change the document number once you get the number. (Please do not hesitate to get a new number if you make a mistake.)
-Line 31:
+Line 32:
-. ''' Chose the Submitter and Authors '''
   * /!\ You can chose prural authors by the control key for Windows, command for Mac.
   * /!\ You can register your name when you can't find in the Authors list. The list in the middle of [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/DocumentDatabase|Top page]]: Click the [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ListAuthors|Authors]] below and then [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/AuthorAddForm|(Add a new author)]] on the 3rd line. Please let Dr. Miyakawa if you can't find your institute.
+. ''' Submitter and Authors '''
   * {i} When you select names, you see so many names. If you type the name rapidly, you can jump to the target name directly.
 Line 35:
-. ''' Chose View '''
   * "Public" is chosen by default and the document will be open to public.
+   * /!\ You can pick up multiple authors by control key for Windows, command key for Mac.
   * /!\ You can register your name if you do not see your name in the Authors list. From [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/DocumentDatabase|Top page]], click the [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ListAuthors|Authors]] in the middle, then click [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/AuthorAddForm|(Add a new author)]] on the 3rd line. In the case if you do not see your institute name, please contact to Osamu. Currently only administrator can add institute names.

7. ''' View '''
   * "Public" will be selected by default and the document will be open to public.
-Line 39:
+Line 42:
-. ''' Chose Modify '''
+. ''' Modify '''
-Line 41:
+Line 44:
-   * Usually, chose "upload" or "upload and admin".
   * /!\ If you chose only "admin", documents cannot be updated without asking administrator.
   * /!\ Do not chose only "update" for view, "admin" for Modifi. You won't be able to update the documents after all because documents cannot be seen with admin authority and cannot be updated with upload authority. We don't have the solution of this problem so far.
+   * Usually, please choose "upload" or "upload and admin".
   * /!\ If you selected only "admin", documents cannot be updated without asking administrator.
   * /!\ Do not select only "update" for view and only "admin" for Modify. Anybody won't be able to update the documents after all because documents cannot be seen with admin authority and cannot be updated with upload authority. We don't have any solution of this problem so far.
-Line 45:
+Line 48:
-. ''' Chose Topics '''
   * Chose at least one topics.
   * Chose Management if neccesary.
   * Chose "conference" for big conferences or international conferences and "meeting" for other smaller meetings.
   * Ask Dr. Miyakawa when you would like to add other items.
+. ''' Topics '''
   * Select at least one topic.
   * Select Management if necessary.
   * Select "conference" for big conferences or international conferences and "meeting" for other small meetings.
   * Ask Osamu if you would like to add other items.
-Line 51:
+Line 54:
-. ''' Enter Related Documents(if needed) '''
   * Enter docid in the box of ''Related Documents'' if any.
   * Docid is the paticular 1-5 digits number which is attached to each document.  Please refer to the explanation below.
   * You can refer to plural related documents by punctuating with a space.
+. ''' Enter Related Documents (if you have need) '''
   * Enter 'docid' in the box of ''Related Documents'' if you have any related documents.
   * 'docid' is the paticular 1-5 digits number which is attached to each document.  Please refer to the explanation below.
   * You can refer to multiple related documents by putting multiple docid separated by space.
   * {i} It is convenient that referred documents can have automatically links from which referred.

Please fill in other items by your self.

Currently, you cannot delete files because of the security reasons even if you upload by mistake. Please contact Osmau when you need to delete the file by some reason. Also, you cannot delete or change the document number once you get. When you get a number by mistake, don't hesitate to get a new number again.
-Line 58:
+Line 65:
-. '''Related Documentsの入力（もしあれば）'''
  * もし関連した文書があれば、''Related Documents''の欄に関連文書のdoc10. ''' Enter Related Documents(if needed) '''
   * Enter docid in the box of ''Related Documents'' if any.
   * Docid is the paticular 1-5 digits number which is attached to each document.  Please refer to the explanation below.
   * You can refer to plural related documents by punctuating with a space.idを入れて下さい。
  * docidについては下にも説明がありますが、個々の文書に付いている1-5桁の固有の番号です。
  * スペースで区切ることで複数の関連文書を参照できます。
  * {i} 参照された側も、どこから参照されたのか表示されるので非常に便利です。


その他の項目は、適時自分で入れて下さい。

なお、現在のところ間違えてアップしたファイルがあってもセキュリティー上の理由で、ファイルを削除できないようにしています。どうしてもファイルを消したいという場合はマニュアルでファイルを直接操作して消すことはできるの、宮川までご連絡ください。また、一度とったDocment番号は消すことや、あとから変更することはできません。もし来間違って番号をとってしまった場合は気にせずに、新しい番号を取り直して下さい。
-Line 75:
+Line 69:
-次にアップした文書の確認と更新ですが、
+. '''Put your name in the search box on the top page (click "DocDB Home" on top in any page of JGWDoc)'''
-Line 77:
+Line 71:
-. '''トップページ（上部のDocDB Homeを押す）の検索に自分の名前を入れる。'''
  1. ''' もしくは上部のList Recen Changes等から出てきたリストから今アップした文書を選択。'''
   * 自分がアップしたファイル名が表示されていればアップロード成功です。
   * アドレスは{{{http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18}}} のような形になります。
    * 最後のdocidが個々の文書番号になります。
+. '''Or select the uploaded document from the list shown if you click "List Recen Changes" on top page .'''
   * You have succeeded in uploading If the document you uploaded is shown.
   * Direct URL will be like {{{http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18}}}.
      Last docid=XXXX is the particular document number.
-Line 83:
+Line 76:
-. '''文書の更新は今のページで左にあるCreate a new versionというのを押して下さい。'''
   * アップロード時と同様の画面になるのでファイルを新たに選択してアップして下さい。
   * /!\ もしこのCreate a new versionが出てこない場合は登録時にModifyにupload以外を選んでしまった場合(同ページ右のModifarable byのところに「upload」と出てなければそうです)ですので、その場合は宮川までご連絡ください。
+. '''Click "Create a new version" on the left of the page if you want to update your documents.'''
   * The similar page when you uploaded will be shown, so please select and upload new files.
   * /!\ If you cannot see "Create a new version", probably you selected "admin" in 'Modify' section when you uploaded or reserved a number. (If you do not see, "upload" on "Modifarable by" in the right column. Then please contact Osamu.)
-Line 87:
+Line 80:
-. '''ちょっとしたアブストラクトの更新や著者の追加等は、同じページ左のChange DB Infoから行えます。'''

{i} ここで紹介したページは全てアップロード専用ページです。違いはhttp://...のcgi-binのあとにprivateがあるかないかです。
アップロード権限を持っていない人はprivete領域を見ることができません。

{i} 一般の人にも見えるようにするためには、以下のようにアドレスからprivateという部分を削除したリンクを知らせて下さい。そうすると、アップロード権限のない一般の方もアクセスできるようになります。

 . 例えば今置いた文書があるページのアドレスが

  . {{{ http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18 }}}
 . なら

  . {{{ http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=18 }}}

 . となります。アップロード時、Viewに「public」でなく、「upload」を選んだ時はprivateがアドレスに入っているときのみ見えて、入ってないと見えなくなるので一般の人には公開されません。それも確認してみて下さい。
+. '''If you have some small change for abstract or adding authors etc. just click "Change DB Info" in the left column on the page.'''
-Line 104:
+Line 83:
-= Wiki等からJGWDoc内の文書にリンクを張りたい場合 =
+{i} All the information shown in this page are for private access. They have "private" after "cgi-bin" of "http://...". People who don't have the right to upload can not see the private pages.
-Line 106:
+Line 85:
-まず、
+{i} In order to show the pages to people who don't have the right to upload, tell them the link deleted "private" from the address above. Then they will be able to access the page.
-Line 108:
+Line 87:
-[[http://gwwiki.icrr.u-tokyo.ac.jp/JGWwiki/newusers]]
+    For example, if the address of private files is :
     http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=18
-Line 110:
+Line 90:
-を見て、wikiへの書き込み権限を得てから、例えば以下のようにwikiページ内に書き込んで下さい。
+    It will be :
     http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=18
-Line 112:
+Line 93:
- {{{
 * [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=30|LCGT design document Ver 3.0]]
}}}

{{{ [[ }}}と{{{ ]] }}}に囲まれた部分がリンク先となります。| (縦線)をいれると、|のあとの文書のみが表示され、|以前の部分は表示されません。例えば上の例はJGW番号T0900030のLCGT design documentへのリンクが張られています。docid=30の所の30という番号をT0900030の下の桁の30という番号は一致します。このように書くと常に最新バージョンにリンクが張られます。ある特定のバージョンにリンクを張りたい場合等は

 {{{
 * [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=30&version=1|LCGT design document old version]]
}}}

等として下さい。

また、ファイルを公開したくない場合でJGWDocのViewrableオプションをPublic以外（upload等）にした場合は

 {{{
 * [[http://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/private/DocDB/ShowDocument?docid=30|LCGT design document Ver 3.0]]
}}}

というように/cgi-binと/DocDBのあいだに/privateというのを入れて下さい。するとファイルにアクセスするときにIDとパスワードが要求されます。



=== Wikiへの書き込み方の例　--会議等の場合-- ===
 * [[LCGT/Meeting/f2f/upload|LCGT Face to Face meeting]]
 * [[LCGT/Meeting/f2f/uploadE|LCGT Face to Face meeting(English)]]


----
以上ですが、何か不具合があったり、分からないこと等ありましたら、お気軽に宮川までご連絡下さい。
+    when you selected "upload", not "public" page will not be open to the public even somebody access directly to the file page.