Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

mkdocs serve links clean up #1326

Open
jbampton opened this issue Apr 9, 2024 · 6 comments
Open

mkdocs serve links clean up #1326

jbampton opened this issue Apr 9, 2024 · 6 comments

Comments

@jbampton
Copy link
Member

jbampton commented Apr 9, 2024

Expected behavior

Links should be cleaned up and most of the INFO messages about links should be removed.

And the links should also work on the GitHub website when viewing the Markdown docs.

Actual behavior

When running locally:

mkdocs serve

we have a lot of extra INFO messages that mention our links can be cleaned up.

If you browse the docs directly on GitHub some of these links are broken.

You can run mkdocs serve 2> mkdocs-serve-output.txt to pipe the error messages to a file.

Example output below

INFO    -  Building documentation...
INFO    -  [macros] - Macros arguments: {'module_name': 'main', 'modules': [], 'render_by_default': True, 'include_dir': '', 'include_yaml': [], 'j2_block_start_string': '', 'j2_block_end_string': '',
           'j2_variable_start_string': '', 'j2_variable_end_string': '', 'on_undefined': 'keep', 'on_error_fail': False, 'verbose': False}
INFO    -  [macros] - Extra variables (config file): ['version', 'social', 'sedona', 'sedona_create_release']
INFO    -  [macros] - Extra filters (module): ['pretty']
INFO    -  Cleaning site directory
INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
             - api/python-api.md
             - tutorial/python-vector-osm.md
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
INFO    -  Doc file 'api/java-api.md' contains an unrecognized relative link '../javadoc/spark/', it was left as is.
INFO    -  Doc file 'api/snowflake/vector-data/Overview.md' contains an unrecognized relative link '../Constructor', it was left as is. Did you mean 'Constructor.md'?
INFO    -  Doc file 'api/snowflake/vector-data/Overview.md' contains an unrecognized relative link '../Function', it was left as is. Did you mean 'Function.md'?
INFO    -  Doc file 'api/snowflake/vector-data/Overview.md' contains an unrecognized relative link '../AggregateFunction', it was left as is. Did you mean 'AggregateFunction.md'?
INFO    -  Doc file 'api/snowflake/vector-data/Overview.md' contains an unrecognized relative link '../Predicate', it was left as is. Did you mean 'Predicate.md'?
INFO    -  Doc file 'api/sql/Optimizer.md' contains an unrecognized relative link '../Parameter', it was left as is. Did you mean 'Parameter.md'?
INFO    -  Doc file 'api/sql/Optimizer.md' contains an unrecognized relative link '../Function/#st_s2cellids', it was left as is. Did you mean 'Function.md#st_s2cellids'?
INFO    -  Doc file 'api/sql/Optimizer.md' contains an unrecognized relative link '../Predicate/', it was left as is. Did you mean 'Predicate.md'?
INFO    -  Doc file 'api/sql/Optimizer.md' contains an unrecognized relative link '../../api/sql/Function/#st_geohash', it was left as is. Did you mean 'Function.md#st_geohash'?
INFO    -  Doc file 'api/sql/Overview.md' contains an unrecognized relative link '../Constructor', it was left as is. Did you mean 'Constructor.md'?
INFO    -  Doc file 'api/sql/Overview.md' contains an unrecognized relative link '../Function', it was left as is. Did you mean 'Function.md'?
INFO    -  Doc file 'api/sql/Overview.md' contains an unrecognized relative link '../AggregateFunction', it was left as is. Did you mean 'AggregateFunction.md'?
INFO    -  Doc file 'api/sql/Overview.md' contains an unrecognized relative link '../Predicate', it was left as is. Did you mean 'Predicate.md'?
WARNING -  Doc file 'api/sql/Overview.md' contains a relative link '../../scaladoc/spark/org/apache/sedona/sql/utils/index.html', but the target 'scaladoc/spark/org/apache/sedona/sql/utils/index.html' is not found among
           documentation files.
