| 1 |
53334
|
alessia.ba
|
@author: Alessia Bardi
|
| 2 |
|
|
@date: 28 September 2018
|
| 3 |
|
|
@title: Info on how to update documentation and changelog for api.openaire.eu
|
| 4 |
|
|
|
| 5 |
|
|
1)---- DOCUMENTATION UPDATE ---
|
| 6 |
|
|
You just need to simply modify the html files on your local copy of https://svn.driver.research-infrastructures.eu/driver/dnet45/modules/dnet-api-http-doc/
|
| 7 |
|
|
|
| 8 |
|
|
2)---- READ THIS BEFORE COMMITTING ON SVN ----
|
| 9 |
|
|
Do you want your log message to be visible on http://api.openaire.eu/changelog.html?
|
| 10 |
|
|
Yes --> Then commit with a nice message that will be publicly available and go to step 3 (example: new API parameter, new schema version)
|
| 11 |
|
|
No --> Start your log message with the keyword PRIVATE (capital letters) and go to step 4 (typo fixed, changes to this file)
|
| 12 |
|
|
|
| 13 |
|
|
3)---- UPDATE changelog.html ----
|
| 14 |
|
|
So, you have committed and you want to update the changelog so that your log message will appear in http://api.openaire.eu/changelog.html.
|
| 15 |
|
|
To generate an updated changelist of this documentation as html page, run the following commands on your local machine:
|
| 16 |
|
|
|
| 17 |
|
|
cd dnet-api-http-doc/src
|
| 18 |
|
|
svn log -v --xml https://svn.driver.research-infrastructures.eu/driver/dnet45/modules/dnet-api-http-doc | xsltproc svnlog2html.xslt - > ./changelog.html
|
| 19 |
|
|
svn commit -m "PRIVATE : updated changelist"
|
| 20 |
|
|
|
| 21 |
|
|
Now you can go to step 4
|
| 22 |
|
|
|
| 23 |
|
|
4)---- PUBLISH UPDATED DOCUMENTATION ----
|
| 24 |
61784
|
argiro.kok
|
Login via ssh to www-farm.openaire.eu and update the documentation folder /srv/www/static/graph/develop/:
|
| 25 |
53334
|
alessia.ba
|
|
| 26 |
61784
|
argiro.kok
|
cd /srv/www/static/graph/develop
|
| 27 |
53334
|
alessia.ba
|
svn up
|
| 28 |
|
|
|
| 29 |
61784
|
argiro.kok
|
Remember to go to graph.openaire.eu/develop and double check the changes appear as you expect. If not, double check you committed everything.
|
| 30 |
53334
|
alessia.ba
|
If you have problems with the commit procedure or svn up on the server folder contact Alessia Bardi.
|
| 31 |
|
|
If you have problems with the layout or visualization of figures, contact Argiro Kokogiannaki.
|