Comments (6)
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
from sedona.
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.
from sedona.
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
from sedona.
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.
from sedona.
We have an issue with the changes mentioned here:
from sedona.
I issued a pull request, could you have a look? #1359
from sedona.
Related Issues (20)
- Preview and Generate Open Graph Meta Tags - Missing Image HOT 1
- Retrieve WKT CRS ID using ShapefileReader HOT 2
- Package Conflict when I use ST_AsGeoJSON HOT 2
- Unable to use sedona.global.charset in ShapefileReader HOT 4
- Add `markdown-link-check` with `pre-commit` HOT 2
- Add documentation on `pre-commit` usage
- We should add `ruff-pre-commit` a `pre-commit` hook for `Ruff` for Python linting and formatting HOT 1
- Add some `pre-commit` hooks that target the `R` language
- Apache Sedona on Fabric, does not read parquet from Lakehouse HOT 7
- Images should have alternate text (alt text)
- Specify custom transformation parameters/wkt string from CoordinateSystem A til CoordinateSystem B. HOT 3
- AWS Glue official tutorial HOT 5
- Hidden requirement for geopandas in apache-sedona[spark] 1.5.2 HOT 4
- after latest update of sedona snow on snowflake side all functions are gone HOT 2
- datatype geometry is not supported when 'create table xxx (geom geometry)' HOT 3
- AttributeError: 'sedona' has no attribute 'read' HOT 2
- St_isempty(geometry) finds non null geometries but does not find null geometries. HOT 2
- ST_Snap example code does not work HOT 2
- Flink Sedona,geomTbl.execute().print() happen error: HOT 2
- Sedona fails to write Delta Lake on Databricks 15.3 Beta: ClassCastException HOT 7
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sedona.