Changes between Version 3 and Version 4 of building_the_docs
- Timestamp:
- 12/28/17 11:48:15 (7 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
building_the_docs
v3 v4 36 36 On {{{ubuntu 16.04}}} 37 37 38 <source lang="bash">sudo apt install cmake git39 40 sudo pip install sphinx </source>38 {{{sudo apt install cmake git 39 40 sudo pip install sphinx}}} 41 41 == Preparing the repository == 42 42 … … 51 51 This build will only make the English version and will be faster so you can quickly visualize your changes. 52 52 53 <source lang="bash">## making the build folder (where builds will be put)53 {{{## making the build folder (where builds will be put) 54 54 mkdir build 55 55 … … 62 62 # Build html files 63 63 make html 64 </source> 64 }}} 65 65 And you're done ! You can go to {{{build/doc/_build/}}} and open {{{index.html}}} in a web browser. 66 66 … … 211 211 Add the 2 letters code of the new language: 212 212 213 <source lang="bash">set(OSGeoLiveDoc_SUPPORTED_LANGUAGES "ca" "de" "es" "fr" "it" "ja" "ko" "pl" "ru")</source> 213 {{{set(OSGeoLiveDoc_SUPPORTED_LANGUAGES "ca" "de" "es" "fr" "it" "ja" "ko" "pl" "ru")}}} 214 214 Then add a new {{{INSERT_INTO_MAP}}} command to add the language to the lang navigation bar (in {{{index.html}}}). For example: 215 215 … … 423 423 This line parse the projects_info file and stores it in {{{$configuration}}}. If the flag {{{-DOSGeoLiveDoc_DEBUG=ON}}} is used, then a comment line will be print. 424 424 425 <source lang="perl">my $configuration = read_and_parse_configuration($projects_info_file);</source> 425 {{{my $configuration = read_and_parse_configuration($projects_info_file);}}} 426 426 ==== read_and_parse_configuration subroutine ==== 427 427 … … 483 483 The variables are loaded by CMake during the build from data in {{{CMakeLists.txt}}}. 484 484 485 <source lang="perl">my $DEBUG = "@OSGeoLiveDoc_DEBUG@";485 {{{my $DEBUG = "@OSGeoLiveDoc_DEBUG@"; 486 486 my $version = "@OSGeoLiveDoc_VERSION@"; 487 487 my $projects_info_file = '@CMAKE_SOURCE_DIR@/projects_info.csv'; 488 my $output_file = '@CMAKE_CURRENT_BINARY_DIR@/../metrics.rst'; </source>488 my $output_file = '@CMAKE_CURRENT_BINARY_DIR@/../metrics.rst';}}} 489 489 = Useful commands = 490 490 … … 493 493 ==== Moving the files to the right folder ==== 494 494 495 <source lang="bash">git mv doc/images/projects/gvsigFOOOOOOOOOOOO doc/images/projects/gvsig495 {{{git mv doc/images/projects/gvsigFOOOOOOOOOOOO doc/images/projects/gvsig 496 496 497 497 # see the change 498 git status </source>498 git status}}} 499 499 ==== Changing all occurrences ==== 500 500 … … 505 505 ==== THE command: ==== 506 506 507 <source lang="bash">perl -pi -e "s/projects\/gvsigFOOOOOOOOOOOO/projects\/gvsig/" $(git ls-files)</source> 507 {{{perl -pi -e "s/projects\/gvsigFOOOOOOOOOOOO/projects\/gvsig/" $(git ls-files)}}} 508 508 * {{{git ls-files}}} : lists the files that git knows about 509 509 * {{{perl}}} <--- use that