INFO    -  Doc file 'api/sql/Overview.md' contains an unrecognized relative link '../Optimizer', it was left as is. Did you mean 'Optimizer.md'?
INFO    -  Doc file 'api/sql/Raster-map-algebra.md' contains an unrecognized relative link '../Raster-operators/', it was left as is. Did you mean 'Raster-operators.md'?
INFO    -  Doc file 'api/sql/Raster-operators.md' contains an unrecognized relative link '../Function/#st_transform', it was left as is. Did you mean 'Function.md#st_transform'?
INFO    -  Doc file 'api/sql/Raster-operators.md' contains an unrecognized relative link '../Raster-map-algebra/', it was left as is. Did you mean 'Raster-map-algebra.md'?
INFO    -  Doc file 'api/sql/Raster-visualizer.md' contains an unrecognized relative link '../Raster-operators/#rs_bandpixeltype', it was left as is. Did you mean 'Raster-operators.md#rs_bandpixeltype'?
INFO    -  Doc file 'api/sql/Raster-visualizer.md' contains an unrecognized relative link '../Raster-loader/#rs_makeemptyraster', it was left as is. Did you mean 'Raster-loader.md#rs_makeemptyraster'?
INFO    -  Doc file 'api/sql/Raster-writer.md' contains an unrecognized relative link '../Raster-operators/#rs_band', it was left as is. Did you mean 'Raster-operators.md#rs_band'?
INFO    -  Doc file 'api/viz/java-api.md' contains an unrecognized relative link '../../javadoc/spark/', it was left as is.
INFO    -  Doc file 'community/contributor.md' contains an unrecognized relative link '../rule', it was left as is. Did you mean 'rule.md'?
INFO    -  Doc file 'community/develop.md' contains an unrecognized relative link '../../setup/compile/', it was left as is. Did you mean '../setup/compile.md'?
INFO    -  Doc file 'community/develop.md' contains an unrecognized relative link '../../setup/compile/#run-python-test', it was left as is. Did you mean '../setup/compile.md#run-python-test'?
INFO    -  Doc file 'community/publish.md' contains an unrecognized relative link '../../setup/compile', it was left as is. Did you mean '../setup/compile.md'?
INFO    -  Doc file 'community/publish.md' contains an unrecognized relative link '../../download', it was left as is. Did you mean '../download.md'?
INFO    -  Doc file 'setup/install-python.md' contains an unrecognized relative link '../release-notes/#known-issue', it was left as is. Did you mean 'release-notes.md#known-issue'?
INFO    -  Doc file 'setup/install-python.md' contains an unrecognized relative link '../maven-coordinates', it was left as is. Did you mean 'maven-coordinates.md'?
INFO    -  Doc file 'setup/install-python.md' contains an unrecognized relative link '../../tutorial/jupyter-notebook/', it was left as is. Did you mean '../tutorial/jupyter-notebook.md'?
INFO    -  Doc file 'setup/install-scala.md' contains an unrecognized relative link '../compile', it was left as is. Did you mean 'compile.md'?
INFO    -  Doc file 'setup/install-scala.md' contains an unrecognized relative link '../../tutorial/sql-pure-sql/', it was left as is. Did you mean '../tutorial/sql-pure-sql.md'?
INFO    -  Doc file 'setup/install-scala.md' contains an unrecognized relative link '../../tutorial/demo/', it was left as is. Did you mean '../tutorial/demo.md'?
INFO    -  Doc file 'setup/overview.md' contains an unrecognized relative link '../../tutorial/viz', it was left as is. Did you mean '../tutorial/viz.md'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../tutorial/raster/', it was left as is. Did you mean '../tutorial/raster.md'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../api/sql/Function/#st_h3celldistance', it was left as is. Did you mean '../api/sql/Function.md#st_h3celldistance'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../tutorial/sql/#visualize-query-results', it was left as is. Did you mean '../tutorial/sql.md#visualize-query-results'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#raster-based-operators', it was left as is. Did you mean
           '../api/sql/Raster-operators.md#raster-based-operators'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#raster-to-map-algebra-operators', it was left as is. Did you mean
           '../api/sql/Raster-operators.md#raster-to-map-algebra-operators'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../api/sql/Optimizer/#google-s2-based-approximate-equi-join', it was left as is. Did you mean
           '../api/sql/Optimizer.md#google-s2-based-approximate-equi-join'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../tutorial/flink/sql/#join-query', it was left as is. Did you mean '../tutorial/flink/sql.md#join-query'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../../api/sql/Optimizer/#geoparquet', it was left as is. Did you mean '../api/sql/Optimizer.md#geoparquet'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../maven-coordinates', it was left as is. Did you mean 'maven-coordinates.md'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../maven-coordinates', it was left as is. Did you mean 'maven-coordinates.md'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../compile', it was left as is. Did you mean 'compile.md'?
