mirror of
https://gitlab.com/ansol/web-ansol.org.git
synced 2024-12-12 23:37:11 +00:00
160 lines
10 KiB
Markdown
160 lines
10 KiB
Markdown
|
<p align="center"><a href="https://sourcethemes.com/academic/" target="_blank" rel="noopener"><img src="https://sourcethemes.com/academic/img/logo_200px.png" alt="Academic logo"></a></p>
|
||
|
|
||
|
# [Academic](https://sourcethemes.com/academic/): the website builder for [Hugo](https://gohugo.io)
|
||
|
|
||
|
### The Page Builder to Easily Create Professional Websites :pencil2: :newspaper: :rocket:
|
||
|
|
||
|
**Create a free website with Academic using Markdown, Jupyter, or RStudio. Choose a beautiful color theme and build anything with the Page Builder - over 50 _widgets_, _themes_, and _language packs_ included!**
|
||
|
|
||
|
[Check out the latest **demo**](https://academic-demo.netlify.app) of what you'll get in less than 10 minutes, or [view the **showcase**](https://sourcethemes.com/academic/#expo) of personal, project, and business sites.
|
||
|
|
||
|
- 👉 [**Get Started**](https://sourcethemes.com/academic/docs/install/)
|
||
|
- 📚 [View the **documentation**](https://sourcethemes.com/academic/docs/)
|
||
|
- 💬 [Chat with the **Academic community**](https://spectrum.chat/academic) or [**Hugo community**](https://discourse.gohugo.io)
|
||
|
- 🐦 Twitter: [@source_themes](https://twitter.com/source_themes) [@GeorgeCushen](https://twitter.com/GeorgeCushen) [#MadeWithAcademic](https://twitter.com/search?q=%23MadeWithAcademic&src=typd)
|
||
|
- 💡 [Request a **feature** or report a **bug**](https://github.com/gcushen/hugo-academic/issues)
|
||
|
- ⬆️ **Updating?** View the [Update Guide](https://sourcethemes.com/academic/docs/update/) and [Release Notes](https://sourcethemes.com/academic/updates/)
|
||
|
- :heart: **Support development** of Academic:
|
||
|
- ☕️ [**Donate a coffee**](https://paypal.me/cushen)
|
||
|
- 💵 [Become a backer on **Patreon** and **unlock rewards**](https://www.patreon.com/cushen)
|
||
|
- 🖼️ [Decorate your laptop or journal with an Academic **sticker**](https://www.redbubble.com/people/neutreno/works/34387919-academic)
|
||
|
- 👕 [Wear the **T-shirt**](https://academic.threadless.com/)
|
||
|
- :woman_technologist: [**Contribute**](https://sourcethemes.com/academic/docs/contribute/)
|
||
|
|
||
|
[![Screenshot](https://raw.githubusercontent.com/gcushen/hugo-academic/master/academic.png)](https://github.com/gcushen/hugo-academic/)
|
||
|
|
||
|
**Key features:**
|
||
|
|
||
|
- **Page builder** - Create *anything* with [**widgets**](https://sourcethemes.com/academic/docs/page-builder/) and [**elements**](https://sourcethemes.com/academic/docs/writing-markdown-latex/)
|
||
|
- **Edit any type of content** - Blog posts, publications, talks, slides, projects, and more!
|
||
|
- **Create content** in [**Markdown**](https://sourcethemes.com/academic/docs/writing-markdown-latex/), [**Jupyter**](https://sourcethemes.com/academic/docs/jupyter/), or [**RStudio**](https://sourcethemes.com/academic/docs/install/#install-with-rstudio)
|
||
|
- **Plugin System** - Fully customizable [**color** and **font themes**](https://sourcethemes.com/academic/themes/)
|
||
|
- **Display Code and Math** - Code highlighting and [LaTeX math](https://en.wikibooks.org/wiki/LaTeX/Mathematics) supported
|
||
|
- **Integrations** - [Google Analytics](https://analytics.google.com), [Disqus commenting](https://disqus.com), Maps, Contact Forms, and more!
|
||
|
- **Beautiful Site** - Simple and refreshing one page design
|
||
|
- **Industry-Leading SEO** - Help get your website found on search engines and social media
|
||
|
- **Media Galleries** - Display your images and videos with captions in a customizable gallery
|
||
|
- **Mobile Friendly** - Look amazing on every screen with a mobile friendly version of your site
|
||
|
- **Multi-language** - 15+ language packs including English, 中文, and Português
|
||
|
- **Multi-user** - Each author gets their own profile page
|
||
|
- **Privacy Pack** - Assists with GDPR
|
||
|
- **Stand Out** - Bring your site to life with animation, parallax backgrounds, and scroll effects
|
||
|
- **One-Click Deployment** - No servers. No databases. Only files.
|
||
|
|
||
|
## Themes
|
||
|
|
||
|
Academic comes with **automatic day (light) and night (dark) mode** built-in. Alternatively, click the sun/moon icon in the top right of the [Demo](https://academic-demo.netlify.app) to set your preferred mode!
|
||
|
|
||
|
Choose a stunning theme for your site and [customize it](https://sourcethemes.com/academic/docs/customization/#custom-theme) to your liking:
|
||
|
|
||
|
[![Themes](https://raw.githubusercontent.com/gcushen/hugo-academic/master/images/themes.png)](https://sourcethemes.com/academic/themes/)
|
||
|
|
||
|
[Browse more themes...](https://sourcethemes.com/academic/themes/)
|
||
|
|
||
|
## The Future of Technical Content Writing
|
||
|
|
||
|
[![Writing technical content](https://sourcethemes.com/academic/img/docs/writing-technical-content.gif)](https://academic-demo.netlify.apppost/writing-technical-content/)
|
||
|
|
||
|
## Ecosystem
|
||
|
|
||
|
* **[Academic Admin](https://github.com/sourcethemes/academic-admin):** An admin tool to import publications from BibTeX or import assets for an offline site
|
||
|
* **[Academic Scripts](https://github.com/sourcethemes/academic-scripts):** Scripts to help migrate content to new versions of Academic
|
||
|
|
||
|
## Install
|
||
|
|
||
|
You can choose from one of the following four methods to install:
|
||
|
|
||
|
* **one-click install using your web browser (recommended)**
|
||
|
* install on your computer using Git with the Command Prompt/Terminal app
|
||
|
* install on your computer by downloading the ZIP files
|
||
|
* install on your computer with RStudio
|
||
|
|
||
|
### Install with web browser
|
||
|
|
||
|
[**Create your site now with Netlify** :rocket:](https://app.netlify.com/start/deploy?repository=https://github.com/sourcethemes/academic-kickstart)
|
||
|
|
||
|
* One-click install of Academic creates an `academic-kickstart` repository in your GitHub or GitLab account
|
||
|
* Netlify will provide you with a customizable URL to access your new site, [or get your own domain](https://sourcethemes.com/academic/docs/domain/)
|
||
|
* Around 1-5 minutes after editing content in your repository, your site will automatically update
|
||
|
- If your site fails to update, [login to Netlify](https://www.netlify.com/), click your site, go to **Deploys**, and review the latest deploy log for any errors
|
||
|
* To **easily edit your site in a rich online editor in your browser**,
|
||
|
- [Login to Netlify](https://www.netlify.com/) and click the site you deployed with Netlify
|
||
|
- Go to **Settings > Identity**, and select **Enable Identity** service
|
||
|
- Under **Registration** preferences, select **Invite Only**
|
||
|
- Scroll down to **Services > Git Gateway**, and click **Enable Git Gateway**
|
||
|
- Head over to **`YOUR_SITE.com/admin/`** to view your content management panel and begin publishing content
|
||
|
- For support with _Netlify CMS_ admin panel, refer to the [Netlify CMS docs](https://www.netlifycms.org/docs/add-to-your-site/#authentication) and the very active [Netlify CMS community](https://www.netlifycms.org/community/)
|
||
|
* To edit your site in a [Markdown editor](https://www.typora.io) on your computer,
|
||
|
- Perform the steps in the [*Install with Git*](#install-with-git) section below
|
||
|
|
||
|
Once you have followed the link above to automatically install Academic, head on over to your new `academic-kickstart` repository in your GitHub (or GitLab) account and [personalize your site by editing the files in](https://sourcethemes.com/academic/docs/get-started/) `config/_default/`. Shortly after saving (i.e. *committing* a file), your site will automatically update.
|
||
|
|
||
|
View the [Homepage Builder](https://sourcethemes.com/academic/docs/page-builder/) and [Content](https://sourcethemes.com/academic/docs/managing-content/) guides to learn how to add widgets and content. For inspiration, refer to the [Markdown content](https://github.com/gcushen/hugo-academic/tree/master/exampleSite) which powers the [Demo](https://academic-demo.netlify.app).
|
||
|
|
||
|
### Install with Git
|
||
|
|
||
|
Prerequisites:
|
||
|
|
||
|
* [Download and install Git](https://git-scm.com/downloads)
|
||
|
* [Download and install Hugo Extended v0.65-v0.72](https://gohugo.io/getting-started/installing/#quick-install)
|
||
|
|
||
|
Install:
|
||
|
|
||
|
1. [Fork](https://github.com/sourcethemes/academic-kickstart#fork-destination-box) the *Academic Kickstart* repository to create a new website
|
||
|
* If you already created your site with **Netlify**, then skip this step
|
||
|
2. Clone your fork to your computer with Git, replacing `sourcethemes` in the command below with your GitHub username:
|
||
|
|
||
|
```bash
|
||
|
git clone https://github.com/sourcethemes/academic-kickstart.git My_Website
|
||
|
```
|
||
|
|
||
|
3. Initialize the theme:
|
||
|
|
||
|
```bash
|
||
|
cd My_Website
|
||
|
git submodule update --init --recursive
|
||
|
```
|
||
|
|
||
|
### Install with ZIP
|
||
|
|
||
|
Prerequisites:
|
||
|
|
||
|
* [Download and install Hugo Extended v0.65-v0.72](https://gohugo.io/getting-started/installing/#quick-install)
|
||
|
|
||
|
Install:
|
||
|
|
||
|
1. [Download](https://github.com/sourcethemes/academic-kickstart/archive/master.zip) and extract *Academic Kickstart*
|
||
|
2. [Download](https://github.com/gcushen/hugo-academic/archive/master.zip) and extract the *Academic theme* files from the `hugo-academic-master` folder to the `themes/academic/` folder in *Academic Kickstart*
|
||
|
|
||
|
### Install with RStudio
|
||
|
|
||
|
[Install Academic with RStudio](https://sourcethemes.com/academic/docs/install/#install-with-rstudio)
|
||
|
|
||
|
## Demo content
|
||
|
|
||
|
For inspiration, refer to the [Markdown content](https://github.com/gcushen/hugo-academic/tree/master/exampleSite) which powers the [Demo](https://academic-demo.netlify.app).
|
||
|
|
||
|
If you wish to initialise your site with the demo content, copy the contents of the `themes/academic/exampleSite/` folder to your website root folder, overwriting existing files if necessary. The `exampleSite` folder contains an example config file and content to help you get started. The following command can be used to accomplish this:
|
||
|
|
||
|
```bash
|
||
|
cp -av themes/academic/exampleSite/* .
|
||
|
```
|
||
|
|
||
|
## Get Started
|
||
|
|
||
|
[View the guide to Personalize and Deploy your new site](https://sourcethemes.com/academic/docs/get-started/).
|
||
|
|
||
|
## Updating
|
||
|
|
||
|
[View the Update Guide](https://sourcethemes.com/academic/docs/update/).
|
||
|
|
||
|
Feel free to *star* the project on [Github](https://github.com/gcushen/hugo-academic/) and follow [@source_themes](https://twitter.com/source_themes) on Twitter to help keep track of [updates](https://sourcethemes.com/academic/updates).
|
||
|
|
||
|
## License
|
||
|
|
||
|
Copyright 2016-present [George Cushen](https://georgecushen.com).
|
||
|
|
||
|
Released under the [MIT](https://github.com/gcushen/hugo-academic/blob/master/LICENSE.md) license.
|
||
|
|
||
|
[![Analytics](https://ga-beacon.appspot.com/UA-78646709-2/hugo-academic/readme?pixel)](https://github.com/igrigorik/ga-beacon)
|