Welcome to the Venmurasu Programming Contest website โ your gateway to a world of coding excellence and innovation!
This website is a replication of the Tamil Wiki, specifically tailored for the Venmurasu Programming Contest. We've harnessed the power of Hugo and the Book-Master theme to bring you an immersive and visually appealing experience.
The themes used in this project are sourced from the official Hugo Themes repository. You can explore and find more themes at Hugo Themes.
Follow these steps to set up the project locally:
To convert your XML content to Markdown, we've utilized Pandoc and a PHP script. Run the following commands:
Convert MediaWiki pages to GitHub flavored Markdown (or other formats supported by Pandoc). The conversion uses an XML export from MediaWiki and converts each wiki page to an individual markdown file. Directory structures will be preserved. The generated export can also include frontmatter for Github pages.
You may also be interested in a forked version of this codebase available at https://github.com/outofcontrol/mediawiki-to-gfm
- PHP
- Pandoc
You'll export all your pages as a single XML file following these steps: http://en.wikipedia.org/wiki/Help:Export
http://johnmacfarlane.net/pandoc/installing.html
curl -sS https://getcomposer.org/installer | php
php composer.phar install
####--filename####
The only required parameter is filename
for the name of the xml file you exported from MediaWiki, eg:
php convert.php --filename=mediawiki.xml
####--output####
You can also use output
to specify an output folder since each wiki page in the XML file will generate it's own separate markdown file.
php convert.php --filename=mediawiki.xml --output=export
####--indexes####
You can set indexes
as true
if you want pages with the same name as a directory to be renamed as index.md and placed into their directory
php convert.php --filename=mediawiki.xml --output=export --indexes=true
####--frontmatter####
You can specify whether you want frontmatter included. This is automatically set to true
when the output format is markdown_github
php convert.php --filename=mediawiki.xml --output=export --format=markdown_phpextra --frontmatter=true
####--format####
You can specify different output formats with format
. The default is markdown_github
. See
php convert.php --filename=mediawiki.xml --output=export --format=markdown_phpextra
Supported pandoc formats are:
- markdown
- mediawiki
# Install Pandoc
sudo apt-get install pandoc
# Run the PHP script for conversion
php convert.php input.xml output.md
Follow the official Hugo installation guide to install Hugo on your machine.
hugo new site venmurasu-programming-contest
cd venmurasu-programming-contest
git submodule add https://github.com/murugavel123/hugo-wiki-theme
Navigate to the themes/book-master
directory and customize the HTML and CSS files according to your needs.
hugo server -D
Open your browser and visit http://localhost:1313
to see the website in action.
- Responsive Design: Enjoy a seamless experience on various devices.
- Custom Styling: We've fine-tuned the visuals to reflect the spirit of the Venmurasu Programming Contest.
- Content-rich Pages: Explore the Home, About, and Contest pages for comprehensive information.
Discover the latest updates, announcements, and highlights of the Venmurasu Programming Contest. Your starting point for this exciting journey!
Uncover the story behind the contest. Learn about its origins, objectives, and the passionate individuals driving it forward.
Get ready for the coding challenge of a lifetime! Find detailed information about the rules, registration, and important dates.
We welcome contributions! If you have suggestions, bug reports, or want to add features, please reach out to us at contact@kavinT.com.
This project is licensed under the MIT License - see the LICENSE.md file for details.
Have questions, feedback, or just want to chat? Feel free to reach out to us at contact@kavinT.com.
Happy coding!