.. _03notes-02website:
================================
Personal Website
================================
Using personal website is an alternate way to present yourself other than CV. There are many tools that can help you build your website. I found Sphinx quite useful. The following section about Sphinx was presented during the Penn State Geoscience Computer Users Group meeting on 03/30/2016.
-----
Making a Website Without Knowing HTML
===============================================
The official website for Sphinx is `http://www.sphinx-doc.org/ `_. You can find detailed instructions about how to use it on the official website.
Installation
------------------------------
You can install Sphinx using Anaconda
conda install sphinx
or pip
pip install sphinx
For PCs, see instrucitons on this `page `_.
Many projects are using Sphinx now, such as GMT, Numpy, matplotlib, pip.
Pros & Cons
------------------------------
Advantages of using Sphinx including
- Don't have to learn HTML syntax (and Python)
- Less efforts on editing and maintaining
- Supporting onversions to other formats, such as Latex and PDF
Disadvantages are
- Not as flexible as HTML
- Advanced features require additional Python packages
- Using bash commands
Basic Process
------------------------------
#. Use sphinx-quickstart to set up the framework
#. Write text files with format markers
#. Convert text files into HTML (make html) or other formats
Severs Available
------------------------------
From the department, you can use **idocrase.geosc.psu.edu**.
For seismology students, you may have access to **eqseis.geosc.psu.edu**.
Demo
------------------------------
You can find the example I used at this address `http://eqseis.geosc.psu.edu/~cchai/SampleWebsite/ `_.
If you click *Show Source* on the left, you will be able to see the text file related to this webpage.