search

GeoNode / geonode

GeoNode is an open source platform that facilitates the creation, sharing, and collaborative use of geospatial data.
https://geonode.org/
Other
1.45k stars 1.13k forks source link

Docs: Build warnings #4386

Closed t-book closed 5 years ago

t-book commented 5 years ago

Building of docs throws several warnings which should be reviewed.

1. /geonode/docs/organizational/contribute/documentation_guidelines.txt:215: WARNING: download file not readable: /geonode/docs/organizational/contribute/readme.txt
2. /geonode/docs/organizational/index.txt:47: WARNING: toctree contains reference to nonexisting document u'organizational/about'
3. /geonode/docs/organizational/roadmap.txt:5: WARNING: Duplicate explicit target name: "organizational partners list".
4. /geonode/docs/reference/developers/django-apps.txt:407: WARNING: Bullet list ends without a blank line; unexpected unindent.
5. /geonode/docs/reference/developers/django-apps.txt:393: WARNING: Unknown target name: "django-invitations".
6. /geonode/docs/reference/developers/settings.txt:656: WARNING: Title underline too short.
8. GEOTIFF_IO_ENABLED
10. /geonode/docs/reference/developers/settings.txt:656: WARNING: Title underline too short.
12. GEOTIFF_IO_ENABLED
14. /geonode/docs/reference/developers/settings.txt:662: WARNING: Title underline too short.
16. GEOTIFF_IO_BASE_URL
18. /geonode/docs/reference/developers/settings.txt:662: WARNING: Title underline too short.
20. GEOTIFF_IO_BASE_URL
22. /geonode/docs/tutorials/admin/customize_lookfeel/customize/theme_admin.txt:4: WARNING: Duplicate explicit target name: "bootstrap".
23. /geonode/docs/tutorials/admin/geoserver_geonode_security/index.txt:5: WARNING: Duplicate explicit target name: "here".
24. /geonode/docs/tutorials/admin/geoserver_geonode_security/index.txt:5: WARNING: Duplicate explicit target name: "here".
25. /geonode/docs/tutorials/admin/geoserver_geonode_security/index.txt:5: WARNING: Duplicate explicit target name: "here".
26. /geonode/docs/tutorials/admin/socialaccounts/index.txt:4: WARNING: Duplicate explicit target name: "django-allauth".
27. /geonode/docs/tutorials/advanced/adv_data_mgmt/adv_vector/wfst.txt:87: WARNING: Literal block expected; none found.
28. /geonode/docs/tutorials/advanced/adv_data_mgmt/index.txt:8: WARNING: toctree contains reference to nonexisting document u'tutorials/advanced/adv_data_mgmt/spatial_processing/index'
29. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/palettes.txt:42: WARNING: Enumerated list ends without a blank line; unexpected unindent.
30. /geonode/docs/tutorials/advanced/geonode_production/adv_gsconfig/jmeter/jmeter_multiscale.txt:169: WARNING: Explicit markup ends without a blank line; unexpected unindent.
31. /geonode/docs/tutorials/advanced/geonode_production/adv_gsconfig/jmeter/jmeter_wmslimits.txt:27: WARNING: Block quote ends without a blank line; unexpected unindent.
32. /geonode/docs/tutorials/advanced/geonode_production/geosites.txt:5: WARNING: duplicate label geosites, other instance in /geonode/docs/reference/developers/geosites.txt
33. /geonode/docs/tutorials/advanced/geonode_settings/django-apps.txt:5: WARNING: duplicate label djangoapps, other instance in /geonode/docs/reference/developers/django-apps.txt
34. /geonode/docs/tutorials/advanced/geonode_settings/settings.txt:115: WARNING: Inline strong start-string without end-string.
35. /geonode/docs/tutorials/advanced/geonode_settings/settings.txt:5: WARNING: duplicate label settings, other instance in /geonode/docs/reference/developers/settings.txt
36. /geonode/docs/tutorials/devel/devel_env/index.txt:419: WARNING: toctree contains reference to nonexisting document u'tutorials/devel/devel_env/install_win_devmode'
37. /geonode/docs/tutorials/devel/devel_env/index.txt:419: WARNING: toctree contains reference to nonexisting document u'tutorials/devel/devel_env/install_gdal_devmode'
38. /geonode/docs/tutorials/devel/devel_env/index_bk.txt:414: WARNING: toctree contains reference to nonexisting document u'tutorials/devel/devel_env/install_win_devmode'
39. /geonode/docs/tutorials/devel/devel_env/index_bk.txt:414: WARNING: toctree contains reference to nonexisting document u'tutorials/devel/devel_env/install_gdal_devmode'
40. /geonode/docs/tutorials/devel/devel_env/index_bk.txt:4: WARNING: duplicate label install_devmode, other instance in /geonode/docs/tutorials/devel/devel_env/index.txt
41. /geonode/docs/tutorials/devel/release/release.txt:4: WARNING: duplicate label release, other instance in /geonode/docs/tutorials/advanced/geonode_settings/release.txt
42. /geonode/docs/tutorials/index.txt:3: WARNING: Duplicate explicit target name: "geonode".
43. /geonode/docs/tutorials/index.txt:106: WARNING: Definition list ends without a blank line; unexpected unindent.
44. /geonode/docs/tutorials/install_and_admin/linux_admin_intro/ubuntu_basic_tutorial.txt:43: WARNING: Inline interpreted text or phrase reference start-string without end-string.
45. /geonode/docs/tutorials/install_and_admin/network_conf_issues.txt:28: WARNING: Inconsistent literal block quoting.
46. /geonode/docs/tutorials/install_and_admin/network_conf_issues.txt:29: WARNING: Line block ends without a blank line.
47. /geonode/docs/tutorials/install_and_admin/quick_install.txt:48: WARNING: Literal block expected; none found.
48. /geonode/docs/tutorials/install_and_admin/quick_install.txt:66: WARNING: Literal block expected; none found.
49. /geonode/docs/tutorials/install_and_admin/quick_install.txt:72: WARNING: Literal block expected; none found.
50. /geonode/docs/tutorials/install_and_admin/quick_install.txt:175: WARNING: Unknown target name: "virtual box".
51. /geonode/docs/tutorials/install_and_admin/running_ansible.txt:5: WARNING: Duplicate explicit target name: "official documentation".
52. /geonode/docs/tutorials/install_and_admin/running_ansible.txt:5: WARNING: Duplicate explicit target name: "official documentation".
53. /geonode/docs/tutorials/install_and_admin/setup_on_centos/install_geonode.txt:260: WARNING: Literal block expected; none found.
54. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:23: WARNING: Explicit markup ends without a blank line; unexpected unindent.
55. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:37: WARNING: Explicit markup ends without a blank line; unexpected unindent.
56. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:44: WARNING: Explicit markup ends without a blank line; unexpected unindent.
57. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:63: WARNING: Explicit markup ends without a blank line; unexpected unindent.
58. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:70: WARNING: Explicit markup ends without a blank line; unexpected unindent.
59. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:77: WARNING: Explicit markup ends without a blank line; unexpected unindent.
60. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:86: WARNING: Explicit markup ends without a blank line; unexpected unindent.
61. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:93: WARNING: Explicit markup ends without a blank line; unexpected unindent.
62. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:107: WARNING: Explicit markup ends without a blank line; unexpected unindent.
63. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:114: WARNING: Explicit markup ends without a blank line; unexpected unindent.
64. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:123: WARNING: Explicit markup ends without a blank line; unexpected unindent.
65. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:131: WARNING: Explicit markup ends without a blank line; unexpected unindent.
66. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:139: WARNING: Explicit markup ends without a blank line; unexpected unindent.
67. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:145: WARNING: Explicit markup ends without a blank line; unexpected unindent.
68. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:151: WARNING: Explicit markup ends without a blank line; unexpected unindent.
69. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:165: WARNING: Explicit markup ends without a blank line; unexpected unindent.
70. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:173: WARNING: Explicit markup ends without a blank line; unexpected unindent.
71. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_quickstart.txt:181: WARNING: Explicit markup ends without a blank line; unexpected unindent.
72. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_tour.txt:18: WARNING: Explicit markup ends without a blank line; unexpected unindent.
73. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_tour.txt:31: WARNING: Explicit markup ends without a blank line; unexpected unindent.
74. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_tour.txt:42: WARNING: Explicit markup ends without a blank line; unexpected unindent.
75. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_tour.txt:51: WARNING: Explicit markup ends without a blank line; unexpected unindent.
76. /geonode/docs/tutorials/overview_and_ref/introduction/geonode_tour.txt:61: WARNING: Explicit markup ends without a blank line; unexpected unindent.
77. /geonode/docs/tutorials/overview_and_ref/reference_doc/architecture.txt:12: WARNING: Explicit markup ends without a blank line; unexpected unindent.
78. /geonode/docs/tutorials/overview_and_ref/reference_doc/architecture.txt:5: WARNING: Duplicate explicit target name: "mvc".
79. /geonode/docs/i18n/index.txt: WARNING: document isn't included in any toctree
80. /geonode/docs/report.txt: WARNING: document isn't included in any toctree
81. /geonode/docs/tutorials/admin/install/custom_install.txt: WARNING: document isn't included in any toctree
82. /geonode/docs/tutorials/admin/install/dependencies.txt: WARNING: document isn't included in any toctree
83. /geonode/docs/tutorials/admin/install/index.txt: WARNING: document isn't included in any toctree
84. /geonode/docs/tutorials/devel/devel_env/gdal_install.txt: WARNING: document isn't included in any toctree
85. /geonode/docs/tutorials/devel/devel_env/index_bk.txt: WARNING: document isn't included in any toctree
86. /geonode/docs/tutorials/devel/devel_env/win_devinstall.txt: WARNING: document isn't included in any toctree
87. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/setup_nyc_db.txt: WARNING: document isn't included in any toctree
88. /geonode/docs/tutorials/install_and_admin/development_install/index.txt: WARNING: document isn't included in any toctree
89. /geonode/docs/tutorials/install_and_admin/linux_admin_intro/system_preparation_prerequisites.txt: WARNING: document isn't included in any toctree
90. /geonode/docs/tutorials/users/managing_layers/layer_filter.txt: WARNING: document isn't included in any toctree
91. /geonode/docs/tutorials/admin/customize_lookfeel/customize/setup_admin.txt:99: WARNING: undefined label: customize.theme_admin (if the link has no caption the label must precede a section header)
92. /geonode/docs/tutorials/admin/customize_lookfeel/customize/setup_admin.txt:57: WARNING: Could not lex literal_block as "html". Highlighting skipped.
93. /geonode/docs/tutorials/admin/customize_lookfeel/customize/theme_admin.txt:342: WARNING: Could not lex literal_block as "html". Highlighting skipped.
94. /geonode/docs/tutorials/admin/install/dependencies.txt:11: WARNING: undefined label: install_postgresql (if the link has no caption the label must precede a section header)
95. /geonode/docs/tutorials/admin/install/dependencies.txt:11: WARNING: undefined label: install_postgis (if the link has no caption the label must precede a section header)
96. /geonode/docs/tutorials/advanced/adv_data_mgmt/index.txt:34: WARNING: undefined label: spatial_processing (if the link has no caption the label must precede a section header)
97. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/charting.txt:35: WARNING: Could not lex literal_block as "xml". Highlighting skipped.
98. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/css.txt:50: WARNING: Could not lex literal_block as "css". Highlighting skipped.
99. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/info.txt:36: WARNING: Could not lex literal_block as "html". Highlighting skipped.
100. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/info.txt:85: WARNING: Could not lex literal_block as "html". Highlighting skipped.
101. /geonode/docs/tutorials/advanced/adv_data_mgmt/pretty_maps/info.txt:103: WARNING: Could not lex literal_block as "html". Highlighting skipped.
102. /geonode/docs/tutorials/advanced/geonode_production/adv_gsconfig/gsproduction.txt:39: WARNING: undefined label: geoserver.jai_io_install (if the link has no caption the label must precede a section header)
103. /geonode/docs/tutorials/devel/devel_core/exercises.txt:50: WARNING: Could not lex literal_block as "python". Highlighting skipped.
104. /geonode/docs/tutorials/devel/devel_env/index_bk.txt:9: WARNING: undefined label: install_win_devmode (if the link has no caption the label must precede a section header)
105. /geonode/docs/tutorials/devel/devel_intro/exercises.txt:52: WARNING: Could not lex literal_block as "console". Highlighting skipped.
106. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:66: WARNING: undefined label: data_vector (if the link has no caption the label must precede a section header)
107. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:66: WARNING: undefined label: data_raster (if the link has no caption the label must precede a section header)
108. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:66: WARNING: undefined label: data_external_wms (if the link has no caption the label must precede a section header)
109. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:663: WARNING: Could not lex literal_block as "json". Highlighting skipped.
110. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:824: WARNING: Could not lex literal_block as "json". Highlighting skipped.
111. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/curl.txt:839: WARNING: Could not lex literal_block as "json". Highlighting skipped.
112. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/index.txt:6: WARNING: undefined label: rest_api (if the link has no caption the label must precede a section header)
113. /geonode/docs/tutorials/devel/geonode_apis/geoserver_rest/examples/ruby.txt:21: WARNING: Could not lex literal_block as "ruby". Highlighting skipped.
114. /geonode/docs/tutorials/devel/geonode_apis/importer/formats.txt:27: WARNING: undefined label: data_oracle (if the link has no caption the label must precede a section header)
115. /geonode/docs/tutorials/devel/geonode_apis/importer/formats.txt:28: WARNING: undefined label: data_sqlserver (if the link has no caption the label must precede a section header)
116. /geonode/docs/tutorials/devel/geonode_apis/importer/guireference.txt:58: WARNING: undefined label: data_oracle (if the link has no caption the label must precede a section header)
117. /geonode/docs/tutorials/devel/geonode_apis/importer/guireference.txt:69: WARNING: undefined label: data_sqlserver (if the link has no caption the label must precede a section header)
118. /geonode/docs/tutorials/devel/geonode_apis/importer/installing.txt:16: WARNING: undefined label: web_admin (if the link has no caption the label must precede a section header)
119. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:70: WARNING: undefined label: import_collection (if the link has no caption the label must precede a section header)
120. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:76: WARNING: undefined label: import (if the link has no caption the label must precede a section header)
121. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:217: WARNING: undefined label: import (if the link has no caption the label must precede a section header)
122. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:232: WARNING: undefined label: import (if the link has no caption the label must precede a section header)
123. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:292: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
124. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:297: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
125. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:395: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
126. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:399: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
127. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:400: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
128. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:449: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
129. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:492: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
130. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:661: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
131. /geonode/docs/tutorials/devel/geonode_apis/importer/rest_reference.txt:662: WARNING: undefined label: importer_rest_reference_tasks (if the link has no caption the label must precede a section header)
132. /geonode/docs/tutorials/devel/geonode_apis/importer/using.txt:8: WARNING: undefined label: data_directory (if the link has no caption the label must precede a section header)
133. /geonode/docs/tutorials/devel/index.txt:52: WARNING: undefined label: win_binary_installer (if the link has no caption the label must precede a section header)
134. /geonode/docs/tutorials/install_and_admin/running_docker/setup_docker_compose.txt:7: WARNING: undefined label: _setup_docker (if the link has no caption the label must precede a section header)
135. /geonode/docs/tutorials/install_and_admin/running_docker/setup_rancher.txt:63: WARNING: undefined label: _setup_docker (if the link has no caption the label must precede a section header)
136. /geonode/docs/tutorials/install_and_admin/setup_on_centos/install_base_httpd.txt:18: WARNING: undefined label: install_venv_httpd_wsgi (if the link has no caption the label must precede a section header)
137. /geonode/docs/tutorials/install_and_admin/setup_on_centos/install_base_httpd.txt:18: WARNING: undefined label: install_venv_nginx_gunicorn (if the link has no caption the label must precede a section header)
138. /geonode/docs/tutorials/install_and_admin/setup_on_centos/install_geonode.txt:305: WARNING: undefined label: install_venv_httpd (if the link has no caption the label must precede a section header)
139. /geonode/docs/tutorials/overview_and_ref/reference_doc/components.txt:6: WARNING: undefined label: architecture (if the link has no caption the label must precede a section header)
t-book commented 5 years ago

@afabiani brought up the idea of a reworked TOC. I would wait for it before working on this issue. Some of the warnings might be obsolete.

t-book commented 5 years ago

We will rebuild the docs. What makes this issue obsolete.