[SymForce] New Images

Fix the favicon, new banner image

Not sure how I feel about the dark mode one and whether it's too busy /
hard to read, and if I should just go back to the white box or fill in
more or something

Topic: sym-images
Reviewers: hayk,bradley
GitOrigin-RevId: 50d96fc1a10087dccd05e5cfce9c2df076116e1e

Author: aaron-skydio

.gitattributes

@@ -3,6 +3,7 @@
 
 # Do not use git-fat for images in SymForce, to be copybara
 # compatible and to show them from the README on Github.
+*.ico filter=
 *.png filter=
 *.jpg filter=
 *.gif filter=

Makefile

@@ -177,6 +177,8 @@ PY_EXTENSION_MODULE_PATH?=$(BUILD_DIR)/pybind
 docs_html: docs_apidoc
 	export PYTHONPATH=$(PY_EXTENSION_MODULE_PATH):$(PYTHONPATH); \
 	SYMFORCE_LOGLEVEL=WARNING $(PYTHON) -m sphinx -b html docs $(DOCS_DIR) -j $$(nproc)
+	mkdir $(DOCS_DIR)/docs
+	ln -s ../_static $(DOCS_DIR)/docs/static
 
 docs: docs_clean docs_html
 

README.md

@@ -1,12 +1,16 @@
-<a href="http://symforce.org" target="_blank">
-<img alt="SymForce" src="https://symforce-6d87c842-22de-4727-863b-e556dcc9093b.vercel.app/images/symforce_horizontal_white.png" width="600px"/>
-</a>
-
-[![Documentation](https://img.shields.io/badge/api-docs-blue)](https://symforce.org)
-[![Source Code](https://img.shields.io/badge/source-code-blue)](https://github.com/symforce-org/symforce)
-[![Issues](https://img.shields.io/badge/issue-tracker-blue)](https://github.com/symforce-org/symforce/issues)
-![Python 3.8](https://img.shields.io/badge/python-3.8-blue)
-![C++ 14](https://img.shields.io/badge/c++-14-blue)
+<!-- There's no good way to make an image that's different on light/dark mode that also links
+    somewhere.  The closest thing is to add a #gh-light-mode-only to the target, which does this,
+    but is kinda confusing -->
+![SymForce](docs/static/symforce_banner.png#gh-light-mode-only)
+![SymForce](docs/static/symforce_banner_dark.png#gh-dark-mode-only)
+
+<p align="center">
+<a href="https://symforce.org"><img alt="Documentation" src="https://img.shields.io/badge/api-docs-blue" /></a>
+<a href="https://github.com/symforce-org/symforce"><img alt="Source Code" src="https://img.shields.io/badge/source-code-blue" /></a>
+<a href="https://github.com/symforce-org/symforce/issues"><img alt="Issues" src="https://img.shields.io/badge/issue-tracker-blue" /></a>
+<img alt="Python 3.8" src="https://img.shields.io/badge/python-3.8-blue" />
+<img alt="C++14" src="https://img.shields.io/badge/c++-14-blue" />
+</p>
 
 ---
 

docs/conf.py

@@ -142,7 +142,9 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["static"]
 
-html_favicon = "static/favicon.png"
+html_css_files = ["css/custom.css"]
+
+html_favicon = "static/favicon.ico"
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.

docs/static/android-chrome-192x192.png

@@ -0,0 +1,3 @@
+[href$="#gh-dark-mode-only"], [src$="#gh-dark-mode-only"] {
+  display: none;
+}

docs/static/android-chrome-512x512.png

@@ -0,0 +1 @@
+{"name":"","short_name":"","icons":[{"src":"/android-chrome-192x192.png","sizes":"192x192","type":"image/png"},{"src":"/android-chrome-512x512.png","sizes":"512x512","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}