Connect/ODBC: Refactor install widget details

Author: amotl

docs/_include/links.md

@@ -67,11 +67,8 @@
 [Multi-model Database]: https://cratedb.com/solutions/multi-model-database
 [nearest neighbor search]: https://en.wikipedia.org/wiki/Nearest_neighbor_search
 [Nested Data Structure]: https://cratedb.com/product/features/nested-data-structure
-[ODBC]: https://en.wikipedia.org/wiki/Open_Database_Connectivity
 [PostgreSQL JDBC Driver]: https://jdbc.postgresql.org/
 [PostgreSQL wire protocol]: https://www.postgresql.org/docs/current/protocol.html
-[psqlODBC]: https://odbc.postgresql.org/
-[psqlODBC download site]: https://www.postgresql.org/ftp/odbc/releases/
 [python-dbapi-by-example]: inv:crate-python:*:label#by-example
 [python-sqlalchemy-by-example]: inv:sqlalchemy-cratedb:*:label#by-example
 [query DSL based on JSON]: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html
@@ -84,6 +81,5 @@
 [TF–IDF]: https://en.wikipedia.org/wiki/Tf%E2%80%93idf
 [timeseries-queries-and-visualization-colab]: https://colab.research.google.com/github/crate/cratedb-examples/blob/main/topic/timeseries/timeseries-queries-and-visualization.ipynb
 [timeseries-queries-and-visualization-github]: https://github.com/crate/cratedb-examples/blob/main/topic/timeseries/timeseries-queries-and-visualization.ipynb
-[unixODBC]: https://www.unixodbc.org/
 [Vector Database (Product)]: https://cratedb.com/solutions/vector-database
 [Vector Database]: https://en.wikipedia.org/wiki/Vector_database

docs/connect/odbc/csharp.md

@@ -9,6 +9,12 @@ Use the ODBC .NET Data Provider to access data from your C Sharp ADO\.NET
 applications. The [.NET Framework Data Provider for ODBC] is available
 through the [System.Data.Odbc] namespace.
 
+:::{rubric} Install
+:::
+
+:::{include} /connect/odbc/install-dropdown.md
+:::
+
 :::{rubric} Synopsis
 :::
 

docs/connect/odbc/erlang.md

@@ -8,6 +8,12 @@
 The [Erlang ODBC application] provides an interface to communicate
 with relational SQL-databases out of the box.
 
+:::{rubric} Install
+:::
+
+:::{include} /connect/odbc/install-dropdown.md
+:::
+
 :::{rubric} Synopsis
 :::
 

docs/connect/odbc/index.md

@@ -11,7 +11,7 @@ Connect to CrateDB with ODBC.
 :::
 
 :::{div}
-Open Database Connectivity ([ODBC]) is a standard application programming
+Open Database Connectivity ([ODBC][ODBC definition]) is a standard application programming
 interface (API) for accessing database management systems (DBMS),
 conceived to be independent of database systems and operating systems.
 The application uses ODBC functions through an _ODBC driver manager_ and
@@ -40,3 +40,6 @@ Erlang <erlang>
 Python <python>
 Visual Basic <visualbasic>
 :::
+
+
+[ODBC definition]: https://en.wikipedia.org/wiki/Open_Database_Connectivity

docs/connect/odbc/install-dropdown.md

@@ -2,8 +2,10 @@
 orphan: true
 ---
 
-The PostgreSQL ODBC driver [psqlODBC]
+:::{div}
+The PostgreSQL ODBC driver
 can be used to connect to CrateDB from ODBC environments.
+:::
 
 ::::{dropdown} Install and configure the PostgreSQL ODBC driver
 :::{include} /connect/odbc/install.md

docs/connect/odbc/install.md

@@ -2,9 +2,14 @@
 orphan: true
 ---
 
+:::{include} /connect/odbc/links.md
+:::
+
+:::{div}
 While Windows typically includes an ODBC driver manager, you can
 install the [unixODBC] driver manager on Linux and macOS systems.
 The PostgreSQL ODBC driver is called [psqlODBC].
+:::
 
 :::::{tab-set}
 

docs/connect/odbc/python.md

@@ -17,6 +17,10 @@ convenience. For more information, please visit the
 :::{rubric} Install
 :::
 
+:::{include} /connect/odbc/install-dropdown.md
+:::
+
+Install the required Python package.
 ```shell
 pip install --upgrade pyodbc
 ```
@@ -129,7 +133,6 @@ connection_string = \
 ```
 
 
-
 [connecting to PostgreSQL with pyodbc]: https://github.com/mkleehammer/pyodbc/wiki/Connecting-to-PostgreSQL
 [pyodbc]: https://github.com/mkleehammer/pyodbc
 [pyodbc installation instructions]: https://github.com/mkleehammer/pyodbc/wiki/Install

docs/connect/odbc/visualbasic.md

@@ -2,9 +2,6 @@
 
 # ODBC with Visual Basic
 
-:::{include} /_include/links.md
-:::
-
 :::{rubric} About
 :::