INFO    -  Doc file 'setup/release-notes.md' contains an unrecognized relative link '../overview/#prepare-python-adapter-jar', it was left as is. Did you mean 'overview.md#prepare-python-adapter-jar'?
INFO    -  Doc file 'setup/flink/install-scala.md' contains an unrecognized relative link '../../maven-coordinates', it was left as is. Did you mean '../maven-coordinates.md'?
INFO    -  Doc file 'setup/flink/install-scala.md' contains an unrecognized relative link '../../../tutorial/flink/sql', it was left as is. Did you mean '../../tutorial/flink/sql.md'?
INFO    -  Doc file 'setup/flink/install-scala.md' contains an unrecognized relative link '../../../tutorial/demo/', it was left as is. Did you mean '../../tutorial/demo.md'?
WARNING -  Doc file 'setup/snowflake/install.md' contains a relative link './../../../image/snowflake/sedona-snowflake.sql', but the target '../image/snowflake/sedona-snowflake.sql' is not found among documentation files.
           Did you mean '../../image/snowflake/sedona-snowflake.sql'?
INFO    -  Doc file 'tutorial/Advanced-Tutorial-Tune-your-Application.md' contains an unrecognized relative link '../../setup/release-notes/', it was left as is. Did you mean '../setup/release-notes.md'?
INFO    -  Doc file 'tutorial/jupyter-notebook.md' contains an unrecognized relative link '../../setup/install-python/#install-sedona', it was left as is. Did you mean '../setup/install-python.md#install-sedona'?
INFO    -  Doc file 'tutorial/jupyter-notebook.md' contains an unrecognized relative link '../../setup/install-python/#prepare-spark-shaded-jar', it was left as is. Did you mean
           '../setup/install-python.md#prepare-spark-shaded-jar'?
INFO    -  Doc file 'tutorial/jupyter-notebook.md' contains an unrecognized relative link '../../setup/install-python/#setup-environment-variables', it was left as is. Did you mean
           '../setup/install-python.md#setup-environment-variables'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-map-algebra', it was left as is. Did you mean '../api/sql/Raster-map-algebra.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Overview', it was left as is. Did you mean '../api/sql/Overview.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../demo/', it was left as is. Did you mean 'demo.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../setup/install-python', it was left as is. Did you mean '../setup/install-python.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../jupyter-notebook', it was left as is. Did you mean 'jupyter-notebook.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#rs_metadata', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_metadata'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#rs_georeference', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_georeference'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators', it was left as is. Did you mean '../api/sql/Raster-operators.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_pixelaspoint', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_pixelaspoint'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_worldtorastercoord', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_worldtorastercoord'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_worldtorastercoordx', it was left as is. Did you mean
           '../api/sql/Raster-operators.md#rs_worldtorastercoordx'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_worldtorastercoordy', it was left as is. Did you mean
           '../api/sql/Raster-operators.md#rs_worldtorastercoordy'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_values', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_values'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_setvalues', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_setvalues'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_band', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_band'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_addband', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_addband'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#rs_resample', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_resample'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-map-algebra', it was left as is. Did you mean '../api/sql/Raster-map-algebra.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-writer/#rs_asraster', it was left as is. Did you mean '../api/sql/Raster-writer.md#rs_asraster'?
