sphinx-simrofy-theme
Simrofy has NOT been prepared for wide distribution. Now it is still in beta.
Simrofy is a theme for the Sphinx documentation generator. It is NOT designed for writing techinical documenation, but for building a portfolio/CV website to introduce yourself to those who may concern.
Simrofy was intendedly developed to build personal neat website to share around academia, so it owns some features merely useful for academic users. However, Simrofy also serves well as an easy-to-use static website choice for non-academic users.
Table of contents:
Installation & Usage
Simrofy is a theme for Sphinx, so you can't use it without installing Sphinx. Users are required to install:
- Python (>= 3.6)
- Sphinx >= 4.0, and following extensions:
nbsphinx>=0.8.4
for MathJax v3 supportsphinxcontrib-bibtex>=2.0.0
for its newly addedbibtex-files
optionsphinx-intl>=2.0.0
if there is need for internationlization (i18n)
Then you can install Simrofy using pip (for stable versions):
pip install sphinx-simrofy-theme
To apply the theme, assign its fullname to the html_theme
variable in your conf.py
file:
html_theme = 'sphinx-simrofy-theme'
Please visit the Simrofy documentation website for full details.
Projects contributing to Simrofy
Simrofy was developed with the help of following existing projects:
- konsav/social-icons: A repo providing many social media icons. See my forked version that adpats the orignal large PNG into separate icons. These icons are put under
static/icon/
of the Simrofy theme folder.
Simrofy also learned a lot from many Sphinx themes, especially:
- Sphinx' builtin basic theme
- Sphinx official website's sphinx-doc (4.x) theme
- Python official website's python-docs-theme theme
- Read the Docs' Sphinx theme sphinx-rtd-theme
Anecdotes
What does "simrofy" mean?
The name "simrofy" is a weird abbreviation of "simple profile", though it is difficult to realize it.
Like many programmers, I am not good at naming things. This strange word is transformed by following steps:
- This theme is for generating a website of "simple profile" style.
- Sequence "ple" is the longest common subsequence (LCS) of words simple and profile.
- Removing LCS from both words gives "sim" and "rofi".
- Concatenate them and we get "simrofi".
- The tailing letter "i" looks silly. Why not change it to letter "y" to make it sillier?
- Now we have "simrofy". I am super pleased with my naming skill.
Who created this confusing logo?
If there is only one person in the world can draw such an ugly logo, that person must be me.
I built this logo by following steps:
- Choose three letters from the word "simrofy": the first one, the last one, and the middle one.
- Rotate the capitalized letter "S" around its center.
- Flip the capitalized letter "R" horizontally.
- Flip the lowercase letter "y" verically. Why not capitalize it? Because I didn't realize that I forgot to do so until I finished drawing the whole logo. I just didn't want to draw again.
- Combine them together. Align the bottom of "S" and "y" and let "R" bridge them two.
- Paint the whole logo with a red-to-blue linear gradient color.
- Now we get the logo. Ugly, but 100% independently developed with proud.