The Ur-Quan Masters Home Page Welcome, Guest. Please login or register.
Did you miss your activation email?
March 28, 2024, 03:45:42 pm
Home Help Search Login Register
News: Celebrating 30 years of Star Control 2 - The Ur-Quan Masters

+  The Ur-Quan Masters Discussion Forum
|-+  The Ur-Quan Masters Re-Release
| |-+  Starbase Café (Moderator: Death 999)
| | |-+  Archania@GitHub.com
« previous next »
Pages: [1] Print
Author Topic: Archania@GitHub.com  (Read 1038 times)
Zanthius
Enlightened
*****
Offline Offline

Posts: 941



View Profile
Archania@GitHub.com
« on: November 29, 2017, 11:12:04 pm »

I have uploaded all the tex files for my website to github. I would love to have you guys as contributers there!

https://github.com/ZanthiusOfArchania/Archania
Logged
Scalare
*Many bubbles*
***
Offline Offline

Posts: 245



View Profile
Re: Archania@GitHub.com
« Reply #1 on: November 30, 2017, 12:49:13 pm »

I think that .md (markdown) files work better on github instead  of latex files.
https://guides.github.com/features/mastering-markdown/

Then again, a wiki might even be better?
Logged
Zanthius
Enlightened
*****
Offline Offline

Posts: 941



View Profile
Re: Archania@GitHub.com
« Reply #2 on: November 30, 2017, 05:00:23 pm »

I think that .md (markdown) files work better on github instead  of latex files.
https://guides.github.com/features/mastering-markdown/

Then again, a wiki might even be better?

Markdown files are better to edit online on github, but it is easy to edit the latex files on your own computer, and upload them to github:

To make a local copy of the latex files:
git clone https://github.com/ZanthiusOfArchania/Archania.git

If you already have a local version, you can write: "git pull" from your local directory, to check that it is updated.

In order to compile the latex files, you need to have latex and some latex libraries installed on your computer. Personally I prefer to write latex code in TexStudio (https://www.texstudio.org/). When you are finished editing, you can just upload the changes to github.

To upload changes from your local directory:
git init
git add .
git commit -m "Updates"
git remote add origin https://github.com/ZanthiusOfArchania/Archania
git remote -v
git push origin master

I have never used GitHub before, so some of you might know much more than me about this, but this seems pretty straightforward to me.
« Last Edit: November 30, 2017, 05:13:49 pm by Zanthius » Logged
Zanthius
Enlightened
*****
Offline Offline

Posts: 941



View Profile
Re: Archania@GitHub.com
« Reply #3 on: December 01, 2017, 06:35:33 pm »

I have added this text to the README.md file at GitHub:

Quote
This repository contain all the LaTeX files used to compile the PDF and HTML files at http://www.archania.org

The objective of http://www.archania.org is to modernize governance and education to become better suited for today.

The main LaTeX file for each article can be found in main.tex, and if the article has a bibliography it can be found in main.bib

TeX Live or MiKTeX can be used to compile PDF documents from the LaTeX files. Tex files can be edited in almost any text editor, but a proper LaTeX editor like TeXstudio is recommended. In order to prevent LaTeX from splitting articles into multiple pages, each article has a custom paperheight which might need to be increased or decreased depending on if text is added or deleted. In the folder of each article there should be a script named tohtml which can be used to convert the PDF document into a HTML file. These scripts require pdf2htmlEX, but are however not necessary to execute, since they will be executed automatically when the articles are uploaded to the website.

You are welcome to collaborate with this project, if you think you can:

  • Find fallacies in the articles
  • Improve the language or design of the articles
  • Expand upon the ideas in the articles
  • Come up with new or better ideas for the articles
  • Improve the conversion from LaTeX to HTML
  • Find a way to increase the maximum legal dimension for paperheight in LaTeX
   

https://github.com/ZanthiusOfArchania/Archania

« Last Edit: December 03, 2017, 01:53:40 am by Zanthius » Logged
Zanthius
Enlightened
*****
Offline Offline

Posts: 941



View Profile
Re: Archania@GitHub.com
« Reply #4 on: December 06, 2017, 09:59:25 pm »

I didn't like pdf2htmlEX so much, so I made my own script to convert LaTeX files to HTML files. It is on GitHub now.

Here is the blueprint for a progressive world democracy, converted with my new script. I am not going to have a PDF version anymore, since I think this is good enough.

http://www.archania.org/governance/

Logged
Zanthius
Enlightened
*****
Offline Offline

Posts: 941



View Profile
Re: Archania@GitHub.com
« Reply #5 on: December 07, 2017, 10:55:25 pm »

Here is the education article converted with my new script. Doesn't look so different, but much more mobile friendly and easier to read for all kinds of browsers and devices.

http://www.archania.org/education/

I have now also converted the other articles with my new script.

http://www.archania.org

« Last Edit: December 08, 2017, 02:58:03 pm by Zanthius » Logged
Pages: [1] Print 
« previous next »
Jump to:  


Login with username, password and session length

Powered by MySQL Powered by PHP Powered by SMF 1.1.21 | SMF © 2015, Simple Machines Valid XHTML 1.0! Valid CSS!