Giter VIP home page Giter VIP logo

oscsa-en-blog's Introduction

Netlify Status

All Contributors

OSCSA-en-blog

OSCSA English blog (https://oscsa-en-blog.netlify.app/)

Add New Blog Post for Outreachy:

  • Fork the repo intern.
  • Navigate to posts and then to the folder where you'll add your post.
  • There is a template called index.qmd where you should add your text/images using Markdown syntax.
  • If you want to add an image, make sure you add it to the same folder which index.qmd is in.
  • Remove draft: true.
  • Run quarto preview in your command line to preview your post.
  • Submit your PR.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Njong Emy
Njong Emy

️️️️♿️
Asma Kacem
Asma Kacem

🖋
Okereke Chinweotito
Okereke Chinweotito

🚇 🚧
Odion Sonny-Egbeahie
Odion Sonny-Egbeahie

📖
Goodnews Sandy
Goodnews Sandy

🐛 📝 📖
Batool Almarzouq
Batool Almarzouq

🚇 📆 🧑‍🏫
Richie
Richie

📝 📖
Abdulrahman Alswaji
Abdulrahman Alswaji

👀

This project follows the all-contributors specification. Contributions of any kind welcome!

oscsa-en-blog's People

Contributors

allcontributors[bot] avatar asmakacem1 avatar batoolmm avatar njong392 avatar odion-sonny avatar okerekechinweotito avatar realrichi3 avatar sandygudie avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

oscsa-en-blog's Issues

[12/10/2022]: Refactor External Links on page

Description

External links should direct to a new browser tab when clicked instead to overiding the current opened browser tab.
We can also add the rel='noopener noreferrer' tag should be added to prevent phishing attacks like tabnabbing

Expected behavior

External links should direct to a new browser tab

Actual behavior

External links override current browser tab when clicked

How to reproduce

Go to https://oscsa-en-blog.netlify.app/
Click on any external link and observe

Similar issue can be found here

[11/10/2022]: TASK 5 - Fix Deploy Preview Not Working

PRs that fixed this issue available at #11 #30 and #31

Description

❔ Improve the continuous integration and deployment (CI/CD) of OSCSA Blog by fixing the deploy preview fail.

Expected behavior

✅ When a PR is made , GitHub Action should be correctly triggered
✅ GitHub should correctly Setup Quarto by running the 'Quarto Publish' Action located in the '.github/workflows' folder after a PR has been made
✅ The new changes should be seen in the deploy-preview link from Netlify

Actual behavior

❌ GitHub Action only gets triggered whenever a commit is merged to the main branch (when you merge a PR to main)
❌ GitHub Action fails to correctly initialize and build Quarto when a PR is made , this makes Netlify to serve the deploy-preview with old data from the last merged PR to main.

What needs to be done

  • On the ./github/workflows file. The code only covers use-cases for merged commit to the main branch (push to main) but does not include a case for Pull Requests.

The current code is written as

on:
  workflow_dispatch:
  push:
    branches: main

I want to Refactor the code to

on:
  workflow_dispatch:
  push:
  pull_request:
    branches: main

This is inline with this Github Netlify-Action Extension Example and Github Action Docs

Screenshot (35)

Who want to work on this issue?

@okerekechinweotito

Screenshot (34)

7/12/2022: Introductory blog Post

Description

  • As part of the requirement for the outreachy internship, I will be adding a blog post to the OSCSA blog.
  • The blog post is an intro about me and getting started in the OSCSA community.

[20/10/2022]: TASK 5 - Add Quarto-Netlify plugin in attempt to fix deploy preview

Similar issues opened to solve this at #8 and #29
PRs that fixed this issue available at #11 #30 and #31

Description

❔ Improve the continuous integration and deployment (CI/CD) of OSCSA Blog by fixing the deploy preview fail.

Expected behavior

✅ When a PR is made , Quarto Netlify Plugin should correctly build the site and make it ready for deploy-preview
✅ The new changes should be seen in the deploy-preview link from Netlify

Actual behavior

❌ Quarto Netlify Plugin has not be installed in the codebase
❌ Netlify serves the deploy-preview with old data from the last merged PR to main.

What needs to be done

Who want to work on this issue?

@okerekechinweotito

[10/1/2023]: Blog: Everyone Struggles

Description
One of the outreachy internship's requirements is writing a blog post. We will collaborate to write a blog post on "Everyone Struggles"

[21/10/2022]: TASK 6 - OSCSA blog is NOT bilingual for users to switch between English and Arabic.

Problem Statement: Task #6

Description
OSCSA blog page not bilingual yet, hindering users accessibility and readability in English and Arabic.

Expected behavior
OSCSA blog page to allow switch in English and Arabic.

Actual behaviour
OSCSA blog page currently available in English only.
task6

Which Task do you want to work on?

Task 6: Making OSCSA blog page bilingual to improve accessibility and readability in English and Arabic.

who wants to work on this issue?

@Jolah1 An Outreachy Applicant

OS:
Windows 10

Outreachy Winter 2022: Applicants tasks/contributions: Fixing OSCSA Blog

🎊 Welcome Outreachy 2022 Contributors! We're excited that you're here 🎉

This ticket will serve as the central point tracking the contributions of perspective Outreachy (Winter 2022 cohort) applicants.

Outreachy provides paid remote, three-month internships to support diversity in Free and Open Source Software (FOSS). For more information about what Outreachy is, follow this link.

Outreachy internships are:

💵 Paid - $7,000 USD total internship stipend

🌍 Remote - both interns and mentors work remotely

🕰 3 months - internships run May to August.

For those interested, this process is described here.

We ask all outreachy candidates to work on a minimum of 3 projects simultaneously so that they are not completely relying on their selection in OSCSA if we end up not selecting them!

Summary

Open Science community Saudi Arabia (OSCSA) was established in line with Saudi Arabia’s Vision 2030, which focuses on installing values, enhancing knowledge and improving equal access to education. It aims to provide a place where newcomers and experienced peers interact, inspire each other to embed open science practices and values in their workflows and provide feedback on policies, infrastructures and support services. Our community is part of the International Network of Open Science & Scholarship Communities (INOSC).

Open Science has a blog post, not yet linked to the website, created using Quarto.

How to start?

Submission

  • Submit a new issue with PR. Use our template for both issue and PR
  • Explain in your PR what you did and what do you think needs improving?

Tasks for Intern Selection:

Task 1, 2 and 3 are completed in this issue Open-Science-Community-Saudi-Arabia/OSCSA_Website#12

Task 4

The task is described in issue Open-Science-Community-Saudi-Arabia/MOOCs#1

Task 5

Our OSCSA blog is built using Quarto. We would like ti to improve the continues integration and deployment (CI/CD) for the blog in GitHub using GitHub action. At the moment, we have a file called .github/workflows/workflows.yml but the preview for the deployment isn't working well as you can see in PR #5.

In this task, open an issue to address this problem and then a PR to fix it.

Task 6

Our OSCSA blog is NOT bilingual yet. Your task is to make it bilingual by allowing the user to switch between English and Arabic.

Screenshot 2022-10-11 at 16 03 48

Arabic content is available at this repository, please note that we don't want to have two repositories for each language.

You can find tips in this discussion and here is an example of repo that successfully run bilingual content in Quarto

This task is allowed by more than one individual!

Meetings

We will lead an online video call (on Zoom) to answer any questions you have. This will be on Tuesday, the 18th of October, at 12:10 pm UTC!

The link for Zoom Meeting
https://liverpool-ac-uk.zoom.us/j/93627968243?pwd=OVh5d1IreFRnOVRpNDVXMWRwMmlmZz09

Assessing Candidates

  • Candidate should be comfortable collaborating through GitHub
  • Your UI/UX design
  • Candidates should also be comfortable using HTML/CSS/JS and R.
  • Their insights about how they think the website can be improved!
  • Candidate should be comfortable opening issues and PR with elaborate descriptions.

Communication

Maintainers will answer your questions under the issue or Github Discussion from 10:00am - 4:00pm UTC. Please avoid communicating through emails unless it is necessary.

Add Pull request template

A Pull Request template is needed to guide contributors in making a descriptive pull request on the OSCSA blog repository.
The PR template would be added to the GitHub workflow folder

Missing image on about page

In the about section of the blog page, there is supposed to be an image, but it doesn't load unfortunately. I don't see the profile.jpg the site is supposed to load.

Screenshot from 2022-10-12 16-28-36

[8/12/2022]Fixs: Update Pull Request Template.

Description
The PR template is an excellent tool for assisting contributors in making descriptive Pull Requests.

  • A checklist should be added to ensure that necessary parameters are completed in making a Blog post Pull Request

Add .gitpod.yml

In order to make contribution easier add .gitpod.yml with VS code extension, including Quarto

Extensions to be added:

  • codezombiech.gitignore # Language support for .gitignore files
  • cssho.vscode-svgviewer # SVG viewer
  • esbenp.prettier-vscode # Markdown/CommonMark linting and style checking for Visual Studio Code
  • eamodio.gitlens # Quickly glimpse into whom, why, and when a line or code block was changed
  • EditorConfig.EditorConfig # override user/workspace settings with settings found in .editorconfig files
  • Gruntfuggly.todo-tree # Display TODO and FIXME in a tree view in the activity bar
  • mechatroner.rainbow-csv # Highlight columns in csv files in different colors
  • oderwat.indent-rainbow # Highlight indentation level
  • streetsidesoftware.code-spell-checker # Spelling checker for source code
  • quarto.quarto

[17/10/2022]: TASK 5 - Deploy Preview ( CI /CD ) Discussion Thread

Previous issue opened for TASK 5 is at #8
Previous PR opened for TASK 5 is at #11

I made the above issue and corresponding PR some days ago to fix the Netlify deploy preview. Unfortunately the changes I made there did not fix the issue. However , I have made a stunning discovery

After days of careful research I discovered that the PR deploy-preview is not working simply because the Quarto Publish does not yet support PR deploy-previews . The deploy-preview will not work with Quarto as the feature is still in development and has not yet been integrated into Quarto Publish. Here is a link to an OPEN issue on Quarto's Repo to support my claims. Support netlify PR previews in publish action

The above issue was opened by Quarto to create a feature that would address the exact problem we are trying to fix (Netlify Deploy Preview)

In conclusion , this issue cannot be fixed at the moment until Quarto adds support for it as stated here

@alswajiab @BatoolMM

[20/10/2022]: TASK 5 - Combine Quarto Render Action with an existing Netlify Deploy Action.

Similar issues opened to solve this at #8 and #28
PRs that fixed this issue available at #11 #30 and #31

Description

❔ Improve the continuous integration and deployment (CI/CD) of OSCSA Blog by fixing the deploy preview fail.

Expected behavior

✅ When a PR is made , quarto render/publish action and an existing [https://github.com/marketplace/actions/netlify-deploy](Netlify Deploy Action) should build the site and make deploy preview possible
✅ The new changes should be seen in the deploy-preview link from Netlify

Actual behavior

❌ There is no Netlify Deploy Action
❌ Netlify serves the deploy-preview with old data from the last merged PR to main.

What needs to be done

  • Netlify Deploy Action needs to be added to publish.yml

Who want to work on this issue?

@okerekechinweotito

Accessibility issues on blog site

I did a little accessibility test on the blog site and noticed some issues. A few images don't have ALT texts, and one skipped heading level. I know this issue is not among the ones you are tracking, but can I go ahead and fix it still?

Screenshot from 2022-10-12 15-10-39

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.