search

metafacture / metafacture.github.io

Sources for https://metafacture.org
0 stars 0 forks source link

Set up start website for metafacture.org #15

Closed TobiasNx closed 3 years ago

TobiasNx commented 3 years ago

At the moment www.metafacture.org refers straight the metafacture-documentation repo and it links to all of the scattered documentation. Since we already have a basic website for the ide-extension we also should also get a new start page that leads to the different parts of the documentation:

User groups should be:

katauber commented 3 years ago

We should begin with the start page (published to github pages) and add a link to the ide-extensions subpage and to the metafacture blog in this ticket. The documentation for the different user groups can be added later. And the url metafacture.org should not redirect to https://github.com/metafacture/metafacture-documentation anymore but there should be a reverse proxy.

Functional review: @TobiasNx Code review: @fsteeg

katauber commented 3 years ago

The Github Pages site is currently being built from the 15-addStartPage branch, so this ticket can be reviewed on metafacture.org. Should we already add some more content? If yes, which?

TobiasNx commented 3 years ago

Looks good for a first draft. One thing that needs to be changed: Consistency concerning the word metadata. At the end it is written "meta data".

Some things that could be nice:

Metafacture is a toolkit for processing semi-structured data with a focus on library metadata. It provides a versatile set of tools for reading, writing and transforming data. Metafacture can be used as a stand-alone application or as a Java library in other applications. The name Metafacture is a portmanteau of the words metadata and manufacture.

Metafacture includes a large number of modules for operating on semi-structured data. These modules can be combined to build pipelines to perform complex metadata processing tasks. The pipelines can be constructed either in Java code or with the domain-specific language Flux. One of the core features of Metafacture is the Metamorph module. Metamorph is an xml-based language for specifying transformations of semi-structured data. It can be seamlessly integrated into Java code.

At its heart Metafacture is a framework for implementing modules for metadata processing. This makes Metafacture easily extendable with additional modules. The plugins and tools page on the wiki shows supplementary packages and projects which extend Metafacture.

Originally, Metafacture was developed as part of the Culturegraph platform but it is developed independently now and used by others, too: see who uses Metafacture.

Add a sentence like: "Also Metafacture Fix, a non-xml Catmandu inspired language for specifying transformations, is being developed that is not stream-based but operates at record level ."

End with something like: "Metafacture is maintained by the Team Offene Infrastruktur by hbz."

TobiasNx commented 3 years ago

Cool more content :)

Some more thing I saw: 1) The pipes in the navigation are not consistent, there are different pipes used blue and black. 2) I still think that the navigation would look better if centered and the links to the different contents would not be as narrow as they are now. 3) The metafacture title and the header are redundant, I would prefer to delet the metafacture title and straight start with "Welcome". 4) Anyway to integrate the blog straigt in the website? 5) I would not use Twitter in the navigation, but somewhere with an Icon. Perhaps besides the github link with an icon. But idk.

katauber commented 3 years ago

Cool more content :)

Some more thing I saw:

  1. The pipes in the navigation are not consistent, there are different pipes used blue and black.

✔️

  1. I still think that the navigation would look better if centered and the links to the different contents would not be as narrow as they are now.

✔️

  1. The metafacture title and the header are redundant, I would prefer to delet the metafacture title and straight start with "Welcome".

✔️

  1. Anyway to integrate the blog straigt in the website?

I think in this simple implementation with pandoc that's not (that easy) possible

  1. I would not use Twitter in the navigation, but somewhere with an Icon. Perhaps besides the github link with an icon. But idk.

I removed the Twitter link now. Should I add the github and twitter link on a new page?

TobiasNx commented 3 years ago

I like how it looks now! :)

  1. Anyway to integrate the blog straigt in the website?

I think in this simple implementation with pandoc that's not (that easy) possible

Okay, fair enough!

  1. I would not use Twitter in the navigation, but somewhere with an Icon. Perhaps besides the github link with an icon. But idk.

I removed the Twitter link now. Should I add the github and twitter link on a new page?

Wouldn't just adding a Twitter and a Github Icon in the upper right corner. Or perhaps at the end of the navigation bar? But I do not know a perfect solution :)

Additional point: I also saw that the tab of the site jusst shows "Welcome" with no icon and no refrence to Metafacture: grafik

katauber commented 3 years ago

Wouldn't just adding a Twitter and a Github Icon in the upper right corner. Or perhaps at the end of the navigation bar? But I do not know a perfect solution :)

Please check if you like it now :)

Additional point: I also saw that the tab of the site jusst shows "Welcome" with no icon and no refrence to Metafacture

✔️

TobiasNx commented 3 years ago