Skip to content

Conversation

@raebot
Copy link
Contributor

@raebot raebot commented Feb 5, 2026

This PR upgrades JupyterBook to v2 and also removes and gitignores compiled portfolio sites. Many of the file changes in this PR are a result of removing the portfolio site files, so there is quite a bit of noise.

You can see the result of this upgrade on staging for these portfolio sites:

When attempting to deploy other sites, I ran into the following errors that analysts will need to address in the notebooks before we can deploy.

  • district_digest - error where NB cell has no output
  • gtfs_digest - ValueError: Unable to determine data type for the field "Percent of Trips with Vehicle Positions"
  • new_transit_metrics - needs to be migrated off of siuba
  • ntd_annual_ridership_report - needs to be migrated to us GCSPandas helpers - got the ArrowInvalid error
  • ntd_monthly_ridership - error importing label_visualization from shared_utils.portfolio_utils
  • rt_trip_updates_operator_metrics - needs to be migrated to us GCSPandas helpers - got the ArrowInvalid error
  • rt_trip_updates_stop_metrics - needs to be migrated to us GCSPandas helpers - got the ArrowInvalid error
  • rt - error in %%capture_parameters cell in ca_transit_speed_maps/01_new_speedmaps.ipynb
  • thruway_intercity_bus - issue with vegafusion[embed] install

Relates to #1854

@raebot raebot self-assigned this Feb 5, 2026
* sb125_fund_split_analysis
* high_quality_transit_areas - needed to migrate to notebook GCSPandas
* ahsc
@raebot raebot force-pushed the mov/1864-upgrade-jupyter-book branch from 57cea77 to f6cef4b Compare February 6, 2026 17:55
@raebot raebot requested a review from edasmalchi February 6, 2026 17:55
@raebot raebot force-pushed the mov/1864-upgrade-jupyter-book branch from f6cef4b to fc2448b Compare February 6, 2026 17:59
@raebot
Copy link
Contributor Author

raebot commented Feb 6, 2026

  • Figure out vega editor functionality
Screenshot 2026-02-06 at 10 16 15 AM
  • Get fuller width for visualizations

  • Style dropdowns

Screenshot 2026-02-06 at 10 21 06 AM
  • Possible to show active page links?

  • Change build stderr default to true

  • MD H3 header not rendering correctly on HQTA branching page

Screenshot 2026-02-06 at 10 35 33 AM
  • Hide contents right side menu?

  • Link not rendering on HQTA stop frequency

Screenshot 2026-02-06 at 10 27 24 AM
  • CalITP logo at bottom of page - poll the team Keep the logos in, figure out way to get them rendering better

@edasmalchi
Copy link
Member

currently using fixed widths for webapp maps -- can we make that dynamic somehow?

def display_spa_map(spa_map_url: str, width: int = 1000, height: int = 650) -> None:
"""
Display map from external simple web app in the notebook/JupyterBook context via an IFrame.
Width/height defaults are current best option for JupyterBook, don't change for portfolio use
width, height: int (pixels)
"""
i = IFrame(spa_map_url, width=width, height=height)
display(i)
return

@raebot raebot force-pushed the mov/1864-upgrade-jupyter-book branch from 3539f34 to 79d830a Compare February 9, 2026 19:02
@raebot
Copy link
Contributor Author

raebot commented Feb 9, 2026

Hey @edasmalchi , we noticed that JupyterBook v2 changes the way URLs for the sites and subpages are generated. For instance, with v1 we have https://analysis.dds.dot.ca.gov/hqta_explorer/00__19_spatial_pathway__.html and or v2 we have https://analysis-staging.dds.dot.ca.gov/hqta_explorer/spatial-pathway/index.html. Is this ok? Do you all reference these v1 URLs elsewhere or know of people relying on these subpage URLs?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants