Skip to content

akib-h/butex-notes

BranchesTags
 
 

Repository files navigation

📚 BUTEX University Notes

Last Commit Repo Size License Markdown Changelog

Personal study notes for B.Sc. in Textile Engineering (Fabric Engineering Department)
Maintained by itachi_re | Bangladesh University of Textiles (BUTEX)

📖 About This Repository

This repository contains comprehensive course notes from my journey through the Fabric Engineering Department at BUTEX. The notes are written in Markdown with LaTeX support for mathematical expressions, making them easy to version control, share, and export to various formats.

🎯 Key Features

  • 📝 Structured Markdown Notes - Clean, readable format with proper hierarchy
  • 🧮 LaTeX Math Support - Full equation and formula rendering
  • 📊 Version Controlled - Track changes and improvements over time
  • 📄 PDF Export Ready - Automated scripts to convert notes to PDF
  • 🏷️ Tagged & Organized - Easy navigation with course codes and topics
  • 🔍 Searchable - Quick find using Git search or GitHub search features
  • 📋 Changelog Tracked - Every notable update logged in CHANGELOG.md

🗂️ Course Index

🔬 Core Sciences & Mathematics

Course Code Course Title Status Topics Covered Quick Links
CHEM-101 Chemistry - I 🟢 Active Periodicity, Bonding, Acids/Bases, Equilibrium, Kinetics, Colloids, Photochemistry 📑 Topics
PHY-101 Physics - I 🟢 Active Elasticity, Fluid Mechanics, Interference of Light, Optics 📑 Topics
MATH-101 Mathematics - I 🟢 Active Differential Calculus, Integral Calculus, Linear Algebra 📑 Topics
HSS-101 Humanities & Social Science 🟢 Active Communication, Letters, Presentations, Meetings, Group Project 📑 Topics

🧵 Yarn Engineering (Fabric Department Focus)

Course Code Course Title Status Topics Covered Quick Links
YE-101 Natural Textile Fibres 🟢 Active Flax, Jute, Cotton, Silk, Wool — Full Modules 📑 Topics
YE-201 Fibre & Yarn Testing 🟡 In Progress Moisture Regain, Sampling Methods, Quality Control -

🔩 Practical & Lab Work

Course Code Course Title Status Topics Covered Quick Links
lab_reports Lab Reports (CHEM-102 / PHY-102) 🟢 Active Chemistry & Physics Lab Reports, Mechanical Labs 📑 Topics
ME-102 Practical Mechanical Engineering Practical 🟡 In Progress Boilers, Pumps, Engines, Refrigeration, Turbines 📑 Topics

Status Legend:
🟢 Active - Regularly updated | 🟡 In Progress - Being developed | ⚪ Pending - Not started

📚 Detailed Course Contents

Chemistry 101 Topics

🔗 View All Chemistry Notes

📂 01 - Periodicity
📂 02 - Chemical Bonding
📂 03-10 - Additional Chemistry Topics
📂 Q&A / Class Tests

Physics 101 Topics

🔗 View All Physics Notes

📂 01 - Elasticity
📂 02 - Fluid Mechanics
📂 03 - Interference of Light
📂 Q&A / Class Tests

MATH-101 Topics

🔗 View All Mathematics Notes

📂 Differential Calculus
📂 Integral Calculus
📂 Linear Algebra
📂 Q&A / Class Tests

YE-101 Topics

🔗 View All Natural Textile Fibres Notes

YE-101 has been reorganised into three fibre families: Bast, Cellulosic, and Protein.

📂 Introduction
📂 Bast Fibres — Jute (Full Module)
📂 Bast Fibres — Flax (Full Module) ✨ New
📂 Cellulosic Fibres — Cotton
📂 Protein Fibres — Silk (Full Module) ✨ New
📂 Protein Fibres — Wool (Full Module)
📂 Q&A / Class Tests

HSS-101 Topics

🔗 View All HSS Notes

Business Communication Module:

📂 Extras — Group Project (x86 AI Presentation) ✨ New

Research Notes:

Presentation Scripts:

References & Guides:

📂 Q&A / Class Tests

Lab Reports

🔗 View All Lab Reports

📂 Chemistry Lab (CHEM-102) ✨ New
📂 Physics Lab (PHY-102) ✨ New
📂 Mechanical Lab ✨ New

ME-102 Practical

🔗 View ME-102 Practical Notes

📂 Mechanical Engineering Practical Topics ✨ New

🛠️ Workflow & Usage

📝 Creating a New Note

Use the automated script to create properly formatted notes:

# Syntax: ./scripts/new_note.sh [COURSE_CODE] [FILE_NAME]
./scripts/new_note.sh YE-201 02_fiber_length_testing

# This creates: YE-201/02_fiber_length_testing.md
# With pre-filled template including date, course info, and structure

Manual Method:

cp _templates/note_template.md COURSE-CODE/topic_name.md
# Edit the frontmatter and add your content

📤 Exporting to PDF

Convert all notes to PDF format with proper formatting:

# Export all markdown notes to PDF
./scripts/build_all.sh

# Output will be in: exported_pdfs/
# Maintains directory structure: exported_pdfs/YE-101/01_natural_fibres.pdf

🖥️ System Requirements

🐧 Linux (Recommended)

  • Any modern Linux distribution (Ubuntu / Debian, Arch / Manjaro, Fedora, openSUSE)
  • Core tools: git, bash or zsh, python
  • Optional: docker, make

🪟 Windows

  • Windows 10 / 11 (64-bit)
  • Required: Git for Windows, PowerShell or Windows Terminal
  • Recommended: WSL2 (Ubuntu or openSUSE), Python 3.x
  • Optional: Docker Desktop (WSL2 backend)