WARNING -  Doc file 'tutorial/raster.md' contains a relative link '../../image/rasterized-image.png', but the target '../image/rasterized-image.png' is not found among documentation files. Did you mean
           '../image/rasterized-image.png'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators#rs_intersects', it was left as is. Did you mean '../api/sql/Raster-operators.md#rs_intersects'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-operators/#raster-predicates', it was left as is. Did you mean '../api/sql/Raster-operators.md#raster-predicates'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-visualizer#rs_asbase64', it was left as is. Did you mean '../api/sql/Raster-visualizer.md#rs_asbase64'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-visualizer#rs_asimage', it was left as is. Did you mean '../api/sql/Raster-visualizer.md#rs_asimage'?
WARNING -  Doc file 'tutorial/raster.md' contains a relative link '../../image/DisplayImage.png', but the target '../image/DisplayImage.png' is not found among documentation files. Did you mean '../image/DisplayImage.png'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-visualizer', it was left as is. Did you mean '../api/sql/Raster-visualizer.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-writer#rs_asarcgrid', it was left as is. Did you mean '../api/sql/Raster-writer.md#rs_asarcgrid'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-writer#rs_asgeotiff', it was left as is. Did you mean '../api/sql/Raster-writer.md#rs_asgeotiff'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-writer#rs_aspng', it was left as is. Did you mean '../api/sql/Raster-writer.md#rs_aspng'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../../api/sql/Raster-writer', it was left as is. Did you mean '../api/sql/Raster-writer.md'?
INFO    -  Doc file 'tutorial/raster.md' contains an unrecognized relative link '../storing-blobs-in-parquet', it was left as is. Did you mean 'storing-blobs-in-parquet.md'?
INFO    -  Doc file 'tutorial/rdd.md' contains an unrecognized relative link '../sql/#set-up-dependencies', it was left as is. Did you mean 'sql.md#set-up-dependencies'?
INFO    -  Doc file 'tutorial/rdd.md' contains an unrecognized relative link '../sql/#create-sedona-config', it was left as is. Did you mean 'sql.md#create-sedona-config'?
INFO    -  Doc file 'tutorial/rdd.md' contains an unrecognized relative link '../sql/#initiate-sedonacontext', it was left as is. Did you mean 'sql.md#initiate-sedonacontext'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../demo/', it was left as is. Did you mean 'demo.md'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../../setup/install-python', it was left as is. Did you mean '../setup/install-python.md'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../jupyter-notebook', it was left as is. Did you mean 'jupyter-notebook.md'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../rdd/#create-a-generic-spatialrdd', it was left as is. Did you mean 'rdd.md#create-a-generic-spatialrdd'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../../api/sql/Visualization_SedonaPyDeck', it was left as is. Did you mean '../api/sql/Visualization_SedonaPyDeck.md'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../../api/sql/Visualization_SedonaKepler', it was left as is. Did you mean '../api/sql/Visualization_SedonaKepler.md'?
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../../api/sql/Function/#st_geohash', it was left as is. Did you mean '../api/sql/Function.md#st_geohash'?
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../../api/scaladoc/spark/org/apache/sedona/sql/utils/index.html', but the target '../api/scaladoc/spark/org/apache/sedona/sql/utils/index.html' is not found
           among documentation files.
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among
           documentation files.
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../rdd#read-other-attributes-in-an-spatialrdd', it was left as is. Did you mean 'rdd.md#read-other-attributes-in-an-spatialrdd'?
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among
           documentation files.
INFO    -  Doc file 'tutorial/sql.md' contains an unrecognized relative link '../rdd#read-other-attributes-in-an-spatialrdd', it was left as is. Did you mean 'rdd.md#read-other-attributes-in-an-spatialrdd'?
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among
           documentation files.
