ploomber · anupam-tiwari · Jun 28, 2023 · Jun 28, 2023 · Jun 28, 2023 · Jun 28, 2023
@@ -7,6 +7,7 @@
 * [Feature] Adds Redshift support for `%sqlplot boxplot`
 * [Fix] Fix error when using SQL Server with pyodbc that caused queries to fail due to multiple open result sets
 * [Fix] Improves performance when converting DuckDB results to `pandas.DataFrame`
+* [Doc] Opengraph/Sphinxext-opengraph Integration and Optimization for Social Media link Sharing (#253)
 
 ## 0.9.0 (2023-08-01)
 

@@ -47,6 +47,7 @@
     "sphinx.ext.autosummary",
     "matplotlib.sphinxext.plot_directive",
     "sphinx_jupyterbook_latex",
+    "sphinxext.opengraph",
 ]
 external_toc_exclude_missing = False
 external_toc_path = "_toc.yml"
@@ -55,6 +56,7 @@
 html_logo = "square-no-bg-small.png"
 html_sourcelink_suffix = ""
 html_theme = "sphinx_book_theme"
+html_title = "JupySQL documentation"
 html_theme_options = {
     "launch_buttons": {
         "notebook_interface": "jupyterlab",
@@ -100,6 +102,7 @@
 suppress_warnings = ["misc.highlighting_failure"]
 use_jupyterbook_latex = True
 use_multitoc_numbering = True
+ogp_image = "/en/685/_static/html-meta-template.png"
 
 
 # Adding Algolia search to jupyter-book :

@@ -200,4 +200,5 @@ dependencies:
       - wcwidth==0.2.6
       - widgetsnbextension==4.0.8
       - zipp==3.16.2
-prefix: /opt/conda/envs/jupysql-doc
+      - sphinxext-opengraph
+prefix: /opt/conda/envs/jupysql-doc
@@ -1,4 +1,6 @@
 ---
+og:image: /en/685/_static/duckdb.png
+og:description: 'duckdb'
 jupytext:
   notebook_metadata_filter: myst
   text_representation:
@@ -15,6 +17,7 @@ myst:
     description lang=en: Use DuckDB from Jupyter using JupySQL
     keywords: jupyter, sql, jupysql, duckdb, plotting
     property=og:locale: en_US
+    property=og:image:alt: 'Better SQL in Jupyter. 📊.'
 ---
 
 # DuckDB

diff --git a/doc/static/duckdb.drawio b/doc/static/duckdb.drawio
diff --git a/doc/static/html-meta-template.drawio b/doc/static/html-meta-template.drawio
diff --git a/doc/tutorials/duckdb-github.md b/doc/tutorials/duckdb-github.md
@@ -15,8 +15,10 @@ myst:
     description lang=en: Use JupySQL and DuckDB to query JSON files with SQL
     keywords: jupyter, sql, jupysql, json, duckdb
     property=og:locale: en_US
+
 ---
 
+
 # Analyzing Github Data with JupySQL + DuckDB
 
 JupySQL and DuckDB have many use cases. Here, let's query the Github REST API to run some analysis using these tools.

diff --git a/doc/tutorials/duckdb-native-sqlalchemy.md b/doc/tutorials/duckdb-native-sqlalchemy.md
@@ -41,6 +41,7 @@ df = pd.DataFrame(np.random.randn(num_rows, num_cols))
 
 ```{code-cell} ipython3
 import duckdb
+
 conn = duckdb.connect()
 ```
 

@@ -30,11 +30,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "67e9f89e",
-   "metadata": {
-    "vscode": {
-     "languageId": "python"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "from pathlib import Path\n",
@@ -59,11 +55,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "2708d4a7",
-   "metadata": {
-    "vscode": {
-     "languageId": "python"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "%pip install jupysql jupysql-plugin --upgrade --quiet"
@@ -86,11 +78,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "dbe40317",
-   "metadata": {
-    "vscode": {
-     "languageId": "python"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "%load_ext sql\n",
@@ -112,11 +100,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "7e6c6c7d",
-   "metadata": {
-    "vscode": {
-     "languageId": "python"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "%sqlcmd explore --table \"yellow_tripdata_2021.parquet\""
@@ -137,16 +121,25 @@
    "notebook_metadata_filter": "myst"
   },
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "ploomber_env",
    "language": "python",
    "name": "python3"
   },
+  "language_info": {
+   "name": "python",
+   "version": "3.9.6 (default, Oct 18 2022, 12:41:40) \n[Clang 14.0.0 (clang-1400.0.29.202)]"
+  },
   "myst": {
    "html_meta": {
     "description lang=en": "Templatize SQL queries in Jupyter via JupySQL",
     "keywords": "jupyter, sql, jupysql, jinja",
     "property=og:locale": "en_US"
    }
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "70d770717fb5a42e0e8fc57cee0e68de4e4328ed30e100d18878b58ca475a80f"
+   }
   }
  },
  "nbformat": 4,
-Original file line number
+Diff line change
@@ Expand Up / @@ -41,6 +41,7 @@ df = pd.DataFrame(np.random.randn(num_rows, num_cols)) @@
     ```{code-cell} ipython3
     import duckdb
     conn = duckdb.connect()
     ```
@@ Expand Down @@