Merge branch 'website' of github.com:mixxxdj/website into new-in-2-3-…

…serato

.github/workflows/build.yml

@@ -0,0 +1,24 @@
+name: Build
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build-check:
+    name: Check build warnings
+    runs-on: ubuntu-latest
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.9
+
+    - name: Set up Python dependencies
+      run: pip install -r requirements.txt
+
+    - name: Check if website build is warning-free
+      run: pelican --extra-settings SITEURL=https://example.com --fatal warnings

content/news/2008-02-01-feature-preview-shoutcast-broadcasting.md

@@ -1,4 +1,4 @@
-title: Feature Preview: Shoutcast Broadcasting
+title: "Feature Preview: Shoutcast Broadcasting"
 authors: Albert Santoni
 date: 2008-02-01 15:40:00
 tags: development, broadcasting

content/news/2013-04-08-calling-all-students-hack-on-mixxx-in-google-summer-of-code-2013.md

@@ -1,4 +1,4 @@
-title: Calling all Students: Hack on Mixxx in Google Summer of Code 2013!
+title: "Calling all Students: Hack on Mixxx in Google Summer of Code 2013!"
 authors: RJ Ryan
 date: 2013-04-08 19:16:00
 tags: gsoc, gsoc-2013

content/news/2020-06-29-black-lives-matter.md

@@ -1,4 +1,4 @@
-title: #BlackLivesMatter: Taking a Stand with Terminology and Recruitment
+title: "#BlackLivesMatter: Taking a Stand with Terminology and Recruitment"
 authors: Mixxx Team, April M. Crehan
 tags: black lives matter, diversity, community, outreachy
 date: 2020-06-29 15:00:00

content/news/2020-07-09-intro-outro-sections.md

@@ -1,4 +1,4 @@
-title: New In 2.3: Intro & Outro Cues, Silence Detection, and AutoDJ Improvements
+title: "New In 2.3: Intro & Outro Cues, Silence Detection, and AutoDJ Improvements"
 authors: Be.
 tags: 2.3
 date: 2020-07-09 01:00:00

content/news/2020-07-15-new-in-2-3-cmake.md

@@ -1,4 +1,4 @@
-title: New in 2.3: Build Mixxx with CMake
+title: "New in 2.3: Build Mixxx with CMake"
 authors: Jan Holthuis
 tags: 2.3, cmake
 date: 2020-07-15 10:00:00

content/news/2020-07-20-new-in-2-3-rekordbox-support.md

@@ -1,4 +1,4 @@
-title: New in 2.3: Importing tracks and cues from Rekordbox removable devices
+title: "New in 2.3: Importing tracks and cues from Rekordbox removable devices"
 authors: Evan
 tags: 2.3, rekordbox
 date: 2020-07-20 12:00:00

content/news/2020-08-20-meter-detection.md

@@ -1,4 +1,4 @@
-title: GSoC 2020: Adding Experimental Meter Detection
+title: "GSoC 2020: Adding Experimental Meter Detection"
 authors: Cristiano Lacerda
 tags: gsoc, gsoc-2020, analyzer
 slug: Meter-Detection

content/news/2020-08-22-portable-mixxx-setup.md

@@ -1,4 +1,4 @@
-title: Guest Article: DJ on the fly with Mixxx and Raspberry Pi
+title: "Guest Article: DJ on the fly with Mixxx and Raspberry Pi"
 authors: dennis
 tags: mixxx in the wild, raspberry pi
 date: 2020-08-22 12:00:00

content/news/2020-08-25-new-in-2-3-hotcue-colors.md

@@ -1,4 +1,4 @@
-title: New in 2.3: Color your Hotcues
+title: "New in 2.3: Color your Hotcues"
 authors: Jan Holthuis
 tags: raspberry pi
 date: 2020-08-25 12:00:00

content/news/2020-10-24-new-in-2-3-track-colors.md

@@ -1,4 +1,4 @@
-title: New in 2.3: Colorize your Tracks!
+title: "New in 2.3: Colorize your Tracks!"
 authors: Jan Holthuis
 tags: 2.3, library
 date: 2020-10-24 12:00:00

content/news/2020-11-15-new-in-2-3-deck-clone.md

@@ -1,4 +1,4 @@
-title: New in 2.3: Deck Cloning
+title: "New in 2.3: Deck Cloning"
 authors: Matthew Nicholson
 tags: 2.3
 date: 2020-11-15 13:36:00

content/news/2020-12-01-about-me.md