INFO    -  Doc file 'tutorial/viz.md' contains an unrecognized relative link '../../api/viz/sql', it was left as is. Did you mean '../api/viz/sql.md'?
INFO    -  Doc file 'tutorial/viz.md' contains an unrecognized relative link '../sql', it was left as is. Did you mean 'sql.md'?
INFO    -  Doc file 'tutorial/viz.md' contains an unrecognized relative link '../../api/viz/sql/#st_colorize', it was left as is. Did you mean '../api/viz/sql.md#st_colorize'?
INFO    -  Doc file 'tutorial/zeppelin.md' contains an unrecognized relative link '../../setup/zeppelin/', it was left as is. Did you mean '../setup/zeppelin.md'?
INFO    -  Doc file 'tutorial/zeppelin.md' contains an unrecognized relative link '../viz', it was left as is. Did you mean 'viz.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/flink/Overview', it was left as is. Did you mean '../../api/flink/Overview.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../setup/maven-coordinates', it was left as is. Did you mean '../../setup/maven-coordinates.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../demo/', it was left as is. Did you mean '../demo.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/flink/Constructor', it was left as is. Did you mean '../../api/flink/Constructor.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/flink/Function/#st_transform', it was left as is. Did you mean '../../api/flink/Function.md#st_transform'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/flink/Predicate', it was left as is. Did you mean '../../api/flink/Predicate.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../demo/', it was left as is. Did you mean '../demo.md'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/flink/Function/#st_s2cellids', it was left as is. Did you mean '../../api/flink/Function.md#st_s2cellids'?
INFO    -  Doc file 'tutorial/flink/sql.md' contains an unrecognized relative link '../../../api/Predicate/', it was left as is.
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Constructor/', it was left as is. Did you mean '../../api/snowflake/vector-data/Constructor.md'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/', it was left as is. Did you mean '../../api/snowflake/vector-data/Function.md'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Constructor/', it was left as is. Did you mean '../../api/snowflake/vector-data/Constructor.md'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function#st_transform', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_transform'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_s2cellids', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_s2cellids'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Predicate/', it was left as is. Did you mean '../../api/snowflake/vector-data/Predicate.md'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_3ddistance', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_3ddistance'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_force_2d', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_force_2d'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_geometryn', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_geometryn'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_makevalid', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_makevalid'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_multi', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_multi'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_numgeometries', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_numgeometries'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_precisionreduce', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_precisionreduce'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/#st_subdivideexplode', it was left as is. Did you mean
           '../../api/snowflake/vector-data/Function.md#st_subdivideexplode'?
INFO    -  Doc file 'tutorial/snowflake/sql.md' contains an unrecognized relative link '../../../api/snowflake/vector-data/Function/', it was left as is. Did you mean '../../api/snowflake/vector-data/Function.md'?
INFO    -  Documentation built in 3.57 seconds
INFO    -  [23:00:05] Watching paths for changes: 'docs', 'mkdocs.yml'
INFO    -  [23:00:05] Serving on http://127.0.0.1:8000/
INFO    -  Shutting down...

Steps to reproduce the problem

Run:

mkdocs serve and watch the output in the console

Settings

Sedona version = master

Apache Spark version = ?

Apache Flink version = ?

API type = Scala, Java, Python?

Scala version = 2.11, 2.12, 2.13?

JRE version = 1.8, 1.11?

Python version = Python 3.11.6

Environment = Standalone, AWS EC2, EMR, Azure, Databricks?
@mebrein
Copy link
Contributor

mebrein commented Apr 10, 2024

So I think the docs need some love.

I wonder when I change these links (just some examples)