🍎 macOS

  • macOS 12+ (Monterey or newer)
  • Required: Xcode Command Line Tools (xcode-select --install)
  • Recommended: Homebrew, Git, Python 3.x
  • Optional: Docker Desktop

🌐 Platform-Independent

  • A modern web browser (Chrome / Firefox / Brave)
  • Markdown viewer: VS Code, Obsidian, or Typora
  • PDF reader (for exported notes)

📦 Recommended Editors

  • VS Code (Markdown + Git extensions)
  • Neovim (for terminal users)
  • Obsidian (knowledge base style)

📂 Repository Structure

butex-notes/
├── CHEM-101/                    # Chemistry notes
│   ├── 01_periodicity/
│   ├── 02_chemical_bonding/
│   ├── 06_physical_chemistry/
│   ├── 10_photochemistry/
│   ├── qna/
│   └── README.md
├── PHY-101/                     # Physics notes
│   ├── 01_elasticity/
│   ├── 02_fluid_mechanics/
│   ├── 03_interference_of_light/
│   ├── qna/
│   └── README.md
├── MATH-101/                    # Mathematics notes
│   ├── differential_calculus/
│   ├── integral_calculus/
│   ├── linear_algebra/
│   └── qna/
├── HSS-101/                     # Humanities & Social Science
│   ├── 01_intro.md … 04_meetings.md
│   ├── extras/                  # Group project materials
│   │   ├── 01_Research/         # Member research notes
│   │   ├── 03_Script/           # Presentation scripts
│   │   └── 05_References/       # Reference masterlist
│   └── qna/
├── YE-101/                      # Natural Textile Fibres
│   ├── bast/
│   │   ├── flax/                # Flax module (11 files)
│   │   ├── jute/                # Jute module (8 files)
│   │   └── jute_notes.md
│   ├── cellulosic/
│   │   └── cotton/Cotton.md
│   ├── protein/
│   │   ├── silk/                # Silk module (8 files)
│   │   └── wool/                # Wool module (7 files)
│   ├── introduction.md
│   └── qna/
├── YE-201/                      # Fibre & Yarn Testing
│   └── 01_testing_and_moisture.md
├── lab_reports/                 # Lab reports (CHEM-102, PHY-102, Mechanical)
├── tmp/
│   └── ME-102-Practical/        # ME practical notes (5 topics)
├── pdfs/                        # PDF resources
├── scripts/                     # Automation scripts
│   ├── new_note.sh
│   └── build_all.sh
├── _templates/                  # Note templates
├── CHANGELOG.md
├── CONTRIBUTING.md
└── README.md

📋 Note Template Structure

Each note follows a consistent structure for better organization:

---
subject: YE-101
topic: Natural Fibres
date: 2025-12-10
tags: [notes, YE-101, fabric-engineering]
---

# Topic Title

## 1. Key Concepts
- Main ideas and definitions

## 2. Formulas / Equations
$$
E = mc^2
$$

## 3. Important Notes
> Critical information and exam tips

🎓 Department Focus: Fabric Engineering

As a Fabric Engineering student, this repository emphasizes:

  • 🧵 Yarn Engineering - Fiber properties, yarn structure, testing methods
  • 🧪 Textile Testing - Quality control, standard testing procedures
  • 📊 Technical Analysis - Data interpretation, statistical methods
  • 🏭 Manufacturing Processes - Spinning, weaving, finishing

While foundation courses (Math, Physics, Chemistry) are included, the primary focus is on textile-specific subjects relevant to fabric manufacturing and quality assurance.

🚀 Getting Started

Clone the Repository

git clone https://github.com/itachi-re/butex-notes.git
cd butex-notes

Make Scripts Executable

chmod +x scripts/new_note.sh
chmod +x scripts/build_all.sh

Start Taking Notes

# Create a new note
./scripts/new_note.sh YE-101 03_fiber_identification

# Edit with your preferred editor
nano YE-101/03_fiber_identification.md
# or
nvim YE-101/03_fiber_identification.md

🔧 Tools & Technologies

  • Markdown - Note formatting
  • LaTeX - Mathematical equations
  • Pandoc - Document conversion
  • Git - Version control
  • Bash - Automation scripts
  • GitHub - Hosting & collaboration

📚 Study Tips

  1. Regular Updates - Commit notes after each lecture
  2. Clear Formatting - Use headings, lists, and emphasis consistently
  3. Include Examples - Add solved problems and diagrams
  4. Tag Properly - Use relevant tags for easy searching
  5. Review & Refine - Update notes during exam preparation
  6. Cross-Reference - Link related topics across courses

🤝 Contributing

While this is a personal note repository, suggestions and corrections are welcome!

  • 🐛 Found an error? Open an issue.
  • 💡 Have a suggestion? Create a pull request.
  • 📖 Want to share resources? Add them to discussions.

For detailed guidelines, please refer to the Contributing Guide.

📄 License

This project is licensed under the terms specified in the LICENSE file.

Note: These are personal study notes. While effort is made to ensure accuracy, they should be used as supplementary material alongside official course resources.

🔗 Connect

GitHub Repo Telegram Study Telegram Contact

📊 Repository Stats

Total Notes: 41 directories, 216 files
Last Updated: Saturday, April 04, 2026
Export Format: Markdown → PDF
Department: Fabric Engineering
University: BUTEX

⭐ Star this repo if you find it helpful!

Made with 📝 and ☕ by a Fabric Engineering student

MoeCounter

About

My notes to complete a B.Sc. in Textile Engineering at the University of Bangladesh.

Resources

Readme

License

MIT license

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 89.5%
  • Shell 10.5%