@@ -0,0 +1,116 @@
+title: "About my Outreachy internship with Mixxx DJ: Intro"
+authors: Aanyu Deborah Oduman
+tags: personal, outreachy, internship
+date: 2020-12-01 23:15:00
+summary: In October, [Mixxx announced]({filename}/news/2020-10-01-outreachy.md) that it had been accepted into the [Outreachy program](https://www.outreachy.org/outreachy-december-2020-internship-round/communities/mixxx-dj-software/). This program provides a three-month internship to work in Free and Open Source Software (FOSS) and I was selected as the first contributor! Hi, my name is Deborah and in this blog post, I will be introducing myself.
+
+_In October, [Mixxx announced]({filename}/news/2020-10-01-outreachy.md) that it had been accepted into the [Outreachy program](https://www.outreachy.org/outreachy-december-2020-internship-round/communities/mixxx-dj-software/). This program provides a three-month internship to work in Free and Open Source Software (FOSS) and I was selected as the first contributor! I will work mainly on improving the [Mixxx manual](https://manual.mixxx.org/2.2/en/) while making video tutorials teaching users how to use Mixxx. While I do so, I will document my journey and work in a series of posts here on the website._
+
+## A little bit about me.
+
+My name is Deborah Aanyu, from Uganda.
+I am 23 years old. I come from a family of five children – I am the eldest.
+I have been in Catholic (single sex) school for most of my education, and it was during this time that I got to appreciate the beauty of God in the world, and in my life. I was in mixed school for only two years, up until University.
+As an adventurous person, I like to try out a lot of things; from art and painting, to singing, writing, sports (basketball), web development, among other things.
+
+I am generally optimistic and believe the good in people. I like to read and write.
+I like to dream, talk, listen and see the sunrise in the morning.
+I like to see the moonlight at night and feel the rain on my face.
+I like flowers.
+I like delicious food and comfortable shoes. I like warm clothes and a nice cup of tea.
+I also love babies, nature and laughter. I love food and listening to music.
+
+I have been studying a Computer Engineering degree at Makerere University, Kampala for the last four years, and I finished my final examinations just recently. So I’ve been really excited about getting done with school and  having the time to focus on what I really want to do which is software development and contributing to Open source!!
+
+I will be working on improving Mixxx's user manual for the Outreachy Internship.
+Mixxx DJ is an Open Source application for DJs that gives them the power to mix songs for free.
+Each day that I wake up, I am so grateful for the opportunities that I am given, and looking at how I got here, I can’t help but feel enthusiastic for the journey ahead! I’m here for all of it.
+
+I would love to travel and see the world someday, meet new people and make new friendships.
+There are many things that I would love to do, see, and experience.
+I am also working towards attaining seniority level with web development (particularly with JavaScript) and just the MERN stack (MongoDB, Express, React and Node.js) in general. (Let’s give it one more year)
+I aspire to be successful at everything that I do so that I can share my journey and use my experience to inspire other people, especially women.
+I am passionate about women empowerment and would love to see more women leaders in the technology sector.
+
+### My top three core values
+#### Honesty
+
+As a young teen, I was very shy – bordering on fearful. I feared everybody including my own parents.
+I feared to do the wrong thing because I wanted to be in everybody’s good books.
+I needed the approval of my friends, family and everybody who cared about me.
+Because of this, I was telling lies all the time. I was turning into a diabolical liar.
+
+![why you lyin'?]({static}/images/news/giphy.gif)
+
+I didn’t even lie because I had anything to hide. I lied so that I could tell only the best version of events.
+I lied to avoid attracting too much attention to myself. I lied to make people happy.
+I lied because I was fearful of the consequences, even if my actions were not wrong.
+
+Eventually, I got caught. I saw how my lies were affecting the people around me and my father asked, “why do you lie so much?” and I had no real reason, except for my low self esteem.
+So it wouldn’t be enough to just stop lying (if it was that easy), but I had to work on my self-image, how I felt about about myself in relation to the people around me. One of the hardest things I had to practice at the time, was telling the hard truth, however terrible I thought it was.
+I discovered that people would rather be told the harsh, disappointing, heart-wrenching (lol) truth, than be deceived with words you think they would rather hear.
+I found that I would rather deal with the immediate, but brief disappointment that comes with telling the truth, as opposed to the hurtful or pained expressions on their faces when they found out about the lie.
+I practiced this everyday, even though some days were harder than others, but it got easy. Eventually, the truth became the easier, most obvious option.
+I didn’t have to think twice about it anymore and concoct stories.
+A huge burden is lifted off my shoulders every time I tell the truth in a difficult situation, because I know it would probably be easier to lie.
+I did not lie, and the world didn’t cave in.
+
+It is because of this phase in my life that I appreciate honesty so much more.
+I appreciate it more because I know sometimes the truth can be very difficult, and it is not always easy to say. I appreciate honesty because it comes with no burden, and it leaves you free from guilt – of hurting others or causing even more damage.
+I value honesty because I have seen first hand how badly it can affect relationships with loved ones, how it can end a marriage and a life long friendship.
+Honesty is a core value for me because it has saved me from a lot of things and I can only imagine how my life would have been if I had been transparent from the start.
+
+#### Respect
+
+Respect has been a core value in my family for ages. Sometimes it is easy to take what we have for granted and forget that there are people who do not have half as much. We make friends, and build relationships with people from different backgrounds with different stories. Along the way, we get to peek into other people’s worlds and see how things are done there. It can be easy to judge other people for the way they do certain things just because they do them differently than what you’re used to. And often times, this judgement can reflect in our actions and facial expressions, which might not be very respectful.
+
+I believe that part of respecting other people in society is believing that we were all created differently and there is no singular way to get anything done.
+I also believe that however learned we might be, there is always a thing or two we can learn from the people that we meet everyday.
+When we respect people, then we might be humble enough to learn from their experiences and add to ourselves one way or another.
+We all have different personalities, beliefs and values. We don’t always have to understand other people’s routines, cultures, beliefs and likes, but we can learn to accept that they are different than what our brains have accepted as the norm and that is okay.
+We are all human, we bleed the same, and we shall cease to exist some day. We all have that in common.
+
+#### Adventure
+
+I truly believe everybody deserves to make the most of their time on earth! We only get one life, so don’t waste it.
+Try new things, go to new places and meet new people!
+Adventure can be applied to every aspect of our lives, from the food we eat, to the clothes we wear, to the music we listen to it. You don’t need much to try something new – just an open mind!
+However, I respect that some people might prefer to have a routine and live by it every single day. When we are willing to get out of our comfort zone and try something new, we learn a little bit more about ourselves.
+If you try chocolate ice cream for the first time and you don’t like it, then at least you know for sure that you don’t like it! You’ve learned something new about yourself!
+
+With an adventurous mindset, we become open to learning new things. We are more willing to gain new information and accept that there could be better out there in the world. We open our minds to new knowledge and become more willing to adjust to new changes and environments.
+Adaptability becomes ingrained in us.
+
+## My motivation for applying to Outreachy
+
+So my friend [Jordan Rob](https://twitter.com/Jordan___Rob), and I, are self-taught developers.
+Everything we know, we got off Stack Overflow or YouTube (lol).
+We have shared a number difficulties in trying to be better developers with each passing day.
+With this in common, we promised to always lift each other up and encourage each other to take up new opportunities. We promised that we would not get comfortable and we would always strive to get better at what we do.
+
+So on a random day in August, Jordan tagged me in this tweet and said “let’s apply”. And I replied “kawa” meaning ‘okay okay’.
+
+![Outreachy expressly invites applicants from around the world who face under-representation, systemic bias or discrimination in the technology industry of their country. Apply for our internships, which are completely remote and paid ($6,000 stipend).]({static}/images/news/outreachy_tweet.png)
+
+I replied rather casually after finding out how competitive the application process was.
+I think Jordan and I thought the same thing. “Do we even stand a chance?”
+
+What Jordan and I have in common is that we are both passionate about software development and if we come across any opportunities for growth in the tech sector, we will always look into them.
+Jordan and I have had similar struggles both personally and professionally, and hence we kind of look out for each other in this particular field.
+
+However, one of my setbacks was that I had a slight case of the imposter syndrome (a psychological pattern in which an individual doubts their skills, talents or accomplishments and has a persistent internalized fear of being exposed as a “fraud”).
+I was constantly thinking to myself that I needed to be a little bit better before applying for any job or internship.
+And so I found myself stuck in a cycle of tutorials, learning more and more and never really using the knowledge to contribute to any real life applications.
+
+Before the start of this year, I did not know the meaning of ‘Open Source’. I had always thought that it was a fancy term for very-hard-to-code software. I had googled the term before, but the search results always brought up some blog posts (that I found quite intimidating) about “How to get started on your first contribution”, that I could not really relate with. So my friend Jordan Rob tags me, and I ask rather sternly what Open Source is really all about. And he breaks it down for me bit by bit.
+
+Once I discovered that I could contribute to software applications that people use everyday, in a major way, my excitement grew!
+I did some research and found that I, too, could contribute to repositories of some of the most common and widely used software applications.
+I was happy because my fraudulent feeling was wrong! I didn’t have to be an absolute pro at code to contribute because there were other significant ways that I could do so!
+Through documentation, graphics and editing, video making, audio recording among several other ways. So when the Outreachy internship opportunity came along, I grabbed it with both hands!
+
+But my motivation for applying for the Outreachy internship does not end here.
+I had always yearned for a chance to work on a project that I was really passionate about together with a group of really talented developers from whom I could learn a lot and come out of there several times better than I started.
+I have a strong will to gain technical expertise and use the knowledge to make people’s lives better.
+I was motivated by the thought that if I actively contributed to an open source project that people actively used, I would benefit from the transparency of collaboration and would be able to evaluate the risks associated with required features or bug fixes more precisely.
+Moreover, I could actively shape the roadmap (by contributing) or at least influence its prioritization. How cool is that?!

content/news/2020-12-06-week-1-progress.md

@@ -0,0 +1,19 @@
+title: "About my Outreachy internship with Mixxx DJ: Week 1 progress"
+authors: Aanyu Deborah Oduman
+tags: personal, internship, manual, personal
+date: 2020-12-06 18:10:00
+
+_This is the first of many weekly progress reports that I will be publishing for the duration of my Outreachy internship with Mixxx DJ_.
+
+This week:
+
+- I submitted [pull request #313](https://github.com/mixxxdj/manual/pull/313#pullrequestreview-543022384) in response to this [issue](https://github.com//issues/272).
+  I added the base commands for each platform (MacOS, Windows and Linux) onto the which the command-line options can be appended.
+- Currently working on [issue #157](https://github.com/mixxxdj/manual/issues/157) – which is documenting the Rekordbox library import.
+  I had run into a slight problem with pulling the latest changes made by some of the outreachy applicants during the contribution phase. Luckily, some of the contributors from the Mixxx community helped me figure it out. It took me longer than I expected but I hope to have made a PR for this issue by the end of today.
+- I have also been working on my first video tutorial on “Getting started with Mixxx”.
+  The plan is to make it then share the link in the chat so that I can get feedback, before I make the final. This is my first time making a YouTube tutorial, so it’s taking me a little bit of time. I wanted to record my voice as I made the tutorial but I faced some difficulty doing both at the same time (focusing on the script and my actions at the same time). So I have decided to try making the video first, then recording my voice in the video after.
+- Lost a day of work (maybe two) to the
+  last two issues.
+- I’m thinking of a proper way to start working on the cookbook.
+  I will need to consult on this – whether it should be in GitHub pages, a GitHub repo with `*.rst` files (like the manual) or….. a simple website or…. something else.

content/news/2020-12-14-scons-cmake-migration.md

@@ -1,5 +1,5 @@
 title: SCons build system dropped in favor of CMake
-author: Jan Holthuis
+authors: Jan Holthuis
 date: 2020-12-14 14:07:57
 tags: development, 2.3, beta, cmake, scons
 

content/news/2020-12-14-week-2-progress.md

@@ -0,0 +1,21 @@
+title: "About my Outreachy internship with Mixxx DJ: Week 2 progress"
+authors: Aanyu Deborah Oduman
+tags: personal, outreachy, internship, manual
+date: 2020-12-14 13:40:00
+
+_This is the second of many weekly progress reports that I will be publishing for the duration of my Outreachy internship with Mixxx DJ_.
+
+This week:
+
+- I made a [pull request #322](https://github.com/mixxxdj/manual/pull/322) in response to [issue #157](https://github.com/mixxxdj/manual/issues/157).
+  I added missing documentation about importing rekordbox libraries from rekordbox prepared devices into Mixxx. This is still in review.
+- I made my first YouTube Mixxx tutorial titled “Getting Started”.
+  I posted the video in the chat, and got feedback from some of the other contributors. I plan to record another video, and make some adjustments this time (based on the feedback that I got from the first.)
+- Currently working on [issue #289](https://github.com/mixxxdj/manual/issues/289) –
+  which is moving the Standard effects mapping documentation to the manual.
+- I lost a day of work to correcting git errors while making the
+  [pull request #322](https://github.com/mixxxdj/manual/pull/322).
+- I lost a day or two as well to re-recording the video tutorial and editing.
+  I had recorded my voice and my computer screen at the same time, but that wasn’t working out too well. I later on decided to record my screen and voice separately and then merge the two in the final video.
+- So this week, I plan to make another recording    for “Getting Started with Mixxx DJ” with the      suggested edits and then make a PR for [issue #289](https://github.com/mixxxdj/manual/issues/289) and [issue #320](https://github.com/mixxxdj/manual/issues/320).
+    I will also finalize the list of recipes to publish for the cookbook.