[Sedona version release notes](../../setup/release-notes/)
[how to contribute](../rule)
<img src="../../image/ide-java-1.png"/>
[ST_S2CellIds](../Function/#st_s2cellids)

to

[Sedona version release notes](../setup/release-notes.md)
[how to contribute](rule.md) 
<img src="../image/ide-java-1.png"/>
[ST_S2CellIds](Function.md#st_s2cellids)

Then the links will work locally in my editor and on my local mkdocs server. But will these kind of changes break the website?

When I change/fix all links this would affect like 25 files.

@jbampton
Copy link
Member Author

I was looking at the official guide on links here:

https://www.mkdocs.org/user-guide/writing-your-docs/#linking-to-pages

On quick review I was not able to find much on links in the Material docs

https://squidfunk.github.io/mkdocs-material/setup/

But you can setup the website locally and build and serve it to test the links.

There is the guide on the website here:

https://sedona.apache.org/latest/setup/compile/#compile-the-documentation

@mebrein
Copy link
Contributor

mebrein commented Apr 11, 2024 •
edited

Ok, I think I got it. I issued the following pull request: #1334.

Output is now as follows:

INFO    -  [macros] - Macros arguments: {'module_name': 'main', 'modules': [], 'render_by_default': True, 'include_dir': '', 'include_yaml': [], 'j2_block_start_string': '', 'j2_block_end_string': '', 'j2_variable_start_string': '', 'j2_variable_end_string': '', 'on_undefined': 'keep', 'on_error_fail': False, 'verbose': False}
INFO    -  [macros] - Extra variables (config file): ['version', 'social', 'sedona', 'sedona_create_release']
INFO    -  [macros] - Extra filters (module): ['pretty']
INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: C:\Projects\sedona\site
INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
             - api\python-api.md
             - tutorial\python-vector-osm.md
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A relative path to 'api/rdocs' is included in the 'nav' configuration, which is not found in the documentation files.
INFO    -  Doc file 'api/java-api.md' contains an unrecognized relative link '../javadoc/spark/', it was left as is.
WARNING -  Doc file 'api/sql/Overview.md' contains a relative link '../../scaladoc/spark/org/apache/sedona/sql/utils/index.html', but the target 'scaladoc/spark/org/apache/sedona/sql/utils/index.html' is not found among documentation files.
INFO    -  Doc file 'api/viz/java-api.md' contains an unrecognized relative link '../../javadoc/spark/', it was left as is.
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../api/scaladoc/spark/org/apache/sedona/sql/utils/index.html', but the target 'api/scaladoc/spark/org/apache/sedona/sql/utils/index.html' is not found among documentation files.
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target 'api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among documentation files.
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target 'api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among documentation files.
WARNING -  Doc file 'tutorial/sql.md' contains a relative link '../api/javadoc/sql/org/apache/sedona/sql/utils/index.html', but the target 'api/javadoc/sql/org/apache/sedona/sql/utils/index.html' is not found among documentation files.
INFO    -  Documentation built in 6.81 seconds

@mebrein
Copy link
Contributor

mebrein commented Apr 11, 2024 •
edited

To explain a bit futher. A lot of these constructs were like:

<img width="250" src="../../image/st_snap/st-snap-applied.png" title="ST_Snap applied example"/>

I replaced them with

![ST_Snap applied example](../../image/st_snap/st-snap-applied.png "ST_Snap applied example"){: width="250px"}

so the relative paths are now correct, alt and title properties being applied and size is set correctly.

Following occurrences:

Use [ST_S2CellIds](../Function/#st_s2cellids) to generate cell ID

I replaced them with

Use [ST_S2CellIds](Function.md#st_s2cellids)

adding the .md suffix and removing the leading forward slash which I think is not necessary. Also the slash just before the # anchor can be removed.

I hope this works out beautifully for all editors/ide's I currently use Jetbrains IDE.

@jbampton
Copy link
Member Author

We have an issue with the changes mentioned here:

#1334 (comment)

@mebrein
Copy link
Contributor

mebrein commented Apr 23, 2024

I issued a pull request, could you have a look? #1359

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@jbampton @mebrein