Skip to content
Khaled Hikmat edited this page Jun 9, 2021 · 17 revisions

goqur, pronounced go cure, is a platform to provide a set of API Endpoints to explore the different nouns and concepts in ayahs of the Quran.

There are other available Quran APIs in different phases of development and maturity. The following can be investigated for possible integration:

This Wiki acts as a technical documentation for goqur. Please note the following housekeeping notes about this Wiki:

  • The Wiki repository is cloned and edited locally before it is pushed to the actual Wiki. Hence please do not attempt to modify the Wiki directly from the Github site
  • Relative paths in Github wikis are a little strange. Provided that there is a media folder with images, the Home page only uses the following format to link an image:
![Cake](wiki/media/cake.JPG)

All other pages use a link image format that does not require the extra wiki in the path. Example:

![Cake](media/cake.JPG)

Another way to handle images is to dedicate a Github issue for images. Create an issue comment and drag & drop an image to it. Then copy and paste the full image path to the Wiki. While clever, I don't like it because I want the Wiki to be self-contained and source controlled.

  • The _Sidebar.md contains a list of all sections, sub-sections and pages that the Wiki is composed of. It is like a launch pad for Wiki.
  • The _Footer contains the footer message for every page.
  • The Wiki file structure is flat! There are no nested pages. But sections and sub-sections can be accomplished using the _Sidebar.
  • I could not find a way to override the Wiki page title. Unfortunately it shows the file name i.e. VSCode where I want it to show as VS Code for example. It seems to be an expected behavior as the page name becomes the the slug in the URL. In any case, I renamed the files with spaces to display properly as titles i.e. VS Code.md as opposed to VSCode.md.
  • Mermaid is unfortunately not natively supported in Github markdown. But if you add this browser extension, it displays Mermaid diagrams in .md files. Use Mermaid live editor to try things out. If you have the extension installed, you should see a diagram appears below:
graph TD
    A[Bonus] -->|Get money| B(Go shopping)
    B --> C{Let me think}
    C -->|One| D[Laptop]
    C -->|Two| E[iPhone]
    C -->|Three| F[fa:fa-car Car]
Loading
Clone this wiki locally